This feature is coming soon. The APIs listed here are for reference only and are not yet available in production or sandbox.

cURL

curl --request POST \
  --url https://service-sandbox.tazapay.com/v3/verify/payee \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "John Doe",
    "type": "individual",
    "beneficiary_details": {
      "destination_details": {
        "type": "bank",
        "bank": {
          "account_number": "9876543210",
          "bank_codes": {
            "ifsc_code": "HDFC0001234"
          },
          "country": "IN",
          "currency": "INR"
        }
      }
    },
    "reference_id": "your-internal-ref-001"
  }'

200

{
  "status": "success",
  "message": "",
  "data": {
    "id": "ver_xxxx",
    "object": "verification",
    "verification_status": "pending",
    "status_description": "",
    "beneficiary": null,
    "beneficiary_details": {
      "type": "individual",
      "address": null,
      "phone": null,
      "tax_id": null,
      "destination": null
    },
    "destination_details": {
      "type": "bank",
      "local_payment_network": null
    },
    "verified_information": null,
    "balance": {
      "holding_currency": "USD",
      "initial_balance": 100,
      "balance_impact": 10,
      "balance_remaining": 90,
      "balance_transaction_id": "txn_xxxx"
    },
    "metadata": null,
    "reference_id": "your-internal-ref-001",
    "created_at": "2026-04-07T10:00:00Z",
    "updated_at": "2026-04-07T10:00:00Z"
  }
}

Initiate Verification

POST /v3/verify/payee Pass exactly one of beneficiary (Mode A — saved beneficiary) or beneficiary_details (Mode B — inline). Use Get Verification Metadata to determine which fields and bank codes are required for a given corridor.

Authorizations

string

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

string

required

Full name of the beneficiary (payee) to match against the account holder.

enum

required

Type of beneficiary entity. Allowed: individual, business.

string

ID of an existing saved beneficiary (bnf_xxxx). If provided, inline beneficiary fields (name, destination_details, etc.) are not required. Pass this or beneficiary_details, not both.

object

Inline payee details. Pass this or beneficiary, not both.

Show beneficiary_details

string

Email address of the beneficiary.

object

Show address

string

First line of the street address.

string

Second line of the street address.

string

City of the beneficiary.

string

State or province of the beneficiary.

string

Country of the address (ISO 3166-1 alpha-2).

string

Postal or ZIP code.

object

Show phone

string

Phone number of the beneficiary.

string

International dialing code (e.g. +91 for India).

object

required

Container object holding payout destination details.

Show destination_details

enum

required

Type of payout destination. Allowed: bank, wallet, local_payment_network.

object

Required when destination_details.type = bank.

Show bank

string

required

Bank account number of the beneficiary.

string

IBAN of the beneficiary. Required for IBAN corridors.

string

Name of the beneficiary’s bank.

string

Name or identifier of the bank branch.

string

required

Country where the bank account is held (ISO 3166-1 alpha-2).

string

required

Currency of the bank account (ISO 4217).

object

Container for bank routing identifiers. Which codes are required depends on the corridor — use Get Verification Metadata to check.

Show bank_codes

string

SWIFT/BIC code of the bank.

string

IFSC code for Indian bank accounts.

string

ABA routing number for US bank accounts.

string

Sort code for UK bank accounts.

string

Branch-level identifier used in specific corridors where IFSC, SWIFT, or other routing codes are insufficient. Format varies by country and bank.

string

BSB code for Australian bank accounts.

string

Bank code used in specific corridors.

string

CNAPS code for Chinese bank accounts.

string

Type of bank account (e.g. savings, current, checking).

object

Required when destination_details.type = local_payment_network.

Show local_payment_network

string

Type of local payment network (e.g. upi_inr, pix_brl, promptpay_thb).

string

Deposit key for the network (e.g. UPI handle, PIX key).

string

Type of deposit key. Conditionally required depending on network type.

string

