Transaction Object

You can expect the below object when you register a webhook for the following events:

• card_transaction.create

---

Raw sample

JSON

{
  "kind": "purchase",
  "merchant_name_formatted": "ACQUIRER NAME",
  "amount_currency": "AED",
  "billing_amount_currency": "AED",
  "status": "success",
  "card_last4": "3143",
  "id": "CTX-3D15615361",
  "merchant_name": null,
  "amount": 150.0,
  "billing_amount": 150.0,
  "card_name": "Phu's card test",
  "card_holder_name": "Tola Test",
  "created_at": "08 Aug 2025, 11:25AM",
  "updated_at": "08 Aug 2025, 11:25AM",
  "expense": {
    "status": "pending_review",
    "description": "Expense submitted via Whatsapp",
    "invoice_number": null,
    "id": "EXP-C88EA7F9D3",
    "category": "Visa",
    "tax_code": null,
    "payment_account": null,
    "expense_account": null,
    "vendor": null,
    "receipt_uploaded": false,
    "created_at": "08 Aug 2025, 11:25AM",
    "updated_at": "08 Aug 2025, 12:00PM"
  },
  "event_type": "card_transaction.create"
}

Field Descriptions

Field	Type	Description
kind	String	Transaction type (purchase-refund-withdrawal)
merchant_name_formatted	String	Formatted merchant name
amount_currency	String	Transaction currency
billing_amount_currency	String	Billing currency
status	String	Transaction status (success-declined-pending)
card_last4	String	Last 4 digits of the card
id	String	Transaction ID
merchant_name	String	Raw merchant name
amount	Number	Transaction amount
billing_amount	Number	Billing amount
card_name	String	Card name/label
card_holder_name	String	Card holder name
created_at	String	Transaction creation date
updated_at	String	Transaction last update date
expense	Object	Associated expense details
expense.status	String	Expense status (incomplete-pending_review-ready-synced)
expense.description	String	Expense description
expense.invoice_number	String	Invoice number
expense.id	String	Expense ID
expense.category	String	Expense category
expense.tax_code	String	Tax code
expense.payment_account	String	Payment account
expense.expense_account	String	Expense account
expense.vendor	String	Vendor information
expense.receipt_uploaded	Boolean	Whether receipt is uploaded
expense.created_at	String	Expense creation date
expense.updated_at	String	Expense last update date
event_type	String	Corresponding Webhook Event