Webhook for card disbursement

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)

Product in beta version 🔐👨‍💻

We are working on our beta version. Stay tuned for its official release! You can also contact your account manager for more information.

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

// 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"
}

Webhook for card disbursement

Structure#

Examples#

Structure

Examples