Outlines making a basic card payment from your sale system using the Terminal API.
Make the most basic type of
PaymentRequest to the nexo endpoint: a card payment with no tender options, additional data or extra functionality.
ServiceID in the
MessageHeader should be unique.
ServiceID combinations are rejected if used recently, within 48 hours.
For a list of Payment Request fields, see PaymentRequest fields.
To support analysis and troubleshooting of payments, pass
AppName in additional data. For more information, see Pass additional data using the Terminal API.
TimeStamp must be a current timestamp. The payment will be rejected if it is more than 24 hours before or after the timestamp.
Use our POS test card numbers to test your integration.
For a list of Payment Response fields, see PaymentResponse fields.
An authorisation is attempted and you receive a response with the following fields:
Dynamic Currency Conversion allows your shoppers to pay in their home currency when using Visa and Mastercard.. The terminal must be configured to allow DCC.
Contact POS Support Team to enable this setting.
When the terminal detects a card with a default currency that differs from the merchant’s currency, it offers DCC to the shopper. The terminal displays full details of the exchange rate to the shopper to help the shopper decide whether to convert. The same information is displayed on the Cash Register for the merchant.
The shopper either accepts or rejects the DCC offer and proceeds with the selected amount and currency. If DCC is selected, related information is shown on the receipt.
If you enable Dynamic Currency Conversion (DCC), and perform a DCC transaction, the following data is returned, including the
Payment responses can also include additional form encoded data. For example:
If a PSP reference has not yet been generated, the TransactionID will only consist of a tender reference. This could occur if the transaction was completed offline.
Not all data in a payment response will always be available. The availability of some data depends on an internet connection and the payment method used.