Skip to main content
WEBHOOK
payment.attempt_failed
{
  "id": "evt_81239839123",
  "type": "payment.attempt_failed",
  "data": {
    "id": "pay_123123123",
    "status": "draft",
    "amount": 300,
    "currency": "ZAR",
    "country": "ZA",
    "external_reference": "order_id_2331120",
    "payment_method_details": {
      "type": "card",
      "card": {
        "type": "credit",
        "scheme": "mastercard",
        "bin": "527346",
        "last4": "3333"
      }
    },
    "last_payment_error": {
      "error_code": "card_declined",
      "decline_code": "generic_decline",
      "message": "The request attempted to process a payment, but an error occurred during card processing.",
      "timestamp": "2025-01-30T10:56:08.727Z"
    },
    "metadata": {
      "order_id": "o_b5MuE6le7p9W5Ufsf8tQk"
    },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}

Authorizations

​
Authorization
string
header
required

The public key (pk_test_TYooMQauvdEDq54NiTt6F5zVxjGmZcjdZa) or secret key (sk_test_4eC39HqLyjWDarjtT1zdp7dc) used for making authenticated calls to the API.

Body

application/json

Event payload for payment lifecycle webhooks.

​
id
string
required

Unique identifier for the event.

​
type
enum<string>
required

Type of event being emitted.

Available options:
payment.succeeded,
payment.attempt_failed
​
data
object
required

Payment data associated with the event.