General Message Layout

This section provides the list of elements supported in each message type. All of these XML tags are defined in nexo Acquirer v6 protocol (CAPE ACQ MDR and CAPE ACQ MUG). The description provided below should be used in conjunction with the nexo description of each tag.
The column 'Presence' shows 'm' for mandatory fields or 'o' for optional fields indicating if this tag is relevant for the business. This is limited to the relevant tags only. For more details consult NEXO XSD and NEXO Message Definition Report. In some rare cases you may find discrepancies about the presence of some fields.

Common elements
TagDescriptionPresence
Hdr/PrtcolVrsnUse '6.0'. Will be copied into responsem
Hdr/XchgIdId for this message defined by terminal vendor. Will be copied into response.m
Hdr/CreDtTmWhen message was sent (in ISODateTime). Will be copied into response.m
Hdr/InitgPty/IdIdentifies sender (name of host or application). Will be copied into response.m
Hdr/RcptPty/IdIdentifies recipient. Use 'IPG'o
Envt/Acqrr/Id/IdId of the acquirer. Will be copied into response. For testing use '00001'.o
Envt/Acqrr/ParamsVrsnWill be copied into response.m
Envt/Mrchnt/Id/IdCard-brand specific Merchant ID. Needs to be populated by terminal with the same information as in EMV tag 9F16. m
Envt/Mrchnt/CmonNmIf sent, then the given merchant name and location that will be included in authorization message. Otherwise, our gateway will use the data from store configuration.
Not applicable for AcceptorReconciliationRequest/Response
o
Envt/POI/Cmpnt/Id/IdIn case of Envt/POI/Cmpnt/Tp=DVCE you have two options:

one of:
'MPOS_SOFTWARE_PIN_PCI_READER'
'MPOS_SOFTWARE_PIN_NFC_READER'
'MPOS_HARDWARE_PIN_NFC_READER'
'MPOS_HARDWARE_PIN_PCI_READER'

OR

One of:
'POS'
'MPOS'
'SOFTPOS'

combined with one of:
'SOFTWARE_PIN'
'HARDWARE_PIN'
o
Envt/POI/Id/Idin standard case: Fiserv Terminal ID
In Girocard case: Acquirer Terminal ID
Will be shared by support team
m
Envt/POI/Id/ShrtNmOnly present in case of Girocard case: Fiserv Terminal ID. Will be shared by support team. If it gets send for other brands than Girocard, then it must contain the same value as Envt/POI/Id/Idc
Envt/POI/GrpIdTo be populated with the Gateway store ID. Will be shared by support teamm
SctyTrlr/AuthntcdDataMessage Authentication Value - May be disabled or set to optional in our gateway. If set to optional, then a message without MAC is accepted and the response doesn't contain a MAC either.o
AcceptorAuthorisationRequestV06 - caaa.001.001.06
TagDescriptionPresence
Hdr/MsgFctnIdentifies the type of transaction.
AUTQ for Pre-authorization, Card validity check, Balance Enquiry
FAUQ for Payments
m
Hdr/RcptPty/RmotAccs/AccsCdOne-time code. Currently only used for BLIK paymentso
Envt/Mrchnt/LctnCtgyUse value 'NMDC' in case the address is a service location (as needed due to Mastercard mandate AN6022). Otherwise, use value 'FIXD' or don't send this element at allo
Envt/Mrchnt/LctnAndCtct/PstlAdr/....../AdrLine
street house-number,city,zip-code or
house-number,street,city,zip-code
Mapped to below values, if //AdrLine are not given.

or

.../StrtNm
.../BldgNb
.../TwnNm
.../PstCd
.../Ctry (mandatory if 'PstlAdr' element is present)
.../AddtlCtctInf
o
Envt/POI/Cpblties/CardRdngCpbltiesFor terminals supporting contactless single-tap PIN requests, include one additional occurrence with value "OTHR". nexo does not support a dedicated value for this capability yet, but it is expected to be added to future releases.o
Envt/POI/Cpblties/CrdhldrVrfctnCpbltiesSee NEXO MDR
Envt/POI/Cpblties/OnLineCpbltiesSee NEXO MDRo
Envt/POI/Cmpnt/TpOnly components with type "TERM" and "DVCE" are evaluated.o
Envt/POI/Cmpnt/Id/SrlNbTerminal serial numbero
Envt/POI/Cmpnt/StdCmplc/IssrOnly standard compliance entries with Issr=GBIC are evaluated.o
Envt/POI/Cmpnt/StdCmplc/IdTerminal approval number
Used for GIRO-Card transactions.
o
Envt/Card/PrtctdCardData/CnttTpEVLPo
Envt/Card/PrtctdCardData/... EnvlpdData/Rcpt/KEKSee Protected card datao
Envt/Card/PrtctdCardData/... EnvlpdData/NcrptdCnttSee Protected card datao
Envt/Card/IssrBINOnly needed for AccptrCcyConvsReqo
Envt/Card/CardCtryCdISO 3166 – 1, alphanumeric or numerico
Envt/Card/CardCcyCdISO 3166 – 1, alphanumeric or numerico
Envt/Card/CardPdctPrflDefines a category of cards grouped together for reconciliation.
Mandatory in transactions that are relevant for reconciliation.
Filled with "Card Brand" and not with the actual card product profile as defined in nexo IS in order to allow grouping by brand.
o
Envt/Card/CardBrndContains brand of the card with one of:
A-Amex
B-BCMC
C-Carte Bancaire (France)
CONECS - Conecs lunch card (France)
D-Diners
E-Maestro
F-EFTPOS (Australia)
G-Giro
J-JCB
K – BLIK (Poland)
L-ELV (Germany)
M-Mastercard
MOBILEPAY - MobilePay
N-VISA Electron
P-VPAY
SWISH - Swish
U-UPI
V-Visa
VIPPS - Vipps
X-Flexecash
m
Envt/Card/PmtAcctRefToken value. Only used when payment is initiated with Token number (manually read or received from ECR) instead of card data. Other Card subfields must not be present in this case.o
Envt/PmtTkn/TknRqstr/PrvdrIdIdentifies the provider of the token: IPG, IPGTA. Not required in request message.o
Envt/Crdhldr/Authntcn/AuthntcnMtdOnly the following values will be considered by our gateway:
NPIN (Online PIN)
CSCV , Verification of Card Security Code (represents CVD used in MOTO (applicable for Telephone Order) transaction).

