{
  "id": "txn_t73AdHRFYwhT9",
  "account_id": "acc_XtKTpHLGhD9Qn",
  "status": "posted",
  "descriptor": "SQ *BENNU COFFEE",
  "merchant": {
    "name": "Bennu Coffee",
    "logo": null
  },
  "merchant_category_code": "5441",
  "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.
Subscription to Transactions is required before receiving transactional data for an account. Contact your Method CSM for access.
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).
merchant_category_code
string
The 4 digit MCC associated with this transaction.
merchant
object | null
Enriched merchant information. This is not enabled by default, contact your Method CSM for access.
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>",
}
{
  "id": "txn_t73AdHRFYwhT9",
  "account_id": "acc_XtKTpHLGhD9Qn",
  "status": "posted",
  "descriptor": "SQ *BENNU COFFEE",
  "merchant": {
    "name": "Bennu Coffee",
    "logo": null
  },
  "merchant_category_code": "5441",
  "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"
}