{
"event": "card.transaction.reversed",
"version": "3.0",
"eventId": "e1f2a3b4-c5d6-7890-4567-89abcdef0123",
"sign": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
"data": {
"cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
"cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
"reference": "hos_rv_a4e8f2b6_20260510143202",
"originalReference": "hos_tx_a4e8f2b6_20260510143200",
"type": "CREDIT",
"amount": 49.99,
"currency": "USD",
"merchant": {
"name": "AMAZON MARKETPLACE",
"country": "US",
"mcc": "5999"
},
"category": "Reversal",
"network": "VISA",
"authorizationCode": "AUTH123",
"status": "REVERSED",
"appId": "A1B2C3D4E5F6G7H8",
"timestamp": "2026-05-10T14:32:02Z"
}
}
{}
Cards
Card Transaction Reversed
Sent when a previously approved card authorization is voided or reversed by the merchant.
WEBHOOK
card.transaction.reversed
{
"event": "card.transaction.reversed",
"version": "3.0",
"eventId": "e1f2a3b4-c5d6-7890-4567-89abcdef0123",
"sign": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
"data": {
"cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
"cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
"reference": "hos_rv_a4e8f2b6_20260510143202",
"originalReference": "hos_tx_a4e8f2b6_20260510143200",
"type": "CREDIT",
"amount": 49.99,
"currency": "USD",
"merchant": {
"name": "AMAZON MARKETPLACE",
"country": "US",
"mcc": "5999"
},
"category": "Reversal",
"network": "VISA",
"authorizationCode": "AUTH123",
"status": "REVERSED",
"appId": "A1B2C3D4E5F6G7H8",
"timestamp": "2026-05-10T14:32:02Z"
}
}
{}
{
"event": "card.transaction.reversed",
"version": "3.0",
"eventId": "e1f2a3b4-c5d6-7890-4567-89abcdef0123",
"sign": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
"data": {
"cardId": "a4e8f2b6c9d1e3f7a2b5c8d0e4f1a3b6c9d2e5f8a1b4c7d0e3",
"cardholderId": "8f4e2a1b3c5d7e9f0a2b4c6d8e0f1a3b5c7d",
"reference": "hos_rv_a4e8f2b6_20260510143202",
"originalReference": "hos_tx_a4e8f2b6_20260510143200",
"type": "CREDIT",
"amount": 49.99,
"currency": "USD",
"merchant": {
"name": "AMAZON MARKETPLACE",
"country": "US",
"mcc": "5999"
},
"category": "Reversal",
"network": "VISA",
"authorizationCode": "AUTH123",
"status": "REVERSED",
"appId": "A1B2C3D4E5F6G7H8",
"timestamp": "2026-05-10T14:32:02Z"
}
}
{}
Payload Fields
| Field | Type | Description |
|---|---|---|
cardId | string | Your card identifier |
cardholderId | string | Cardholder identifier |
reference | string | null | Unique reversal transaction reference |
originalReference | string | null | Reference of the original charge being reversed |
type | string | Always "CREDIT" (funds returned to the card) |
amount | number | Reversed amount |
currency | string | Currency code (e.g., "USD") |
merchant.name | string | Merchant name |
merchant.country | string | null | Merchant country code |
merchant.mcc | string | null | Merchant category code |
category | string | Always "Reversal" |
network | string | null | Card network (e.g., "VISA", "MASTERCARD") |
authorizationCode | string | null | Authorization code from the original charge |
status | string | Always "REVERSED" |
Body
application/json
Response
200
Acknowledge receipt of the event
⌘I