a a



Transaction amount in US dollars.


The authorization code returned from the Merchant’s credit card processing capture process. The AuthCode will be used for reconciliation of fees.


This is opaque data that is available for further data analytics and is also used during A/B Test-Implementation phases.


The ISO Numerical Country Code. See https://en.wikipedia.org/wiki/ISO_3166-1. This is an optional field and will default to 840/US.

NICN (Non-Identifiable Card Number)

The first 6-8 digits of credit card number. SurchX never handles more than 12 digits and therefore is not in conflict with PCI requirements or guidelines.


The MID or Name value of the processor to use for calculating Transaction Fees. This field is optional when the Merchant has only one configured processor. In that case the single, configured processor is used.

Transaction Fee

SurchX generated fee for making a credit card transaction (sent in response from API).


A Merchant orderId or unique identifier in the Merchant e-commerce scope referencing the Order or Shopping Cart. This field is optional. If the mTxId is not known until the “capture” sequence, it may be passed at that time.


Zip code or the ISO State Code. See https://en.wikipedia.org/wiki/ISO_3166-2:US. There are cases when the region is optional.


It is a unique identifier in the SurchX system which refers to the persistence state of the Transaction Fee calculation.