Skip to content

Enum Reference

All enum fields are case-insensitive"purchase" and "PURCHASE" both work. Values are auto-normalized by the API.

transaction_type

ValueDescription
PURCHASEStandard purchase transaction
AUTHORISATIONAuthorization-only (no capture)
REFUNDRefund / credit back to cardholder
REVERSALReversal of a previous transaction
CREDITOriginal credit (not related to a purchase)
CASH_ADVANCECash advance / withdrawal
ATMATM withdrawal
TRANSFERMoney transfer
CHARGEBACKChargeback from issuer
REPRESENTMENTRepresentment of a chargeback
FUNDS_TRANSFERPerson-to-person or account-to-account transfer
INSTALLMENTInstallment payment

entry_mode

ValueDescriptionCard Present?
CHIPEMV chip (contact)Yes
CONTACTLESSNFC / tap-to-payYes
MAGNETIC_STRIPEMagnetic stripe swipeYes
MANUALManual card number entry at terminalYes
ECOME-commerce / onlineNo
CARD_ON_FILEStored credentials / subscriptionNo
MAIL_ORDERMail order (MOTO)No
TELEPHONE_ORDERTelephone order (MOTO)No
TOKENDevice token (Apple Pay, Google Pay)No

transaction_status

ValueDescription
NEWInitial transaction
AUTHORIZEDAuthorization approved
CHARGEDCaptured / settled
DECLINEDAuthorization declined
REVERSEDTransaction reversed
REFUNDEDRefund processed
CHARGEDBACKChargeback received
CREDITEDCredit applied
PREPAREDPre-authorization / hold
FRAUDFlagged as fraudulent
REJECTEDRejected by processor
ERRORProcessing error

options.mode

ValueDescription
allCalculate scheme fees + interchange (default)
schemeScheme fees + fixed fees only
interchangeInterchange only

Region Scope (response only)

ValueDescription
DOMESTICIssuer and merchant in the same country
INTRA_EEABoth parties in the European Economic Area
INTRA_NON_EEASame region, one/both parties outside EEA
INTRA_REGIONALSame payment network region, different countries
INTER_REGIONALDifferent payment network regions (e.g. Europe–US)
CROSS_BORDERCross-border (generic)
BILATERALBilateral agreement between specific countries

Recivr — The intelligence layer of the payments stack.