References and Identifiers
Merchant References
First Data allows additional transaction references for the following transaction types:
- Payment
- Payment with Gratuity
- Recurring Payment
- Refund
Message elements InitiatorTransactionIdentification (Tx/InitrTxId
) and MerchantReferenceData (Tx/MrchntRefData
) may be optionally used by merchants to pass additional references to the Central Acceptance Platform. The table below shows the usage of these two optional fields within different interfaces in Fiserv.
Reference element | Description | Supported format in Fiserv | NEXO Acquirer field | NEXO Retailer field |
---|---|---|---|---|
Merchant Reference 1 | Reference number provided by merchant that will be passed to acquirer, issuer (if supported by scheme) and printed on cardholder receipt. It could be generated by the Merchant POS or manually entered on the POI. | 15 AN | Tx/InitrTxId | StatementReference |
Merchant Reference 2 | Reference number provided by merchant generated by the Merchant POS or manually entered on the POI. Used by merchants for their own internal purposes. The reference will only be available on Fiserv internal systems. Examples: Internal reservation number, booking number/reference | 30 AN | Tx/MrchntRefData | SaleToAcquirerData |
Identifiers
Transaction identifiers
Order ID
IPG assigns an order ID to transactions in the response message element Tx/RcptTxId
. The value must be used in related transactions such as incremental authorizations and completions. The request tag Tx/OrgnlTx/RcptTxId
is not supported in Payment messages.
Transaction ID
This element uniquely identifies a transaction. It must be unique for each message pair (request, response). A technical void (or cancel) can use the same transaction ID.
The transaction ID consists of two sub-fields: TxDtTm
and TxRef
.
The TxDtTm
is used as the transaction time. In an online transaction it must be close to the current time otherwise it is possible that authorization system won't accept the transaction.
TxRef is forwarded to some end-systems. To avoid problems the following rules should be met:
TxRef
should be a numeric counter with values in [000000, 999999].
If transaction n follows transaction n-1, then TxRef
in n must be greater than the one in n-1.
If transaction n-1 has a TxRef
> 900000, It is possible to use a value less then 100000 for transaction n. This is to allow a restart of the counter, when all values are used.
It is also a good idea not to increment the counter by 1, but by a higher number (e.g.: 10). The reason for this is the following: It is possible to configure an automatic cut-over in IPG for a terminal (or store). In this case IPG must send a message to the next system. This message requires also a TxRef
(or more exact a trace number which is derived from TxRef
). IPG will use the last value of TxRef
+ 1. If after this the terminal sends this TxRef again, it will fail (this may depend on the ensystem IPG uses to forward the transaction).
Store, merchant and terminal identifiers
Every request message sent by the POI must include two merchant identifiers: Store ID and Merchant ID. The Store ID is an IPG identifier of the "shop" entity, while the Merchant ID is the Acquirer card brand specific merchant identifier that will be sent in authorization and clearing messages. The POI will include the Store ID in element Envt/POI/GrpId
and the Merchant ID in element Envt/Mrchnt/Id/Id
.
Every terminal gets assigned an Acquirer identifier (referred to as Acquirer TID) and a Fiserv identifier (referred to as External TID). This section describes the relation between the two and the way they are reflected in the nexo Acquirer protocol. The term "Acquirer" is used throughout the document with a wider meaning than the industry standard meaning of "Acquiring Bank/Processor". It could also refer to different payment providers including alternative payment providers (APMs).
There are 2 basic modes of operation for Fiserv integrated devices:
- Acquirer Processor
- PSP
When Fiserv drives a terminal as an acquirer processor, the External TID will also be used as an Acquirer TID, being sent to card schemes and printed on receipts.
When Fiserv drives a terminal as a PSP, it typically routes the traffic to one or more Acquirers (or APMs). The merchant and acquirer will identify a terminal by its Acquirer assigned TID, while the External TID will only be known by Fiserv systems and not forwarded to card schemes.
Terminal numbering
- In Germany productive TIDs are centrally assigned by Deutsche Kreditwirtschaft (DK).
For the integration via Fiserv, TIDs have to be in the range 54xxxxxx and
have to be requested from our German business department. - For other countries the format limitation is less strict. In general a limitation to 8
characters/digit should be sufficient - TIDs (or TID ranges) will be provided from your Fiserv contact.
- On request, Fiserv can also use terminal IDs defined by terminal providers.
Updated about 2 months ago