Introduction

In order to offer a future-proven interface for transactions initiated on a physical terminal, Fiserv has introduced the NEXO interface (also called EPAS interface within Fiserv) which is based on the ISO20022 XML standard.

For an Overview about NEXO please refer to nexo-standards.org.

Fiserv supports the following NEXO standards:

  • NEXO IS v4.0 provides how to integrate the nexo Specifications and Protocols with a compliant nexo FAST payment application.
  • NEXO Acquirer Protocol v6 defines the communication between Terminal connector/host
    and authorization host or card acceptor (in our case: the Fiserv gateway).
  • NEXO TMS Protocol defines the framework for configuring, managing and maintaining the application parameters, the software and the security keys of a payment system.
  • NEXO Retailer Protocol defines the communication between electronic cashier system
    (ECR) and Terminal connector/host.
  • NEXO Fast (3.2) defines processes and workflows, user interaction (such as interfaces and receipt printing) and error handling among the various systems that are involved during payment processing.

This guide focuses on the integration of a POS Host to Fiserv’s payment gateway via NEXO Acquirer Protocol.

📘

Most important documents that are needed to build the interface on your host:

CAPE - Acceptor to Acquirer - Maintenance 2016 -2017
Message Definition Report - Part 2
(Approved by the ISO 20022 Cards SEG on 10 May 2017)
Download complete message set (external link)

CAPE - Card Payments - Message Usage Guide
Version 6.0 (4 December 2017)
Download the MUG (external link)

nexo-FAST Part 1_V3.2_180528.pdf
Download the NEXO FAST specification (external link)

ISO20022: website of iso20022.org
(NON FISERV) (e.g. for version 6 of the Acquirer protocol)

Within the NEXO archive you will also find other useful resources.

In order to access the NEXO-standards webpage you will need to create a free account.

Messaging

Single vs dual message mode

Fiserv currently only supports single messaging service/mode (SMS, capture in authorization request)

NEXO dual message and batch mode are not supported as of now.

Supported NEXO Cases

The NEXO acquirer message usage guide defines the use cases that terminal vendors need or can implement (See MUG V5.0/6.0, chapter 5.2 and 5.4). Below is a list of the payment cases supported by Fiserv.

Payment Cases

Business scenarioCases as per NEXO MUGNote
Online authorized sale, linked refund or credit1, 12, 22Use Acceptor Authorisation Request
Technical reversal following an incident after auth.
(Auto reversal)
6, 32, 38Use Acceptor Completion Advice
(negative completion). But you can also use Accepttor Cancellation Request.
Offline authorized sale47, 50Use Acceptor Completion Advice

Cancellation Cases

Business scenarioCases as per NEXO MUGNote
Manual reversal1, 5Per nexo use Acceptor Cancellation Advice. But you can also use Accepttor Cancellation Request.

Transaction Types

TypeAvailable functions NEXO messageDescription
Payment
(aka purchase or sale)
Gratuity/Tip, DCC, MOTO, Cashback, Token generation, Credential-On-File TransactionOnline:
caaa.001.001.06 / caaa.002.001.06
Hdr/MsgFctn = FAUQ
Tx/TxCaptr = True
Tx/TxTp = CRDP

Offline:
caaa.003.001.06 / caaa.004.001.06
Hdr/MsgFctn = FCMV
Tx/TxCaptr= true
Tx/TxTp = CRDP
Tx/OrgnlTxnot set
Tx/TxSucss = true
Tx/Rvsl = false (or not set)
The most common
transaction to trigger a
payment.

More details: link
Preauthorisation
(aka reservation)
DCC, MOTO, Token generation, Credential-On-File Transactioncaaa.001.001.06 / caaa.002.001.06
Hdr/MsgFctn = AUTQ
Tx/TxTp = RESA
Tx/TxCaptr = false
Tx/TxTp = DEFR or RESA
Tx/TxDtls/AmtQlfr = RSED
To perform an initial reservation of an amount on cardholder account

More details: link
Preauthorisation cancelation
(aka reservation reversal)
-caaa.003.001.06 / caaa.004.001.06
Hdr/MsgFctn = RVRA/RVRR
Tx/TxTp = RESA
Tx/SvcAttr = IRES
More details: link
Preauthorisation update
(aka reservation update)
-caaa.001.001.06 / caaa.002.001.06
Tx/TxTp = RESA
Tx/SvcAttr = URES
Tx/TxCaptr = false
Tx/TxDtls/AmtQlfr = INCR or DECR
To perform a preauthorization increment or decrement

