Sample Payload - Virtual Bank Events

Postback Event & Response

Following is the list of currently available postback events

Events

Description

virtual_bank.transaction.successful

The transaction was successful

virtual_bank.transaction.failed

The 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": "[email protected]",
                    "@entity": "payer"
                },
                "payee": {
                    "name": "Quicko Infosoft Pvt. Ltd.",
                    "upi_id": "[email protected]",
                    "@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": "[email protected]",
                    "@entity": "payer"
                },
                "payee": {
                    "name": "Quicko Infosoft Pvt. Ltd.",
                    "upi_id": "[email protected]",
                    "@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 encrypt your payload. Click here to learn more


Did this page help you?