Transacciones de tarjeta

{
  "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"
  }
}

Tipo de evento: card.transaction.created · .completed · .updated · .refunded Se envía con cada actualización de una transacción de tarjeta. El sufijo del type refleja la acción: card.transaction.created, .completed, .updated o .refunded. Ver Resumen de webhooks para entrega, headers y verificación de firma.

card.transaction.refunded reemplaza al evento card.transaction.refund (deprecado). Durante la migración se entregan ambos nombres de reembolso en paralelo —card.transaction.refunded (nuevo) y card.transaction.refund (heredado)—. card.transaction.refund está deprecado y se eliminará el 15 de noviembre de 2026; cambia a card.transaction.refunded antes de esa fecha.

Campos de `data`

string

Identificador estable de este evento de transacción. Para reembolsos, el mismo valor se envía en el card.transaction.refund heredado durante la transición — úsalo para deduplicar los dos nombres.

string

El identificador del customer.

string

El identificador de la tarjeta.

string

El identificador de la tarjeta en el partner emisor.

string

El identificador de la transacción en el partner emisor (campo rainTransactionId).

string

La acción de la transacción que disparó el evento.

string

Tipo de transacción (por ejemplo, spend, payment, collateral).

string

Estado de la transacción: pending, approved, declined, reversed o settled.

boolean

Indica si la transacción es un reembolso.

number

Monto de la transacción en la moneda de la tarjeta.

string

Moneda de la tarjeta.

number

Monto en la moneda local (unidades mínimas).

string

Moneda local.

string

Nombre del comercio. También se incluyen otros campos del comercio (merchantId, merchantCategory, merchantCategoryCode y variantes enriquecidas).

string | null

Marca de tiempo de autorización (ISO 8601).

string | null

Marca de tiempo de registro (ISO 8601).

string

Marca de tiempo del último evento de la transacción (ISO 8601).

{
  "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"
  }
}

Documentación de la API

Saldos

Cotizaciones

Payouts

Payins

Tarjetas

Webhooks

Transacciones de tarjeta

Campos de `data`

​Campos de data

Campos de `data`