> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nadcab.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Card transaction object

> Fields, types and decline remarks for card transactions.

The card transaction object is the `data` payload of the `CardTransaction` [webhook](/guides/webhooks). If your server misses a webhook, fetch the same records with [List card transactions](/api-reference/cards/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

```json theme={null}
{
  "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 |