For more details about MOTO please refer to Mobile orders and telephones orders (MOTO)
o
Envt/Crdhldr/Authntcn/... CrdhldrOnLinePIN/NcrptdPINBlckSee chapter 'PIN block encryption'o
Envt/Crdhldr/Authntcn/... CrdhldrOnLinePIN/PINFrmtSee chapter 'PIN block encryption'o
Envt/Crdhldr/BllgAdr/AdrLineInformation that locates and identifies a specific address, as defined by postal services, presented in free format text.
This field and other elements under BllgAdr are required in case cardholder address shall be passed to issuer for validation.
o
Envt/Crdhldr/BllgAdr/PstCdIdentifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.o
Envt/Crdhldr/BllgAdr/TwnNmName of a built-up area, with defined boundaries, and a local government.o
Envt/Crdhldr/BllgAdr/CtryNation with its own government, occupying a particular territory.o
Envt/Crdhldr/TxVrfctnRslt/MtdPossible values that indicate the performed offline verification:
FPIN
PPSG
CPSG
o
Envt/Crdhldr/TxVrfctnRslt/RsltOnly value 'SUCC' is consideredo
Cntxt/PmtCntxt/CardPresCard was (not) presento
Cntxt/PmtCntxt/CrdhldrPresCardholder was (not) presento
Cntxt/PmtCntxt/AttndncCntxtMerchant was (not) present.o
Cntxt/PmtCntxt/CardDataNtryMdFor Payment with Token - CDFL.

For other payments, value indicates the entry mode of the card data (TAGC, PHYS, BRCD, MGST, CICC, DFLE, CTLS, ECTL)
m
Cntxt/PmtCntxt/FllbckIndIndicates a problem with the chip

FFLB - FallbackAfterFailure
SFLB - FallbackAfterSuccess
NFLB - NoFallback
o
Cntxt/PmtCntxt/TxChanlType of the communication channels used by the cardholder to the acceptor system. Only below values will be considered:

MAIL - Mail order
TLPH -Telephone order
o
Cntxt/SaleCntxt/SaleIDIdentification of the sale system. Should not be populated on stand-alone terminals, only on terminals integrated with sale systems.o
Cntxt/SaleCntxt/SaleRefNbTransaction identifier assigned by the sale system. Referred to as Merchant Reference 1. Maximum size 15.o
Cntxt/SaleCntxt/CshrIdIdentification of the cashier who initiated the transaction on the sale system. Should not be populated on stand-alone terminals, only on terminals integrated with sale systems.o
Tx/TxCaptrTRUE, for 'SALE'
FALSE, for Reservations, Balance Enquiry, Card Validity Check
m
Tx/TxTpBALC - Balance Enquiry
CRDP - Card payment
DEFR - Deferred Payment
RESA - Reservation
RFND - Refund
VALC - Validity check
m
Tx/AddtlSvcGRTT - Gratuity
RECP - Recurring Payment
DCCV - DCC
CSHB - CashBack
NRES - No-show
o
Tx/SvcAttrFREC - First Recurring (Value required when Tx/AddtlSvc is RECP)
IRES - Initial reservateion (Value required when Tx/AddtlSvc is RESA )
URES - Update reservation (Value required when Tx/AddtlSvc is RESA )
o
Tx/MrchntCtgyCdMerchant category codem
Tx/SaleRefIdRequired in Pre-authorization messages (initial and update). IPG will ignore the value and generate its own pre-authorization ID which will be returned in the same tag and also in RcptTxId.o
Tx/TxId/TxRefReference-ID of transaction.
Used as trace-number, format 999999

Format: Max6Numeric

