Card transactions

{
  "type": "card.transaction.completed",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "eventId": "card:tx_9f86d081:completed:settled",
    "customerId": "cus_3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
    "cardId": "card_abc123",
    "providerCardId": "card_abc123",
    "rainTransactionId": "tx_9f86d081",
    "action": "completed",
    "transactionType": "spend",
    "status": "settled",
    "isRefund": false,
    "amount": 25.5,
    "currency": "USD",
    "localAmount": 102000,
    "localCurrency": "COP",
    "merchantName": "Netflix",
    "merchantCategoryCode": "5968",
    "authorizedAt": "2026-06-23T11:59:50.000Z",
    "postedAt": "2026-06-23T12:00:00.000Z",
    "lastEventAt": "2026-06-23T12:00:00.000Z"
  }
}

Event type: card.transaction.created · .completed · .updated · .refunded Sent on each card transaction update. The type suffix reflects the action: card.transaction.created, .completed, .updated, or .refunded. See Webhooks overview for delivery, headers, and signature verification.

card.transaction.refunded replaces the deprecated card.transaction.refund. During the migration, both refund names are delivered in parallel — card.transaction.refunded (new) and card.transaction.refund (legacy). card.transaction.refund is deprecated and will be removed on 15 November 2026; switch to card.transaction.refunded before then.

`data` fields

string

Stable identifier for this transaction event. For refunds, the same value is sent on the legacy card.transaction.refund during the transition — use it to deduplicate the two names.

string

The customer identifier.

string

The card identifier.

string

The card identifier at the issuing partner.

string

The transaction identifier at the issuing partner (field name rainTransactionId).

string

The transaction action that triggered the event.

string

Transaction type (e.g. spend, payment, collateral).

string

Transaction status: pending, approved, declined, reversed, or settled.

boolean

Whether the transaction is a refund.

number

Transaction amount in the card currency.

string

Card currency.

number

Amount in the local currency (minor units).

string

Local currency.

string

Merchant name. Other merchant fields (merchantId, merchantCategory, merchantCategoryCode, and enriched variants) are also included.

string | null

ISO 8601 authorization timestamp.

string | null

ISO 8601 posting timestamp.

string

ISO 8601 timestamp of the latest transaction event.

{
  "type": "card.transaction.completed",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "eventId": "card:tx_9f86d081:completed:settled",
    "customerId": "cus_3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
    "cardId": "card_abc123",
    "providerCardId": "card_abc123",
    "rainTransactionId": "tx_9f86d081",
    "action": "completed",
    "transactionType": "spend",
    "status": "settled",
    "isRefund": false,
    "amount": 25.5,
    "currency": "USD",
    "localAmount": 102000,
    "localCurrency": "COP",
    "merchantName": "Netflix",
    "merchantCategoryCode": "5968",
    "authorizedAt": "2026-06-23T11:59:50.000Z",
    "postedAt": "2026-06-23T12:00:00.000Z",
    "lastEventAt": "2026-06-23T12:00:00.000Z"
  }
}

API Documentation

Guides

Balances

Quotes

Payouts

Payins

Checkout

Cards

Webhooks

Card transactions

`data` fields

​data fields

`data` fields