Open the Portico Developer Guide site
PosGateway Schema
Header Element
PosGateway Schema > PosResponse Element > Ver1.0 Element : Header Element
Description

Contains tracking information, echoed fields, and gateway response indicators.

The specific fields returned can vary. Clients should code to be able to potentially receive any optional elements at any time. New elements being added should not break client code.

Note: This should be inspected by the client to determine if the gateway was able to complete the processing of the associated request.

Note: If gateway successfully processed the request, the client will still need to check the transaction response details, if any, to determine the final result based on any issuer decisions.

Namespace http://Hps.Exchange.PosGateway
Diagram
RetryInd Element MerchCurrencyText Element MerchCurrencyCode Element BatchItemNbr Element CustomHash Element x_global_transaction_source Element x_global_transaction_id Element PDLNotification Element BatchSeqNbr Element BatchId Element UniqueDeviceId Element ClientTxnId Element AdditionalDuplicateData Element TokenData Element RspDT Element GatewayRspMsg Element GatewayRspCode Element GatewayTxnId Element SiteTrace Element DeviceId Element SiteId Element LicenseId Element All Header Element
Overview
Header

Contains tracking information, echoed fields, and gateway response indicators.

The specific fields returned can vary. Clients should code to be able to potentially receive any optional elements at any time. New elements being added should not break client code.

Note: This should be inspected by the client to determine if the gateway was able to complete the processing of the associated request.

Note: If gateway successfully processed the request, the client will still need to check the transaction response details, if any, to determine the final result based on any issuer decisions.

All
LicenseId optional licenseIdType Simple Type

Echoed from request

SiteId optional siteIdType Simple Type

Echoed from request

DeviceId optional deviceIdType Simple Type

Echoed from request

SiteTrace optional siteTraceType Simple Type

Echoed from request

GatewayTxnId txnIdType Simple Type

Gateway-generated transaction identifier; can be used in future client requests to uniquely identify this transaction.

GatewayRspCode gatewayRspCodeType Simple Type

Gateway response code that indicates what occurred on the gateway while processing the request.

Note: This does not indicate approval or decline. Clients must see if additional information is provided in the transaction portion of the message from the issuer or other system.

GatewayRspMsg optional gatewayRspMsgType Simple Type

Gateway response message that may provide additional information to the client or user.

Note: In some cases the information may not assist the client or user directly, but it can be provided to a support representative to assist in problem resolution.

RspDT optional xs:dateTime

Transaction response date and time in the time zone stored for the associated site.

TokenData optional TokenDataRspType Complex Type

If requested, the multi-use token data generated (or echoed) from the supplied card data.

All
TokenRspCode optional xs:int

Response code specific to the tokenization process; the processing of the request will not be impacted by tokenization failures in most cases.

TokenRspMsg optional xs:string

Response message specific to the tokenization process that may provide additional information to the client or user

Note: In some cases the information may not assist the client or user directly, but it can be provided to a support representative to assist in problem resolution.

TokenValue optional xs:string

The generated (or echoed) multi-use token; this can be used by the client on subsequent calls in the card data element.

AdditionalDuplicateData optional AdditionalDuplicateDataType Complex Type

Contains the original transaction data from the first request which triggered the duplicate transaction.

All
OriginalGatewayTxnId txnIdType Simple Type

Contains the original Gateway Transaction ID.

OriginalRspDT xs:dateTime

Contains the original transaction response date and time in the time zone stored for the associated site.

OriginalClientTxnId clientIdType Simple Type

Contains the original client transaction ID.

OriginalUniqueDeviceId uniqueDeviceIdType Simple Type

Contains the original unique device ID.

OriginalAuthCode xs:string

Contains the original authorization code.

OriginalRefNbr xs:string

Contains the original reference number.

OriginalAuthAmt xs:decimal

Contains the original authorized amount.

OriginalCardType xs:string

Contains the original card type.

OriginalCardNbrLast4 xs:string

Contains the original last four digits of the account number used on the original transaction.

ClientTxnId optional clientIdType Simple Type

Echoed from request

UniqueDeviceId optional xs:string

Echoed from request

BatchId optional batchIdType Simple Type

If the transaction was added to a batch, this is the associated batch id.

Note: This field is only returned if the device is configured for this option during the boarding process.

BatchSeqNbr optional xs:int

If the transaction was added to a batch, this is the batch's sequence number.

Note: This field is only returned if the device is configured for this option during the boarding process.

PDLNotification optional booleanType Simple Type

Indicates a parameter download is available

CustomHash optional xs:string

Fingerprint value for customer-specific usage.

BatchItemNbr optional xs:int

FOR INTERNAL USE ONLY

MerchCurrencyCode optional xs:string

Indicates the 3-digit currency code of the merchant.

MerchCurrencyText optional xs:string