Other length:
e.g. for pre-authorizations done with an alternative payment method (APM): 35 digits
or 12 digits with leading zeroes
m
Tx/TxId/TxDtTmDate & time of transactionm
Tx/InitrTxIdMerchant Reference 1.o
Tx/RcncltnIdReconciliation ID, this transaction belongs to.m
Tx/AddtlTxDataPossible values (all transaction types):
/exceptioncode/Emergency1
/exceptioncode/Emergency2
/request/token
/request/ELVMerchantForced if Merchant forced ELV transaction (Limit Override)
For transaction type VALC - Validity check:
/request/token
/request/tokenOnly (no card validation is done)
For second submission of single-tap transaction with PIN data (PSD2 SCA requirements):
/request/ContactlessSingleTapPIN
For BLIK trx or any other trx that require the entry of a one time code (OTC):

/request/OTCEntryMode/01 - if code was manually entered by merchant on POS device
/request/OTCEntryMode/02 - if code was manually entered by cardholder on PED device
/request/OTCEntryMode/03 - if code was sent to terminal via NFC

For deferred authorization:
/DeferredAuth
o
Tx/TxDtls/TtlAmtTotal amount in merchant currency.
DCC: Total amount in target currency (copied from dcc_response.Tx/CcyConvsRslt/ConvsDtls/RsltgAmt)
m
Tx/TxDtls/AmtQlfrINCR - Incremental amount for reservation
DECR - Decremental amount for reservation
RESD - total reserved amount
o
Tx/TxDtls/DtldAmt/... AmtGoodsAndSvcsAmount of purchased goods or services. Should only be included when it is different than the total amount.

If Gratuity or Cashback is given, it must be present.

DCC: amount inmerchant (source/original) currency. If DCC was accepted this is not in the same currency as TtlAmt.
c
Tx/TxDtls/DtldAmt/GrttyGratuity amount. Should only be included when gratuity (tip) is included in total amount.

For DCC: amount in merchant (source/original) currency. If DCC was accepted this is not in the same currency as TtlAmt.
o
Tx/TxDtls/DtldAmt/CshBckCashback amount.

For DCC: amount in merchant (source/original) currency. If DCC was accepted this is not in the same currency as TtlAmt.
o
Tx/TxDtls/VldtyDtReservation validity date. Will be present in initial and update reservation.o
Tx/TxDtls/CcyCurrency
DCC: target currency
Copy of Tx/CcyConvsRslt/ConvsDtls/TrgtCcy/AlphaCd
from AcceptorCurrencyConversionResponse
m
Tx/TxDtls/CcyConvsRslt/... AccptdByCrdhldrDCC: If true, customer accepted and DCC should be applied.o
Tx/TxDtls/CcyConvsRslt/... Convs/CcyConvsIdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/CcyConvsId
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/TrgtCcy/AlphaCdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/TrgtCcy/AlphaCd
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/TrgtCcy/NmrcCdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/TrgtCcy/NmrcCd
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/TrgtCcy/DcmlDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/TrgtCcy/Dcml
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/RsltgAmtDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/RsltgAmt
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/XchgRateDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/XchgRate
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/QtnDtDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/QtnDt
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/VldUntilDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/VldUntil
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/SrcCcy/AlphaCdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/SrcCcy/AlphaCd
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/SrcCcy/NmrcCdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/SrcCcy/NmrcCd
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/SrcCcy/DcmlDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/SrcCcy/Dcml
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/OrgnlAmt/ActlAmtDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/OrgnlAmt/ActlAmt
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/UattnddLvlCtgySee https://docs.fiserv.dev/public/v3.0/docs/other-useful-information#unattended-terminalso
Tx/TxDtls/AcctTpType of cardholder account used for the transaction.

Values: CHCK, CRDT, CDBT, SVNG etc. (more possible values)