More details: link
Preauthorisation completion
(aka post-authorization, reservation
completion,
payment for
completion)
DCCcaaa.003.001.06 / caaa.004.001.06
Hdr/MsgFctn = FCMV/FCMK
Tx/TxCaptr = true
Tx/TxTp = RESA
Tx/OrgnlTx set
Tx/TxSucss = true
Tx/Rvsl = false (or not set)
Tx/TxDtls/AmtQlfr = ACTL
to complete a
reservation

More details: link
Preauthorisation completion cancelation
(aka reversal of post-authorisation)
-caaa.007.001.06 / caaa.008.001.06
Hdr/MsgFctn = RVRA/RVRR
Tx/TxTp = RESA
Tx/SvcAttr = PRES
Tx/SaleRefId = Pre-authorization ID returned by IPG in original pre-authorization response
to reverse a completed reservation before settlement

More details: link
Reversal
(aka void, cancellation)
-caaa.007.001.06 / caaa.008.001.06
Hdr/MsgFctn = CCAV
Tx/FailrRsn not set

or

caaa.005.001.06 / caaa.006.001.06
Hdr/MsgFctn = CCAQ
To manually cancel a transaction before settlement. Can only be performed with full amount.

More details: link
Technical reversal
(aka auto void)
-caaa.007.001.06 / caaa.008.001.06
Hdr/MsgFctn = CCAV Tx/FailrRsn set

or

caaa.003.001.06 / caaa.004.001.06
Hdr/MsgFctn = FRVA
Tx/Rvsl = true

or

caaa.005.001.06 / caaa.006.001.06
Hdr/MsgFctn = CCAQ
To trigger a technical
cancellation of
transaction

More details: link
Return
(aka linked refund)
DCCcaaa.001.001.06 / caaa.002.001.06
Hdr/MsgFctn = FAUQ
Tx/TxCaptr = true
Tx/TxTp = RFND
Tx/OrgnlTx set
To return an amount
to the customer. Must
be used, instead of
void, if the settlement
is already done.

More details: link
Credit
(aka naked refund)
-caaa.001.001.06 / caaa.002.001.06
Hdr/MsgFctn = FAUQ
Tx/TxCaptr = true
Tx/TxTp = RFND
`Tx/OrgnlTx not set
To refund the cardholder for previously paid goods and services. It is not matched against the previous payment transaction, so the amount can be either full or partial.

More details: link
Balance
inquiry
-caaa.001.001.06 / caaa.002.001.06
Hdr/MsgFctn = AUTQ
Tx/TxCaptr = false
Tx/TxTp = BALC
To check the amount
which is currently
reserved. This ffunctionality can also be used for an extended status inquiry.

More details: link
Deferred Payment Completion-caaa.003.001.06 / caaa.004.001.06
Hdr/MsgFctn = FCMV/FCMK
Tx/TxTp = DEFR
Tx/TxDtls/AmtQlfr = ACTL
More details: link
Deferred Authorisation-caaa.001.001.06 / caaa.002.001.06
Hdr/MsgFctn = FAUQ
Tx/TxCaptr = True
Tx/TxTp = CRDP
More details: link
MOTO
(aka mobile order / phone order)
-caaa.001.001.06 / caaa.002.001.06
Cntxt/PmtCntxt/CardPres= False
Cntxt/PmtCntxt/CrdhldrPres= false
Cntxt/PmtCntxt/CardDataNtryMd = PHYS
To perform a manually keyed transactions where neither card nor cardholder is present and card data was sent via mail or phone
More details: link
Reconciliation-caaa.009.001.06 / caaa.010.001.05
Hdr/MsgFctn = RCLQ
Tx/ClsPrd = true/false
To compare totals between terminal and our gateway. Can be done daily or less frequent. Can also be used to close the reconciliation period.
More details: link
DCC inquiry
(aka rate request inquiry)
-caaa.016.001.04 / caaa.017.001.04
Hdr/MsgFctn = DCCQ
To request a DCC rate and amount

More details: link
Card
validation

(aka card verification, zero amount transaction)
-caaa.001.001.06 / caaa.002.001.06
Hdr/MsgFctn = AUTQ
Tx/TxCaptr = false
Tx/TxTp = VALC
Tx/TxDtls/TtlAmt = 0
To tokenize or verify card details

More details: link
Echo
(aka diagnostic message)
-caaa.013
Hdr/MsgFctn=DGNP

Did this page help you?
Want a quick overview?