Terminal Transaction Callback

Sent by the gateway after the terminal completes the transaction.

IMPORTANT:

  • CODE=0000 → Approved
  • CODE≠0000 → Declined or failed
  • Receipts contain HTML content and can be large
Payload
string
required

Text response. APPROVED on a successful transaction.

string
enum
required

Response code. 0000 indicates the transaction was approved.

Allowed:
string
required

Session identifier assigned by the gateway for this transaction. Matches the SECUREID returned by StartSession.

string
required

Transaction amount in dollars and cents (numeric with decimal).

string
required

Unique request ID sent in StartSession.

string

Reference number assigned by the terminal for this transaction.

string

Invoice number sent in StartSession.

string
required

Authorization number. Only displayed on approval-type transactions.

string
enum
required

Card type:
V = Visa
M = Mastercard
A = American Express
D = Discover
I = Interac (Debit)

Allowed:
string
required

Masked card number with only the last 4 digits visible.

string
required

Customer email address sent in StartSession.

string
required

Acknowledgement flag. Y if the payment was captured.

string

Refund flag. Only present if this was a refund transaction.

RECEIPTS
object
required

Receipt HTML provided by the terminal.

Response
200

Acknowledge receipt of callback

LoadingLoading…