In case of Default value, this tags will not be present.
o
Tx/TxDtls/ICCRltdDataEMV-data according to EMVCo specificationo
Tx/TxDtls/SaleItm/ItmIdIdentification of the item inside the purchase transaction.o
Tx/TxDtls/SaleItm/PdctCdProduct code of the item.
Tx/TxDtls/SaleItm/AddtlPdctCdAdditional product code related to the producto
Tx/TxDtls/SaleItm/UnitOfMeasrUnit of measure of the item purchasedo
Tx/TxDtls/SaleItm/PdctQtyProduct quantityo
Tx/TxDtls/SaleItm/UnitPricPrice per unit of product.o
Tx/TxDtls/SaleItm/UnitPricSgnSign of the unit price.o
Tx/TxDtls/SaleItm/PdctAmtMonetary value of purchased product.o
Tx/TxDtls/SaleItm/PdctAmtSgnSign of the product amount.o
Tx/TxDtls/SaleItm/ValAddedTaxValue added tax amount of the item included in the product amount.o
Tx/TxDtls/SaleItm/TaxTpInformation on tax paid on the product.o
Tx/TxDtls/SaleItm/PdctDescDescription of the product or item.o
Tx/TxDtls/SaleItm/DlvryLctnLocation of the delivery of the item, for instance pump number or parking bay.o
Tx/TxDtls/SaleItm/DlvrySvcIdentify the method of delivery or distribution of the item.o
Tx/MrchntRefDataMerchant Reference 2o
AcceptorAuthorisationResponseV06 - caaa.002.001.06
TagDescriptionPresence
Hdr/MsgFctnIdentifies the type of transaction.
AUTQ for Pre-authorization, Card validity check, Balance Enquiry
FAUQ for Payments
m
Envt/Card/MskdPANWill only be present in balance enquiry response.o
Envt/Card/PmtAcctRefThis field will contain the generated token value corresponding to the card used in the request message. Field will be included in response when request message `Tx/AddtlTxData´ contains value 'request/token'.o
Envt/PmtTkn/TknChrtcIf the token provided in Envt/Card/PmtAcctRef has an associated expiration date, it will be included in this field as 'YYMM'o
Tx/TxId/TxRefCopied from requestm
Tx/TxId/TxDtTmCopied from requestm
Tx/SaleRefIdRequired in pre-authorization response messages.

ID for this transaction generated by IPG. Will be used in subsequent related pre-authorization management transactions. Same value as in Tx/RcptTxId
o
Tx/InitrTxIdCopied from requesto
Tx/RcncltnIdCopied from requestm
Tx/IntrchngDataWill contain a scheme assigned transaction ID (e.g. Banknet Reference Number or Visa TID) - not yet availableo
Tx/RcptTxIdID for this transaction generated by IPG. Will be used in subsequent related pre-authorization management transactions.

Format: Max35Text

For client (reseller) specific formatting: check with your client support contact
m
Tx/TxDtls/CcyCopied from requestm
Tx/TxDtls/TtlAmtCopied from requestm
Tx/TxDtls/VldtyDtReservation validity date. Will be present in initial reservation, update reservation and balance enquiryo
Tx/TxDtls/AcctTpType of cardholder account used for the transaction.
Values: CHCK, CRDT, CDBT, SVNG etc. (more possible values)
In case of Default value, this tags will not be present.
o
Tx/ICCRltdDataEMV data from issuer responseo
TxRspn/AuthstnRslt/... AuthstnNtty/TpPossible values: CISS or ITAGm
TxRspn/AuthstnRslt/... RspnToAuthstn/RspnAPPR - approved
DECL - declined
PART - partially approved
m
TxRspn/AuthstnRslt/... RspnToAuthstn/RspnRsnresult-code: Textm
TxRspn/AuthstnRslt/AuthstnCd6-digit authorization codem
TxRspn/AuthstnRslt/CmpltnReqrdIf true, a completion advice is required to complete the transaction.m
TrxRspn/AuthstnRslt/TMSTrggrIn case the terminal has to contact a Terminal Management System (TMS), this ID indicates which one.
Currently no external TMS is referenced by the Gateway but this value is used to directly send configuration values back to the terminal.
This is indicated by the special TMSId "DIRECT:key=value[;key=value]..."
Possible keys are:

STAN - Indicates the TxRef value which was used as trace-number (or System Trace Audit Number). This can occur if the trace number was too low and the Gateway replaced it (after requesting the expected value from the authorization system).
So, the terminal should take this value as the last used value for TxRef. The next transaction should come with value increased by 1 or higher as TxRef.
Important: To reference the current transaction, the terminal still has to send the TxRef used in the request. It must not used the changed value returned in 'STAN'.

keyValidity - Indicates that a key related to this transaction is expired (value 'E') or will expire soon (value 'R'). The terminal should do an remote key injection as soon as possible. In case of 'R', a date when the key will expire is also returned (as contact date).
o
TxRspn/TxVrfctnRslt/MtdADDB - Cardholder billing address verification
CSCV - Card Security Code (CVD) verification
o
TxRspn/TxVrfctnRslt/RsltFAIL - Verification failed.
MISS - Information required to perform the verification was missing.
NOVF - Verification has not been performed.
PART - Verification was partially successful.
SUCC - Verification was successful.
ERRR - Device or entity to perform the verification was unavailable
o
TxRspn/BalCurrent reserved amount. Will only be included in approved Balance Enquiry responses.o
TxRspn/Actn/ActnTpFLFW - Switch to Contact Chip
PINR - Enter PIN and re-send transaction with PIN Data
DISP - Message to display, print or log.
o
TxRspn/Actn/MsgToPres/MsgDstnDestination in case of ActnTp = DISPo
TxRspn/Actn/MsgToPres/MsgCnttMessage Content, which can be printed on receipt or displayed on terminal.
SctyTrlr/AuthntcdDataMAC . May be disabled or set to optional by a parameter. If set to optional, a message without MAC is accepted and the response will not contain a MAC.o
AcceptorCancellationAdviceV06 - caaa.007.001.06
TagDescriptionPresence
Hdr/MsgFctnIdentifies the type of transaction.
CCAQ
m
Envt/Mrchnt/LctnCtgyUse value 'NMDC' in case the address is a service location (as needed due to Mastercard mandate AN6022). Otherwise, use value 'FIXD' or don't send this element at allo
Envt/Mrchnt/LctnAndCtct/... PstlAdr/AdrLine.../AdrLine
street house-number,city,zip-code or
house-number,street,city,zip-code
Mapped to below values, if //AdrLine are not given.

or

.../StrtNm
.../BldgNb
.../TwnNm
.../PstCd
.../Ctry
.../AddtlCtctInf
o
Envt/POI/Cpblties/CardRdngCpbltiesFor terminals supporting contactless single-tap PIN requests, include one additional occurrence with value "OTHR". nexo does not support a dedicated value for this capability yet, but it is expected to be added to future releases.o
Envt/POI/Cpblties/OnLineCpbltiesSee NEXO MDRo
Envt/POI/Cpblties/CrdhldrVrfctnCpbltiesSee NEXO MDRo
Envt/POI/Cmpnt/TpOnly components with type "TERM" are evaluated.o
Envt/POI/Cmpnt/Id/SrlNbTerminal serial numbero
Envt/POI/Cmpnt/StdCmplc/IssrOnly standard complience entries with Issr=GBIC are evaluated.o
Envt/POI/Cmpnt/StdCmplc/IdTerminal approval number
Used for GIRO-Card transactions.
o
Envt/Card/PrtctdCardData/CnttTpUse value 'EVLP'o
Envt/Card/PrtctdCardData/... EnvlpdData/Rcpt/KEK`link to 'Encryption and MAC'ing' to be addedo
Envt/Card/PrtctdCardData/... EnvlpdData/NcrptdCnttContains encyrpted card datao
Envt/Card/PlainCardData/PANContains card number in plain format, not to be used in productive environmento
Envt/Card/PlainCardData/CardSeqNbContains card sequence number in plain format, not to be used in productive environmento
Envt/Card/PlainCardData/XpryDtContains card expiry date in plain format, not to be used in productive environmento
Envt/Card/PlainCardData/Trck1Contains track 1 data in plain format, not to be used in productive environmento
Envt/Card/PlainCardData/Trck2Contains track 2 data in plain format, not to be used in productive environmento
Envt/Card/PlainCardData/Trck3Contains track 3 data in plain format, not to be used in productive environmento
Envt/Card/PmtAcctRefTOKEN: Token value. This field is used to have the possibility to use tokens with length > 35
If this value is set, it is used instead of the card data
o
Envt/Card/CardCtryCdISO 3166 – 1, alphanumeric or numerico
Envt/Card/CardCcyCdCurrency code for cardo
Envt/Card/CardPdctPrflDefines a category of cards grouped together for reconciliation.
Mandatory in transactions that are relevant for reconciliation.
Filled with "Card Brand" and not with the actual card product profile as defined in nexo IS in order to allow grouping by brand.
o
Envt/Card/CardBrndContains brand of the card with one of:
A-Amex
B-BCMC
C-Carte Bancaire (France)
CONECS - Conecs lunch card (France)
D-Diners
E-Maestro
F-EFTPOS (Australia)
G-Giro
J-JCB
K – BLIK (Poland)
L-ELV (Germany)
M-Mastercard
MOBILEPAY - MobilePay
N-VISA Electron
P-VPAY
SWISH - Swish
U-UPI
V-Visa
VIPPS - Vipps
X-Flexecash
m
Cntxt/PmtCntxt/CardPresCard was (not) presento
Cntxt/PmtCntxt/CrdhldrPresCardholder was (not) presento
Cntxt/PmtCntxt/AttndncCntxtSee Unattended terminalso
Cntxt/PmtCntxt/CardDataNtryMdFor Payment with Token - CDFL.

