Card transaction object - Nadcab Labs API

The card transaction object is the data payload of the CardTransaction webhook. If your server misses a webhook, fetch the same records with List card transactions.

Fields

Field	Type	Description
`id`	string	Transaction ID
`type`	string	Transaction type, see below
`transaction_time`	string	Transaction time
`card_id`	string	Card ID
`card_no`	string	Card number
`amount`	number	Amount in the card currency
`fee`	number	Fee
`currency`	string	Card currency
`order_amount`	number	Amount in the merchant currency
`order_currency`	string	Merchant currency
`status`	string	Status
`detail`	string	Merchant or transaction details
`mcc`	string	Merchant category code
`client_transaction_id`	string	Your reference, if you sent one
`remark`	string	Decline or processing remark, see below
`merchant_country`	string	Merchant country
`related_card_transaction_id`	string	Related transaction ID
`finished_at`	string	Completed at

Example

{
  "id": "f46c1d15-4da8-4086-9a7a-db1293f04cd8",
  "transaction_time": "2024-12-06 20:39:42",
  "client_transaction_id": "0161fdd4-a6a5-4f95-a99d-7ad903dec11c",
  "card_id": "CA2412062040258",
  "card_no": "4931930100587405",
  "currency": "USD",
  "amount": 10,
  "order_currency": "USD",
  "order_amount": 10,
  "fee": 0,
  "type": "TransferIn",
  "detail": "",
  "status": "Closed",
  "remark": "",
  "merchant_country": "",
  "related_card_transaction_id": ""
}

Transaction types

Type	Description
`Create`	Card created
`Destroy`	Card closed
`TransferOut`	Withdrawal from card
`TransferIn`	Top-up to card
`Consumption`	Purchase
`Reversal`	Reversal
`Credit`	Refund
`Fee_Consumption`	Authorization fee
`Suspend`	Card frozen
`Enable`	Card unfrozen
`Frozen`	Card funds frozen
`UnFrozen`	Card funds unfrozen
`Penalty`	Chargeback penalty
`Verification`	Verification
`Settlement`	Card settlement

Remarks

Remark	Meaning
`Exceeds withdrawal amount limit`	The amount is above the card limit
`No sufficient funds`	Not enough balance on the card; top it up
`Unauthorized platform enforced deductions`	Unauthorized forced deduction by a merchant
`Card is not active`	The card is not in an active state
`Wrong exp.date`	Wrong expiry date entered
`Invalid Expiry Date`	The card has expired
`Isocountry not allowed`	Purchases are not allowed in the merchant’s country
`MCC not allowed`	The merchant category is not allowed
`Unauthroized MCC`	The merchant category is not authorized
`Reversal Transaction`	The authorization was reversed