CardTransactionCleared

📘

Part of these flows

This webhook fires in the Authorization flow and the Refund flow — it does not fire in the Reversal flow, since a reversed authorization never settles.

The Clearing webhook is triggered when a transaction clearing (e.g., settlement) is received from the payment processor. Unlike the Authorization webhook, the Clearing webhook is informational and does not require a business decision response. It finishes the payment flow and serves as the the source of truth for the transaction amounts. At the moment of clearing all the moeny movement is considering finished and holds shoud be applied or released according to information provided in amounts.

What the amount fields mean here

Each clearing item carries transactionAmount/accountAmount and a cardPaymentEvent (Settlement, Refund, Reversal, Expired, or Failed) that tells you what kind of clearing this is. The amount is the amount settled at clearing time, which is the authoritative figure for reconciliation — it may differ from the original authorization amount (smaller on a partial capture, larger on an added tip, or different due to an exchange-rate move on foreign-currency transactions). See Non-Standard Transaction Scenarios for these cases.

Sample Request Payload

{
  "event": "CardTransactionCleared",
  "userId": "fe2df68d-94fe-4d59-8660-024363c28c12",
  "clearings": [
    {
      "clearingId": "b8680001-005c-d9c5-9609-08de9a269c72",
      "cardId": "1953784f-98fe-4088-827f-85d52de7a918",
      "authorizationId": "b7680001-005c-d9c5-88c8-08de9a2699cf",
      "cardPaymentEvent": "Settlement",
      "debitOrCredit": "Debit",
      "transactionAmount": 655.18,
      "transactionCurrencyCode": "GBP",
      "accountAmount": 655.18,
      "accountCurrencyCode": "GBP",
      "createdAt": "2026-04-14T13:06:18.053Z",
      "merchantCategoryCode": "5651",
      "merchantId": "SHP000000000057",
      "merchantName": "aliexpress.com"
    },
    {
      "clearingId": "bb680001-005c-d9c5-4e36-08de9a26a57d",
      "cardId": "776731ac-063b-4bd0-8000-bb04d7dfb5d4",
      "authorizationId": "ba680001-005c-d9c5-ae57-08de9a269e59",
      "cardPaymentEvent": "Settlement",
      "debitOrCredit": "Debit",
      "transactionAmount": 557.29,
      "transactionCurrencyCode": "GBP",
      "accountAmount": 557.29,
      "accountCurrencyCode": "GBP",
      "createdAt": "2026-04-14T13:06:33.053Z",
      "merchantCategoryCode": "5651",
      "merchantId": "SHP000000000057",
      "merchantName": "aliexpress.com"
    }
  ]
}

Expected Response

For Clearing webhooks:

• The response body is not analyzed.
• Only the HTTP status code is evaluated.

Important Notes

• Clearing events are triggered only after they are received from the payment processor.
• Authorization alone does not generate a clearing event.
• Multiple clearing records may be included in a single webhook call.