For other payments, value indicates the entry mode of the card data (TAGC, PHYS, BRCD, MGST, CICC, DFLE, CTLS, ECTL)
m
Cntxt/PmtCntxt/FllbckIndIndicates a problem with the chip

FFLB - FallbackAfterFailure
SFLB - FallbackAfterSuccess
NFLB - NoFallback
o
Tx/MrchntCtgyCdMerchant category codem
Tx/TxId/TxRefReference-ID of transaction.
Used as trace-number, format 999999

Format: Max6Numeric

Other length:
e.g. for pre-authorizations done with an alternative payment method (APM): 35 digits
or 12 digits with leading zeroes
m
Tx/SaleRefIdRequired in Cancellation of Completion. Can be used to reference the transaction to void.o
Tx/TxId/TxDtTmDate time of transactionm
Tx/OrgnlTxIf given, subfields have to uniquely identify the referenced transaction.
This field is the preferred way to reference the transaction to void, but if this is not possible the transaction may be referenced by the Tx/saleRefID or Tx/RcptTxId
o
Tx/TxSucssdepending on NEXO caseo
Tx/Rvsldepending on NEXO caseo
Tx/FailrRsnIf set, this transaction is handled as technical-void (auto-void) => mandatory for technical voids.
In such a case the transaction must be sent directly after the transaction to void.
Nevertheless you have to reference the transaction to void correctly.
o
Tx/InitrTxIdMerchant Reference 1.o
Tx/RcptTxIdReceipient transaction ID. Can be used to reference the transaction to void.o
Tx/RcncltnIdReconciliation ID, this transaction belongs to.m
Tx/AddtlTxData/exceptioncode/Emergency1
/exceptioncode/Emergency2
/request/token
/request/ELVMerchantForced if Merchant forced ELV transaction (Limit Override)
For transaction type VALC - Validity check:
/request/token
/request/tokenOnly (no card validation is done)
For second submission of single-tap transaction with PIN data (PSD2 SCA requirements):
/request/ContactlessSingleTapPIN
For BLIK trx or any other trx that require the entry of a one time code (OTC):

