{
"event": "TRANSACTION_REVERSED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T14:00:00Z",
"data": {
"transactionId": "txn_01HXYZ6666ABCDEF9999",
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"externalId": "my-user-id-789",
"type": "REVERSAL",
"status": "REVERSED",
"amount": 29.99,
"currency": "USD",
"billingAmount": 29.99,
"billingCurrency": "USD",
"merchant": {
"name": "Amazon",
"id": "AMZN_MERCHANT_001",
"city": "Seattle",
"country": "US",
"mcc": "5999",
"mccDescription": "Miscellaneous General Merchandise"
}
}
}
{}
Transaction Events
TRANSACTION_REVERSED
Fired when a transaction is reversed or a merchant refund is received. Funds are returned to the card.
WEBHOOK
TRANSACTION_REVERSED
{
"event": "TRANSACTION_REVERSED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T14:00:00Z",
"data": {
"transactionId": "txn_01HXYZ6666ABCDEF9999",
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"externalId": "my-user-id-789",
"type": "REVERSAL",
"status": "REVERSED",
"amount": 29.99,
"currency": "USD",
"billingAmount": 29.99,
"billingCurrency": "USD",
"merchant": {
"name": "Amazon",
"id": "AMZN_MERCHANT_001",
"city": "Seattle",
"country": "US",
"mcc": "5999",
"mccDescription": "Miscellaneous General Merchandise"
}
}
}
{}
Deprecated — superseded by
TRANSACTION_PROCESSED
(status: REVERSED). Still delivered to existing subscribers, so no migration is
required. New integrations should subscribe to TRANSACTION_PROCESSED.- Pre-settlement reversal: An authorization is voided before it clears — the reserved funds are released back to the card.
- Post-settlement refund: A merchant issues a refund after the transaction has cleared — funds are credited back to the card.
Event Type
TRANSACTION_REVERSED
Payload
{
"event": "TRANSACTION_REVERSED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T14:00:00Z",
"data": {
"transactionId": "txn_01HXYZ6666ABCDEF9999",
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"externalId": "my-user-id-789",
"type": "REVERSAL",
"status": "REVERSED",
"amount": 29.99,
"currency": "USD",
"billingAmount": 29.99,
"billingCurrency": "USD",
"merchant": {
"name": "Amazon",
"id": "AMZN_MERCHANT_001",
"city": "Seattle",
"country": "US",
"mcc": "5999",
"mccDescription": "Miscellaneous General Merchandise"
}
}
}
Payload Fields
| Field | Type | Description |
|---|---|---|
transactionId | string | Unique transaction ID for this reversal event |
type | string | Always REVERSAL for this event |
status | string | Always REVERSED for this event |
amount | number | Amount reversed and returned to the card, in dollars |
TRANSACTION_AUTHORIZED. See Transaction Events for the full field reference.
{
"event": "TRANSACTION_REVERSED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T14:00:00Z",
"data": {
"transactionId": "txn_01HXYZ6666ABCDEF9999",
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"externalId": "my-user-id-789",
"type": "REVERSAL",
"status": "REVERSED",
"amount": 29.99,
"currency": "USD",
"billingAmount": 29.99,
"billingCurrency": "USD",
"merchant": {
"name": "Amazon",
"id": "AMZN_MERCHANT_001",
"city": "Seattle",
"country": "US",
"mcc": "5999",
"mccDescription": "Miscellaneous General Merchandise"
}
}
}
{}
Authorizations
API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.
Body
application/json
Response
200
Acknowledge the event.