Webhook for card disbursement

July 03, 2025

Kushki can send events via webhook that notify your application when one of the following events occurs:

When a card payment is successfully sent (approvedTransaction)
When a card payment fails (declinedTransaction)

Structure

The webhooks sent by Kushki will contain the headers listed here.
Below are the possible variables included in the webhook:

Method: POST

Body: Object

Variable	Type
details.amount.currency	String
details.amount.totalAmount	Number
details.approvalCode	String \| Null (Only for approval)
details.approvedTransactionAmount	Number \| Null (Only for approval)
details.binInfo.bank	String
details.binInfo.bin	String
details.binInfo.brand	String
details.binInfo.brandProductCode	String \| Null
details.binInfo.country	String
details.binInfo.type	String
details.binInfo.prepaid	Boolean
details.created	Number (Timestamp in milliseconds)
details.merchantId	String
details.merchantName	String
details.paymentBrand	String
details.responseCode	String
details.responseText	String
details.transactionId	String
details.transactionReference	String
details.transactionStatus	String (‘APPROVAL’ o ‘DECLINED’)
details.transactionType	String (‘PAYOUT’)
ticketNumber	String \| Null (Only for approval)
transactionReference	String
code	String \| Null (Only for approval)
processorCode	String \| Null (Only for approval)
processorMessage	String \| Null (Only for approval)
message	String \| Null (Only for approval)

Examples

JSON
JSON

// Approved transaction
{
    "details": {
        "amount": {
            "currency": "PEN",
            "totalAmount": 30
        },
        "approvalCode": "NANANA",
        "approvedTransactionAmount": 30,
        "binInfo": {
            "bank": "CITIBANK (SOUTH DAKOTA), N.A.",
            "bin": "41049201",
            "brand": "VISA",
            "brandProductCode": "",
            "country": "USA",
            "type": "credit",
            "prepaid": false
        },
        "created": 1738087581164,
        "merchantId": "20000000100400157000",
        "merchantName": "ORIZABA PAYOUTS CARD BRANCH",
        "paymentBrand": "VISA",
        "responseCode": "00",
        "responseText": "Approved and completed successfully",
        "transactionId": "951738087581164005",
        "transactionReference": "c9e6c7d4-e8c2-4457-b6a6-bb6d8ac8fad1",
        "transactionStatus": "APPROVAL",
        "transactionType": "PAYOUT"
    },
    "ticketNumber": "951738087581164005",
    "transactionReference": "c9e6c7d4-e8c2-4457-b6a6-bb6d8ac8fad1"
}

// Declined transaction
{
    "code": "E557",
    "details": {
        "amount": {
            "currency": "PEN",
            "totalAmount": 30
        },
        "binInfo": {
            "bank": "bank",
            "bin": "495703",
            "brand": "VISA",
            "brandProductCode": "",
            "country": "USA",
            "type": "credit",
            "prepaid": false
        },
        "created": 1738085144614,
        "merchantId": "20000000100400157000",
        "merchantName": "ORIZABA PAYOUTS CARD BRANCH",
        "paymentBrand": "VISA",
        "processorCode": "557",
        "processorMessage": "El emisor no puede autorizar esta transacción",
        "responseCode": "57",
        "responseText": "Transaction not permitted to cardholder",
        "transactionId": "951738085144614309",
        "transactionReference": "9a4e8794-c30e-4ed7-bd45-53943fb01550",
        "transactionStatus": "DECLINED",
        "transactionType": "PAYOUT"
    },
    "message": "The issuer cannot authorize this transaction"
}