/request/OTCEntryMode/01 - if code was manually entered by merchant on POS device
/request/OTCEntryMode/02 - if code was manually entered by cardholder on PED device
/request/OTCEntryMode/03 - if code was sent to terminal via NFC

For deferred authorization:
/DeferredAuth
o
Tx/TxDtls/TtlAmtAmount in currency
DCC: Amount in target currency (copied from dcc_response.Tx/CcyConvsRslt/...
ConvsDtls/RsltgAmt)
o
Tx/TxDtls/CcyCurrency
DCC: target currency (copied from dcc_response.Tx/CcyConvsRslt/...
ConvsDtls/TrgtCcy/AlphaCd)
o
Tx/TxDtls/AcctTpType of cardholder account used for the transaction.
Values: CHCK, CRDT, CDBT, SVNG etc. (more possible values)
In case of Default value, this tags will not be present.
o
Tx/TxDtls/ICCRltdDataEMV-dat according to EMVCo speco
SctyTrlr/AuthntcdDataMAC . May be disabled or set to optional by a parameter. If set to optional, a message without MAC is accepted and the response will not contain a MAC.o
AcceptorCancellationAdviceResponseV06- caaa.008.001.06
TagDescriptionPresence
Hdr/MsgFctnIdentifies the type of transaction.m
Tx/TxId/TxRefCopied from requestm
Tx/TxId/TxDtTmCopied from requestm
Tx/InitrTxIdCopied from requesto
Tx/RcncltnIdCopied from requestm
Tx/RcptTxIdID for this transaction generated by IPG. Will be used in subsequent related pre-authorization management transactions.
Format: Max35Text
For client (reseller) specific formatting: check with your client support contact
m
Tx/RspnAPPR - approved
DECL - declined
PART - partially approved
m
SctyTrlr/AuthntcdDataMAC . May be disabled or set to optional by a parameter. If set to optional, a message without MAC is accepted and the response will not contain a MAC.o
AcceptorCompletionAdviceV06 - caaa.003.001.06
TagDescriptionPresence
Hdr/MsgFctnIdentifies the type of transaction.
AUTQ for Pre-authorization, Card validity check, Balance Enquiry
FAUQ for Payments
m
Hdr/RcptPty/RmotAccs/AccsCdOne-time code. Currently only used for BLIK paymentso
Envt/Mrchnt/LctnCtgyUse value 'NMDC' in case the address is a service location (as needed due to Mastercard mandate AN6022). Otherwise, use value 'FIXD' or don't send this element at allo
Envt/Mrchnt/LctnAndCtct/PstlAdr/....../AdrLine
street house-number,city,zip-code or
house-number,street,city,zip-code
Mapped to below values, if //AdrLine are not given.

or

.../StrtNm
.../BldgNb
.../TwnNm
.../PstCd
.../Ctry
.../AddtlCtctInf
o
Envt/POI/Cpblties/CardRdngCpbltiesFor terminals supporting contactless single-tap PIN requests, include one additional occurrence with value "OTHR". nexo does not support a dedicated value for this capability yet, but it is expected to be added to future releases.o
Envt/POI/Cpblties/CrdhldrVrfctnCpbltiesSee NEXO MDR
Envt/POI/Cpblties/OnLineCpbltiesSee NEXO MDRo
Envt/POI/Cmpnt/TpOnly components with type "TERM" and "DVCE" are evaluated.o
Envt/POI/Cmpnt/Id/SrlNbTerminal serial numbero
Envt/POI/Cmpnt/StdCmplc/IssrOnly standard compliance entries with Issr=GBIC are evaluated.o
Envt/POI/Cmpnt/StdCmplc/IdTerminal approval number
Used for GIRO-Card transactions.
o
Envt/Card/PrtctdCardData/CnttTpEVLPo
Envt/Card/PrtctdCardData/... EnvlpdData/Rcpt/KEKSee Protected card datao
Envt/Card/PrtctdCardData/... EnvlpdData/NcrptdCnttSee Protected card datao
Envt/Card/IssrBINOnly needed for AccptrCcyConvsReqo
Envt/Card/CardCtryCdISO 3166 – 1, alphanumeric or numeric

Only needed in case of offline sale or credit transaction
o
Envt/Card/CardCcyCdISO 3166 – 1, alphanumeric or numeric

Only needed in case of offline sale or credit transaction
o
Envt/Card/CardPdctPrflDefines a category of cards grouped together for reconciliation.
Mandatory in transactions that are relevant for reconciliation.
Filled with "Card Brand" and not with the actual card product profile as defined in nexo IS in order to allow grouping by brand.
o
Envt/Card/CardBrndContains brand of the card with one of:
A-Amex
B-BCMC
C-Carte Bancaire (France)
CONECS - Conecs lunch card (France)
D-Diners
E-Maestro
F-EFTPOS (Australia)
G-Giro
J-JCB
K – BLIK (Poland)
L-ELV (Germany)
M-Mastercard
MOBILEPAY - MobilePay
N-VISA Electron
P-VPAY
SWISH - Swish
U-UPI
V-Visa
VIPPS - Vipps
X-Flexecash
m
Envt/Card/PmtAcctRefToken value. Only used when payment is initiated with Token number (manually read or received from ECR) instead of card data. Other Card subfields must not be present in this case.

