{
  "id": "txn_t73AdHRFYwhT9",
  "account_id": "acc_XtKTpHLGhD9Qn",
  "status": "posted",
  "descriptor": "SQ *BENNU COFFEE",
  "amount": 3764,
  "auth_amount": 3764,
  "currency_code": "USD",
  "transaction_amount": 3764,
  "transaction_auth_amount": 3764,
  "transaction_currency_code": "USD",
  "transacted_at": "2025-03-05T07:48:06.000Z",
  "posted_at": "2025-03-06T05:00:00.000Z",
  "voided_at": null,
  "original_txn_id": null,
  "created_at": "2025-03-24T03:54:29.283Z",
  "updated_at": "2025-03-24T04:04:39.200Z"
}

The Transactions endpoint retrieves near real-time transaction notifications for Credit Card and Debit Card Accounts directly from the card networks.

Account verification (AVF) & subscription to Transactions is required before receiving transactional data for an account.

The Transactions endpoint is available as a:

TypeUse-Case
SubscriptionNear real-time transaction notifications for Credit / Debit Card Accounts

​
Transaction Objects

​
id
string

Unique identifier for the Transaction.

​
account_id
string

The ID of the associated Account.

​
descriptor
string

The statement descriptor for the transaction. This field may change across webhook events and is fully accurate only when the transaction reaches a final state (Posted or Voided).

​
amount
number

The amount that was charged in USD cents.

​
auth_amount
number

The authorization amount that was charged in USD cents.

​
currency_code
string

The ISO 4217 currency code for the amount and auth_amount.

​
transaction_amount
number

The amount that was charged in the local currency of the transaction in cents.

​
transaction_auth_amount
number

The authorization amount that was charged in the local currency of the transaction in cents.

​
transaction_currency_code
string

The ISO 4217 currency code for the transaction_amount and transaction_auth_amount.

​
status
enum

The current status of the Transaction. Returns have the status posted with a negative value for amount and transaction_amount. One of pending, posted or voided

​
transacted_at
string

Timestamp when the transaction took place.

​
posted_at
string | null

Timestamp when the transaction was posted, null if it never posted

​
voided_at
string | null

Timestamp when the transaction was voided, null if it never voided.

​
original_txn_id
string | null

If this transaction is a return (posted with a negative value for amount), this field contains the ID of the original transaction. Otherwise, it is null.

​
created_at
string

Timestamp of when the Transaction was created.

​
updated_at
string

Timestamp of when the Transaction was last updated.

​
Webhook Payload

The Webhook payload will contain the following information:

{
  "id": "string",
  "type": "transaction.create" | "transaction.update",
  "path": "/accounts/<acc_id>/transactions/<txn_id>",
}