Saltar al contenido principal
Tipo de evento: card.transaction.created · .completed · .updated · .refund 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 .refund. Ver Resumen de webhooks para entrega, headers y verificación de firma.

​
Campos de data

​
customerId
string
El identificador del customer.
​
cardId
string
El identificador de la tarjeta.
​
providerCardId
string
El identificador de la tarjeta en el partner emisor.
​
transactionId
string
El identificador de la transacción en el partner emisor (campo rainTransactionId).
​
action
string
La acción de la transacción que disparó el evento.
​
transactionType
string
Tipo de transacción (por ejemplo, spend, payment, collateral).
​
status
string
Estado de la transacción: pending, approved, declined, reversed o settled.
​
isRefund
boolean
Indica si la transacción es un reembolso.
​
amount
number
Monto de la transacción en la moneda de la tarjeta.
​
currency
string
Moneda de la tarjeta.
​
localAmount
number
Monto en la moneda local (unidades mínimas).
​
localCurrency
string
Moneda local.
​
merchantName
string
Nombre del comercio. También se incluyen otros campos del comercio (merchantId, merchantCategory, merchantCategoryCode y variantes enriquecidas).
​
authorizedAt
string | null
Marca de tiempo de autorización (ISO 8601).
​
postedAt
string | null
Marca de tiempo de registro (ISO 8601).
​
lastEventAt
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": {
    "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"
  }
}