Indicates the 3-digit currency acronym of the merchant

RetryInd optional booleanType Simple Type

Indicates that this transaction is a retry of the previous, in case if a timeout error occurred. GTID and Source fields are required for RetryInd.

The time alloted for retries is 90 minutes.

Note: It is internal only

Source
<xs:element name="Header" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:annotation>
    <xs:documentation>
      <p xmlns="http://Hps.Exchange.PosGateway">Contains tracking information, echoed fields, and gateway response indicators.</p>
      <p xmlns="http://Hps.Exchange.PosGateway">The specific fields returned can vary. Clients should code to be able to potentially receive any optional elements at any time. New elements being added should not break client code.</p>
      <p xmlns="http://Hps.Exchange.PosGateway" />
      <p xmlns="http://Hps.Exchange.PosGateway">
        <strong>Note:</strong> This should be inspected by the client to determine if the gateway was able to complete the processing of the associated request.
                    </p>
      <p xmlns="http://Hps.Exchange.PosGateway" />
      <p xmlns="http://Hps.Exchange.PosGateway">
        <strong>Note:</strong> If gateway successfully processed the request, the client will still need to check the transaction response details, if any, to determine the final result based on any issuer decisions.
                    </p>
    </xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:all>
      <xs:element name="LicenseId" type="licenseIdType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Echoed from request</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="SiteId" type="siteIdType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Echoed from request</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="DeviceId" type="deviceIdType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Echoed from request</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="SiteTrace" type="siteTraceType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Echoed from request</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="GatewayTxnId" type="txnIdType">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Gateway-generated transaction identifier; can be used in future client requests to uniquely identify this transaction.</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="GatewayRspCode" type="gatewayRspCodeType">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Gateway response code that indicates what occurred on the gateway while processing the request.</p>
            <p xmlns="http://Hps.Exchange.PosGateway" />
            <p xmlns="http://Hps.Exchange.PosGateway">
              <strong>Note:</strong> This does not indicate approval or decline. Clients must see if additional information is provided in the transaction portion of the message from the issuer or other system.
                          </p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="GatewayRspMsg" type="gatewayRspMsgType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Gateway response message that may provide additional information to the client or user.</p>
            <p xmlns="http://Hps.Exchange.PosGateway" />
            <p xmlns="http://Hps.Exchange.PosGateway">
              <strong>Note:</strong> In some cases the information may not assist the client or user directly, but it can be provided to a support representative to assist in problem resolution.
                          </p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="RspDT" type="xs:dateTime" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Transaction response date and time in the time zone stored for the associated site.</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="TokenData" type="TokenDataRspType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">If requested, the multi-use token data generated (or echoed) from the supplied card data.</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="AdditionalDuplicateData" type="AdditionalDuplicateDataType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Contains the original transaction data from the first request which triggered the duplicate transaction.</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="ClientTxnId" type="clientIdType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Echoed from request</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="UniqueDeviceId" type="xs:string" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Echoed from request</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="BatchId" type="batchIdType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">If the transaction was added to a batch, this is the associated batch id.</p>
            <p xmlns="http://Hps.Exchange.PosGateway" />
            <p xmlns="http://Hps.Exchange.PosGateway">
              <strong>Note:</strong> This field is only returned if the device is configured for this option during the boarding process.
                          </p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="BatchSeqNbr" type="xs:int" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">If the transaction was added to a batch, this is the batch's sequence number.</p>
            <p xmlns="http://Hps.Exchange.PosGateway" />
            <p xmlns="http://Hps.Exchange.PosGateway">
              <strong>Note:</strong> This field is only returned if the device is configured for this option during the boarding process.
                          </p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="PDLNotification" type="booleanType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Indicates a parameter download is available</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="x_global_transaction_id" type="x_global_transaction_idType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Echoed from request</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="x_global_transaction_source" type="x_global_transaction_sourceType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Echoed from request</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="CustomHash" type="xs:string" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Fingerprint value for customer-specific usage.</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="BatchItemNbr" type="xs:int" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">FOR INTERNAL USE ONLY</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="MerchCurrencyCode" type="xs:string" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Indicates the 3-digit currency code of the merchant.</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="MerchCurrencyText" type="xs:string" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Indicates the 3-digit currency acronym of the merchant</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="RetryInd" type="booleanType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Indicates that this transaction is a retry of the previous, in case if a timeout error occurred. GTID and Source fields are required for RetryInd.</p>
            <p xmlns="http://Hps.Exchange.PosGateway">The time alloted for retries is 90 minutes.</p>
            <p xmlns="http://Hps.Exchange.PosGateway">
              <strong>Note:</strong> It is internal only
                          </p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
    </xs:all>
  </xs:complexType>
</xs:element>
See Also
Ver1.0 ElementPosResponse ElementPosGateway Schema