Only needed for offline sale or credit transaction.
o
Envt/PmtTkn/TknRqstr/PrvdrIdIdentifies the provider of the token: IPG, IPGTA. Not required in request message.o
Envt/Crdhldr/BllgAdr/AdrLineInformation that locates and identifies a specific address, as defined by postal services, presented in free format text.
This field and other elements under BllgAdr are required in case cardholder address shall be passed to issuer for validation.
o
Envt/Crdhldr/BllgAdr/PstCdIdentifier consisting of a group of letters and/or numbers that is added to a postal address to assist the sorting of mail.o
Envt/Crdhldr/BllgAdr/TwnNmName of a built-up area, with defined boundaries, and a local government.o
Envt/Crdhldr/BllgAdr/CtryNation with its own government, occupying a particular territory.o
Cntxt/PmtCntxt/CardPresCard was (not) present

Default: true
o
Cntxt/PmtCntxt/CrdhldrPresCardholder was (not) present

Default: true
o
Cntxt/PmtCntxt/AttndncCntxtSee Unattended terminalso
Cntxt/PmtCntxt/CardDataNtryMdFor Payment with Token - CDFL.

For other payments, value indicates the entry mode of the card data (TAGC, PHYS, BRCD, MGST, CICC, DFLE, CTLS, ECTL)
m
Cntxt/PmtCntxt/FllbckIndIndicates a problem with the chip

FFLB - FallbackAfterFailure
SFLB - FallbackAfterSuccess
NFLB - NoFallback
o
Cntxt/PmtCntxt/TxChanlType of the communication channels used by the cardholder to the acceptor system. Only below values will be considered:

MAIL - Mail order
TLPH -Telephone order
o
Cntxt/SaleCntxt/SaleIDIdentification of the sale system. Should not be populated on stand-alone terminals, only on terminals integrated with sale systems.o
Cntxt/SaleCntxt/SaleRefNbTransaction identifier assigned by the sale system. Referred to as Merchant Reference 1. Maximum size 15.o
Cntxt/SaleCntxt/CshrIdIdentification of the cashier who initiated the transaction on the sale system. Should not be populated on stand-alone terminals, only on terminals integrated with sale systems.o
Tx/TxCaptrTRUEm
Tx/TxTpBALC - Balance Enquiry
CRDP - Card payment
DEFR - Deferred Payment
RESA - Reservation
RFND - Refund
VALC - Validity check
m
Tx/MrchntCtgyCdMerchant category codem
Tx/SaleRefIdMust contain the original pre-authorization ID (= RcptTxId from Acceptor Authorization Response)o
Tx/TxId/TxRefReference-ID of transaction.
Used as trace-number, format 999999

Format: Max6Numeric

Other length:
e.g. for pre-authorizations done with an alternative payment method (APM): Max35Alpha-Numeric
or 12 digits with leading zeroes
m
Tx/TxId/TxDtTmDate & time of transactionm
Tx/OrgnlTxSub-elements must match the request and response elements of the original pre-authorization transaction.m
Tx/RvslSet to "True" in Negative Completions (Automatic reversals) initiated by the POI after failed transactions.o
Tx/FailrRsnShould be included in Negative Completions. Values defined in ISO CAPE.o
Tx/InitrTxIdMerchant Reference 1.o
Tx/RcncltnIdReconciliation ID, this transaction belongs to.m
Tx/AddtlTxData/request/ELVMerchantForced if Merchant forced ELV transaction (Limit Override)o
Tx/TxDtls/TtlAmtTransaction Amount.

For Payment Completion, the amount represents the completion amount (i.e. amount to be cleared).
DCC: Amount in target currency (copied from dcc_response.Tx/CcyConvsRslt/ConvsDtls/RsltgAmt)
m
Tx/TxDtls/AmtQlfrACTL - Actual amount.o
Tx/TxDtls/DtldAmt/AmtGoodsAndSvcsAmount of purchased goods or services. Should only be included if it is different from the total amount.
If Gratuity or Cashback is given, it must be present.

For DCC: amount in merchant (source/original) currency.
If DCC was accepted this is not in the same currency as TtlAmt.
c
Tx/TxDtls/DtldAmt/GrttyGratuity amount. Should only be included when gratuity (tip) is included in total amount.

For DCC: amount in merchant (source/original) currency. If DCC was accepted this is not in the same currency as TtlAmt.
o
Tx/TxDtls/DtldAmt/CshBckCashback amount.

