Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sudo.africa/llms.txt

Use this file to discover all available pages before exploring further.

This webhook request is triggered whenever an attempt to charge a card fails. The event type is authorization.decline

​
Request Payload

{
    "type": "authorization.declined",
    "environment": "production",
    "business": "xxxxxxxxxxxxx",
    "_id": "xxxxxxxxxxxxx",
    "data": {
        "object": {
            "business": "xxxxxxxxxxxxx",
            "customer": "xxxxxxxxxxxxx",
            "account": "xxxxxxxxxxxxx",
            "card": "xxxxxxxxxxxxx",
            "amount": -25.49,
            "fee": 0,
            "vat": 0,
            "approved": false,
            "currency": "USD",
            "status": "pending",
            "authorizationMethod": "online",
            "balanceTransactions": [],
            "merchantAmount": -25.49,
            "merchantCurrency": "USD",
            "merchant": {},
            "terminal": {},
            "transactionMetadata": {},
            "pendingRequest": null,
            "requestHistory": [{
                "amount": 25.49,
                "currency": "USD",
                "approved": false,
                "merchantAmount": 25.49,
                "merchantCurrency": "USD",
                "reason": "not_allowed",
                "narration": "No sufficient funds",
                "createdAt": "2024-05-20T13:40:25.079Z",
                "_id": "664b52c9c05d4a5d3f8cc734"
            }],
            "verification": {},
            "isDeleted": false,
            "createdAt": "2024-05-20T13:40:25.079Z",
            "updatedAt": "2024-05-20T13:40:25.079Z",
            "_id": "664b52c9c05d4a5d3f8cc730",
            "feeDetails": [],
            "__v": 0
        },
        "_id": "664b52c9c05d4a5d3f8cc740"
    }
}