Account Validation Sample Payloads

We support webhook notifications for the following events:

fund_account.validation.completed

Bank Account and VPA

Triggered whenever an account validation transaction is completed.

fund_account.validation.failed

Bank Account and VPA

Triggered whenever an account validation transaction fails.

fund_account.validation.completed

This webhook is triggered whenever an account validation transaction is completed.

This webhook is available for both bank account and VPA validation.

{
  "entity": "event",
  "account_id": "acc_BfVUrG6tDiL7H0",
  "event": "fund_account.validation.completed",
  "contains": [
    "fund_account.validation"
  ],
  "payload": {
    "fund_account.validation": {
      "entity": {
        "id": "fav_Fa6RwlxjoX0xeO",
        "entity": "fund_account.validation",
        "fund_account": {
          "id": "fa_Fa6Rq1WwNrpMoK",
          "entity": "fund_account",
          "contact_id": "cont_FYSVUV5EeJKkKb",
          "account_type": "bank_account",
          "bank_account": {
            "name": "Gaurav Kumar",
            "bank_name": "HDFC",
            "ifsc": "HDFC0000053",
            "account_number": "1121431121541121"
          },
          "batch_id": null,
          "active": true,
          "created_at": 1599473652
        },
        "status": "completed",
        "amount": 127,
        "currency": "INR",
        "notes": {
          "random_key_1": "Make it so.",
          "random_key_2": "Tea. Earl Grey. Hot."
        },
        "results": {
          "account_status": "active",
          "registered_name": "Gaurav Kumar"
        },
        "created_at": 1599473659,
        "utr": "XXXXR7310682908954385XX"
      }
    }
  },
  "created_at": 1599473661
}

fund_account.validation.failed

This webhook is triggered whenever an account validation transaction fails.

Handy Tips

This webhook is available only for bank account validation. It is not available for VPA validation.

{
  "entity": "event",
  "account_id": "acc_BfVUrG6tDiL7H0",
  "event": "fund_account.validation.failed",
  "contains": [
    "fund_account.validation"
  ],
  "payload": {
    "fund_account.validation": {
      "entity": {
        "id": "fav_Fa6RwlxjoX0xeO",
        "entity": "fund_account.validation",
        "fund_account": {
          "id": "fa_Fa6Rq1WwNrpMoK",
          "entity": "fund_account",
          "contact_id": "cont_FYSVUV5EeJKkKb",
          "account_type": "bank_account",
          "bank_account": {
            "name": "Gaurav Kumar",
            "bank_name": "HDFC",
            "ifsc": "HDFC0000053",
            "account_number": "1121431121541121"
          },
          "batch_id": null,
          "active": true,
          "created_at": 1599652242
        },
        "status": "failed",
        "amount": 127,
        "currency": "INR",
        "notes": {
          "random_key_1": "Make it so.",
          "random_key_2": "Tea. Earl Grey. Hot."
        },
        "results": {
          "account_status": null
          "registered_name": null
        },
        "created_at": 1599473659,
        "utr": null
      }
    }
  },
  "created_at": 1599473661
}

Account Validation Payloads

fund_account.validation.completed

fund_account.validation.failed