Postback Sample Payload - Virtual Bank Events

Postback Event & Response

Following is the list of currently available postback events for virtual bank account transactions

EventsDescription
virtual_bank.transaction.successfulThe transaction was successful
virtual_bank.transaction.failedThe transaction failed, the reason for which will be mentioned in the response.

Event - virtual_bank.transaction.successful

{
        "@entity": "event",
        "name": "virtual_bank.transaction.successful",
        "group": "virtual_bank",
        "email": "[email protected]",
        "subscription_id": "sub_XXXXXXXXXXXXXX",
        "api_key": "key_live_AzsNcevVFkYEXXXXXXXXXX",
        "payload": {
            "virtual_account_number": "HEY00000XXXXX",
            "transaction": {
                "@entity": "transaction",
                "id": "bda7e1fb-1315-4774-ae76-XXXXXXXXXXXX",
                "payer": {
                    "name": "John Doe ",
                    "upi_id": "123456789@UPI",
                    "@entity": "payer"
                },
                "payee": {
                    "name": "Quicko Infosoft Pvt. Ltd.",
                    "upi_id": "hiquicko@icici",
                    "@entity": "payee",
                    "bank_account": {
                        "ifsc": "ICIC0000103",
                        "account_number": "HEY00000XXXXX",
                        "@entity": "bank_account"
                    }
                },
                "amount": 10,
                "status": "Successful",
                "mode": "UPI",
                "type": "Credit",
                "bank_transaction_id": "2165794XXXXX",
                "description": "tax payment for John Doe",
                "notes": {
                    "key1": "value",
                    "key2": "value",
                },
                "updated_at": 1655219708771,
                "created_at": 1655219650514
            },
            "closing_balance": 13.05
        },
        "timestamp": 1655219720532
    },

Event - virtual_bank.transaction.failed

{
        "@entity": "event",
        "name": "virtual_bank.transaction.failed",
        "group": "virtual_bank",
        "email": "[email protected]",
        "subscription_id": "sub_XXXXXXXXXXXXXX",
        "api_key": "key_live_AzsNcevVFkYEXXXXXXXXXX",
        "payload": {
            "virtual_account_number": "HEY00000XXXXX",
            "transaction": {
                "@entity": "transaction",
                "id": "bda7e1fb-1315-4774-ae76-XXXXXXXXXXXX",
                "payer": {
                    "name": "John Doe ",
                    "upi_id": "123456789@UPI",
                    "@entity": "payer"
                },
                "payee": {
                    "name": "Quicko Infosoft Pvt. Ltd.",
                    "upi_id": "hiquicko@icici",
                    "@entity": "payee",
                    "bank_account": {
                        "ifsc": "ICIC0000103",
                        "account_number": "HEY00000XXXXX",
                        "@entity": "bank_account"
                    }
                },
                "amount": 10,
                "status": "Failed",
                "failure_reason": "CANCELED"
                "mode": "UPI",
                "type": "Credit",
                "description": "tax payment for John Doe",
                "notes": {
                    "key1": "value",
                    "key2": "value",
                },
                "updated_at": 1655219708771,
                "created_at": 1655219650514
            },
            "closing_balance": 13.05
        },
        "timestamp": 1655219720532
    },

❗️

Avoid Malicious Callbacks

We recommend that you set your secret when configuring Postbacks to avoid such dangers and to validate your payload using signature.Click here to learn more