Tax identification number of the beneficiary.

string

Name of the beneficiary in local language or script.

object

Additional key-value data. Max 10 keys; string values ≤ 500 chars each.

string

Reference ID of the verification on your system. Echoed in the response.

Response

string

Unique identifier for the verification object. Prefix: ver_.

string

Fixed value: verification.

enum

Current status of the verification. Allowed: valid, invalid, pending, not_supported.

string

Human-readable description of the verification status.

string

ID of the saved beneficiary used (bnf_xxxx). null for inline (Mode B) verifications.

object

Echo of the beneficiary details submitted in the request or retrieved from the saved beneficiary object.

Show beneficiary_details

string

Type of beneficiary entity (individual or business).

object

Show address

string

City of the beneficiary.

string

Country of the beneficiary (ISO 3166-1 alpha-2).

string

First line of the street address.

string

Second line of the street address.

string

Postal or ZIP code.

string

State or province of the beneficiary.

object

Show phone

string

International dialing code (e.g. +91 for India).

string

Phone number of the beneficiary.

string

Tax identification number of the beneficiary.

string

ID of the destination object associated with this beneficiary. null if inline destination_details were passed.

object

Destination details echoed from the request.

Show destination_details

string

Type of payout destination (e.g. bank, local_payment_network).

object

Present when destination_details.type = local_payment_network.

Show local_payment_network

string

Type of local payment network (e.g. pix_brl, upi_inr).

string

Deposit key for the network.

string

Type of deposit key.

object

Provider-returned verification result. Present when verification_status.status = valid.

Show verified_information

object

Show name_match_details

string

Scoring methodology used by the provider (e.g. continuous, discrete).

float

Normalised confidence score from 0 to 1 as returned by the provider.

enum

Tazapay normalised match classification. Allowed: strong_match, partial_match, no_match.

string

Translation of the matched name in local script, if available.

string

Corrected or suggested name returned by the provider where a close but imperfect match was found.

boolean

Indicates whether the account was found and recognised at the bank.

string

Whether the account belongs to an individual or business.

object

Show bank

string

Bank account number of the beneficiary.

string

Type of bank account (e.g. savings, current, checking).

object

Show bank_codes

string

SWIFT/BIC code of the bank.

string

IFSC code of the bank.

string

ABA routing number of the bank.

string

Sort code of the bank.

string

Branch code of the bank.

string

BSB code of the bank.

string

Bank code of the bank.

string

CNAPS code of the bank.

string

Name of the beneficiary’s bank.

string

Name or identifier of the bank branch.

string

Address of the beneficiary’s bank as returned by the provider.

string

Country where the bank account is held (ISO 3166-1 alpha-2).

string

Currency of the bank account (ISO 4217).

string

Payment schemes the account is eligible for. Applicable to IBAN corridors only (e.g. SEPA Credit Transfer, SEPA Instant).

object

Transaction activity details returned by the provider (Kinexys only).

Show transaction_activity_details

boolean

Indicates whether recent transaction activity was detected on the account.

date

Date from which transaction activity was checked.

object

Balance snapshot at the time of this verification.

Show balance

string

Currency from which the merchant is charged for this verification. Either USD or the merchant’s primary currency, depending on which is utilised.

integer

Balance of the holding currency before this deduction.

integer

Amount consumed for this verification.

integer

Balance of the holding currency remaining after this deduction.

string

Transaction ID of the balance debit entry.

object

Key-value map of merchant-defined metadata. Echoed from the request if provided. Max 10 keys; string values ≤ 500 chars each.

string

Your reference ID echoed from the request.

timestamp

Timestamp when the verification object was created.

timestamp

Timestamp of the last status update.

API Overview

Tazapay API

JavaScript SDK

Appendix

Create Verification

Initiate Verification

Authorizations

Body

Response

​Initiate Verification

​Authorizations

​Body

​Response

Initiate Verification

Authorizations

Body

Response