Enum Reference
All enum fields are case-insensitive — "purchase" and "PURCHASE" both work. Values are auto-normalized by the API.
transaction_type
| Value | Description |
|---|---|
PURCHASE | Standard purchase transaction |
AUTHORISATION | Authorization-only (no capture) |
REFUND | Refund / credit back to cardholder |
REVERSAL | Reversal of a previous transaction |
CREDIT | Original credit (not related to a purchase) |
CASH_ADVANCE | Cash advance / withdrawal |
ATM | ATM withdrawal |
TRANSFER | Money transfer |
CHARGEBACK | Chargeback from issuer |
REPRESENTMENT | Representment of a chargeback |
FUNDS_TRANSFER | Person-to-person or account-to-account transfer |
INSTALLMENT | Installment payment |
entry_mode
| Value | Description | Card Present? |
|---|---|---|
CHIP | EMV chip (contact) | Yes |
CONTACTLESS | NFC / tap-to-pay | Yes |
MAGNETIC_STRIPE | Magnetic stripe swipe | Yes |
MANUAL | Manual card number entry at terminal | Yes |
ECOM | E-commerce / online | No |
CARD_ON_FILE | Stored credentials / subscription | No |
MAIL_ORDER | Mail order (MOTO) | No |
TELEPHONE_ORDER | Telephone order (MOTO) | No |
TOKEN | Device token (Apple Pay, Google Pay) | No |
transaction_status
| Value | Description |
|---|---|
NEW | Initial transaction |
AUTHORIZED | Authorization approved |
CHARGED | Captured / settled |
DECLINED | Authorization declined |
REVERSED | Transaction reversed |
REFUNDED | Refund processed |
CHARGEDBACK | Chargeback received |
CREDITED | Credit applied |
PREPARED | Pre-authorization / hold |
FRAUD | Flagged as fraudulent |
REJECTED | Rejected by processor |
ERROR | Processing error |
options.mode
| Value | Description |
|---|---|
all | Calculate scheme fees + interchange (default) |
scheme | Scheme fees + fixed fees only |
interchange | Interchange only |
Region Scope (response only)
| Value | Description |
|---|---|
DOMESTIC | Issuer and merchant in the same country |
INTRA_EEA | Both parties in the European Economic Area |
INTRA_NON_EEA | Same region, one/both parties outside EEA |
INTRA_REGIONAL | Same payment network region, different countries |
INTER_REGIONAL | Different payment network regions (e.g. Europe–US) |
CROSS_BORDER | Cross-border (generic) |
BILATERAL | Bilateral agreement between specific countries |
