v2

latestOpenAPI 3.1.0Proprietary2026-07-261022123.6 KB

Terminal session failure event

Sent when a terminal session has been completed unsuccessfully (status is failure).

postWebhookterminal-session.failure

Payload

idstring

The unique identifier for this webhook event.

type'terminal-session.failure'

The type of webhook event.

createdAtstring

The UTC timestamp indicating when the webhook event was created. Formatted as an ISO 8601 string (e.g., 2024-01-15T09:30:00Z).

Example payload

{
  "data": {
    "outcome": {
      "charge": {
        "card": {
          "id": "card_1234567890",
          "bin": "42424242",
          "last4": "4242",
          "expiry": {
            "month": "12",
            "year": "29"
          },
          "network": "visa",
          "fundingType": "debit",
          "issuer": {
            "name": "standard bank",
            "country": "ZA"
          }
        },
        "failure": {
          "resultCode": {
            "value": "05",
            "descriptor": "do_not_honour",
            "detail": "Do Not Honour indicates that the card issuer declined the transaction without providing a specific reason. The cardholder should contact their bank for more information."
          }
        }
      }
    }
  }
}

Response

Webhook received successfully