For DCC: amount in merchant (source/original) currency. If DCC was accepted this is not in the same currency as TtlAmt.
o
Tx/TxDtls/AcctTpType of cardholder account used for the transaction.
Values: CHCK, CRDT, CDBT, SVNG etc. (more possible values)
In case of Default value, this tags will not be present.
o
Tx/TxDtls/VldtyDtReservation validity date. Will be present in initial and update reservation.o
Tx/TxDtls/CcyCurrency
DCC: target currency (copied from dcc_response.Tx/CcyConvsRslt/ConvsDtls/TrgtCcy/AlphaCd)
m
Tx/TxDtls/CcyConvsRslt/ AccptdByCrdhldrDCC: If true, customer accepted and DCC should be applied.o
Tx/TxDtls/CcyConvsRslt/... Convs/CcyConvsIdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/CcyConvsId
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/TrgtCcy/AlphaCdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/TrgtCcy/AlphaCd
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/TrgtCcy/NmrcCdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/TrgtCcy/NmrcCd
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/TrgtCcy/DcmlDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/TrgtCcy/Dcml
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/RsltgAmtDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/RsltgAmt
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/XchgRateDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/XchgRate
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/QtnDtDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/QtnDt
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/VldUntilDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/VldUntil
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/SrcCcy/AlphaCdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/SrcCcy/AlphaCd
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/SrcCcy/NmrcCdDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/SrcCcy/NmrcCd
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/SrcCcy/DcmlDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/SrcCcy/Dcml
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/CcyConvsRslt/... Convs/OrgnlAmt/ActlAmtDCC: Copy of Tx/CcyConvsRslt/ConvsDtls/OrgnlAmt/ActlAmt
from AcceptorCurrencyConversionResponse
o
Tx/TxDtls/UattnddLvlCtgySee Unattended terminalso
Tx/TxDtls/AcctTpType of cardholder account used for the transaction.

Values: CHCK, CRDT, CDBT, SVNG etc. (more possible values)

In case of Default value, this tags will not be present.
o
Tx/TxDtls/ICCRltdDataEMV-dat according to EMVCo speco
Tx/TxDtls/SaleItm/ItmIdIdentification of the item inside the purchase transaction.o
Tx/TxDtls/SaleItm/PdctCdProduct code of the item.
Tx/TxDtls/SaleItm/AddtlPdctCdAdditional product code related to the producto
Tx/TxDtls/SaleItm/UnitOfMeasrUnit of measure of the item purchasedo
Tx/TxDtls/SaleItm/PdctQtyProduct quantityo
Tx/TxDtls/SaleItm/UnitPricPrice per unit of product.o
Tx/TxDtls/SaleItm/UnitPricSgnSign of the unit price.o
Tx/TxDtls/SaleItm/PdctAmtMonetary value of purchased product.o
Tx/TxDtls/SaleItm/PdctAmtSgnSign of the product amount.o
Tx/TxDtls/SaleItm/ValAddedTaxValue added tax amount of the item included in the product amount.o
Tx/TxDtls/SaleItm/TaxTpInformation on tax paid on the product.o
Tx/TxDtls/SaleItm/PdctDescDescription of the product or item.o
Tx/TxDtls/SaleItm/DlvryLctnLocation of the delivery of the item, for instance pump number or parking bay.o
Tx/TxDtls/SaleItm/DlvrySvcIdentify the method of delivery or distribution of the item.o
Tx/MrchntRefDataMerchant Reference 2o
SctyTrlr/AuthntcdDataMAC . May be disabled or set to optional by a parameter configured in our gateway. If set to optional, a message without MAC is accepted and the response will not contain a MAC.m
AcceptorCompletionAdviceResponseV06 - caaa.004.001.06
TagDescriptionPresence
Hdr/MsgFctnIdentifies the type of transaction.m
Envt/Card/PmtAcctRefValue of tokeno
Tx/TxId/TxRefCopied from requestm
Tx/TxId/TxDtTmCopied from requestm
Tx/InitrTxIdCopied from requesto
Tx/RcncltnIdCopied from requestm
Tx/RcptTxIdID for this transaction generated by IPG. Will be used in subsequent related pre-authorization management transactions.
Format: Max35Text
For client (reseller) specific formatting: check with your client support contact
m
Tx/RspnAPPR - approved
DECL - declined
PART - partially approved
m
SctyTrlr/AuthntcdDataMAC . May be disabled or set to optional by a parameter. If set to optional, a message without MAC is accepted and the response will not contain a MAC.o
Possible use cases of Traceability element

GUID (Globally Unique Identifier)

TagDescriptionPresence
Hdr/Tracblt/RlayId/IdIdentification of the entity.
For use case 'GUID' use value 'GUID'.
By default not required in the request. Only needed in cases where it's explicitly required by the terminal to generate the GUID
O
Hdr/Tracblt/RlayId/TpType of the identified entity.
For use case 'GUID' use value 'ACCP'.
By default not required in the request. Only needed in cases where it's explicitly required by the terminal to generate the GUID.
O
Hdr/Tracblt/RlayId/ShrtNmName of the entitiy.
Value will be GUID itself calculated by POI.
By default not required in the request. Only needed in cases where it's explicitly required by the terminal to generate the GUID
O
Hdr/Tracblt/TracDtTmInDate and time of incoming data exchange for relaying or processing.
Required only when Traceability component is used in message.
O
Hdr/Tracblt/TracDtTmOutDate and time of outgoing data exchange for relaying or processing.
Required only when Traceability component is used in message.
O