{
"event": "TRANSACTION_CLEARED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T12:00:00Z",
"data": {
"transactionId": "txn_01HXYZ7777ABCDEF9999",
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"externalId": "my-user-id-789",
"type": "SETTLEMENT",
"status": "SETTLED",
"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_CLEARED
Fired when an authorized transaction settles. The charge is final and permanent.
WEBHOOK
TRANSACTION_CLEARED
{
"event": "TRANSACTION_CLEARED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T12:00:00Z",
"data": {
"transactionId": "txn_01HXYZ7777ABCDEF9999",
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"externalId": "my-user-id-789",
"type": "SETTLEMENT",
"status": "SETTLED",
"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
(type: PURCHASE, status: CLEARED). Still delivered to existing subscribers, so no migration is
required. New integrations should subscribe to TRANSACTION_PROCESSED.relatedTransactionId links back to the original TRANSACTION_AUTHORIZED event.
Event Type
TRANSACTION_CLEARED
Payload
{
"event": "TRANSACTION_CLEARED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T12:00:00Z",
"data": {
"transactionId": "txn_01HXYZ7777ABCDEF9999",
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"externalId": "my-user-id-789",
"type": "SETTLEMENT",
"status": "SETTLED",
"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 clearing event |
type | string | Always SETTLEMENT for this event |
status | string | Always SETTLED for this event |
amount | number | Final settled amount in dollars — may differ slightly from the authorization amount |
TRANSACTION_AUTHORIZED. See Transaction Events for the full field reference.
{
"event": "TRANSACTION_CLEARED",
"eventId": "evt_01HXY123456ABCDEF",
"businessId": "BUS1A2B3C4D5E6F",
"environment": "LIVE",
"timestamp": "2026-05-22T12:00:00Z",
"data": {
"transactionId": "txn_01HXYZ7777ABCDEF9999",
"cardId": "crd_01HXYZ5555ABCDEF1111",
"cardholderId": "chl_01HXYZ1234ABCDEF5678",
"externalId": "my-user-id-789",
"type": "SETTLEMENT",
"status": "SETTLED",
"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.