This feature is coming soon. The APIs listed here are for reference only
and are not yet available in production or sandbox.
curl --request GET \
--url https://service-sandbox.tazapay.com/v3/verification/payee/ver_xxxx \
--header 'Authorization: Basic <encoded-value>'
{
"status": "success",
"message": "",
"data": {
"id": "ver_xxxx",
"object": "verification",
"verification_status": "valid",
"status_description": "",
"beneficiary": "bnf_xxxx",
"beneficiary_details": {
"type": "individual",
"address": {
"city": "Mumbai",
"country": "IN",
"line1": "123 Main Street",
"line2": null,
"postal_code": "400001",
"state": "Maharashtra"
},
"phone": {
"calling_code": "+91",
"number": "9876543210"
},
"tax_id": null,
"destination": "bnk_xxxx"
},
"destination_details": {
"type": "bank",
"local_payment_network": null
},
"verified_information": {
"name_match_details": {
"type": "continuous",
"value": 0.97,
"summary": "strong_match",
"matched_name_translation": null,
"corrected_name_returned": null
},
"account_exists": true,
"beneficiary_type": "individual",
"bank": {
"account_number": "9876543210",
"account_type": "savings",
"bank_codes": {
"ifsc_code": "HDFC0001234"
},
"bank_name": "HDFC Bank",
"branch_name": null,
"address": null,
"country": "IN",
"currency": "INR",
"payment_scheme_eligibility": null
},
"transaction_activity_details": {
"transaction_activity": null,
"transaction_activity_since": null
}
},
"balance": {
"holding_currency": "USD",
"balance_impact": 10,
"balance_transaction_id": "txn_xxxx"
},
"metadata": null,
"reference_id": null,
"created_at": "2026-04-07T10:00:00Z",
"updated_at": "2026-04-07T10:00:05Z"
}
}
Retrieve Verification
GET /v3/verification/payee/{id}
Authorizations
Basic authentication header of the form Basic <encoded-value>, where
<encoded-value> is the base64-encoded string username:password.
Path Parameters
Unique ID of the verification object. Prefix: ver_.
Response
Unique identifier for the verification object. Prefix: ver_.
Fixed value: verification.
Current status of the verification. Allowed: valid, invalid.
Human-readable description of the verification status.
ID of the saved beneficiary used (bnf_xxxx). null for inline
verifications.
Echo of the beneficiary details submitted in the original request or
retrieved from the saved beneficiary object.
Type of beneficiary entity (individual or business).
Country of the beneficiary (ISO 3166-1 alpha-2).
First line of the street address.
Second line of the street address.
State or province of the beneficiary.
International dialing code (e.g. +91 for India).
Phone number of the beneficiary.
Tax identification number of the beneficiary.
ID of the destination object associated with this beneficiary. null
if inline destination_details were passed.
Destination details echoed from the original request.
Type of payout destination (e.g. bank, local_payment_network).
Present when destination_details.type = local_payment_network.Show local_payment_network
Type of local payment network (e.g. pix_brl, upi_inr).
Deposit key for the network.
Provider-returned verification result. Present when
verification_status.status = valid.Show verified_information
Scoring methodology used by the provider (e.g. continuous, discrete).
Normalised confidence score from 0 to 1 as returned by the provider.
Tazapay normalised match classification. Allowed: strong_match, partial_match, no_match.
Translation of the matched name in local script, if available.
Corrected or suggested name returned by the provider where a close but imperfect match was found.
Indicates whether the account was found and recognised at the bank.
Whether the account belongs to an individual or business.
Bank account number of the beneficiary.
Type of bank account (e.g. savings, current, checking).
SWIFT/BIC code of the bank.
ABA routing number of the bank.
Name of the beneficiary’s bank.
Name or identifier of the bank branch.
Address of the beneficiary’s bank as returned by the provider.
Country where the bank account is held (ISO 3166-1 alpha-2).
Currency of the bank account (ISO 4217).
payment_scheme_eligibility
Payment schemes the account is eligible for. Applicable to IBAN corridors only (e.g. SEPA Credit Transfer, SEPA Instant).
transaction_activity_details
Transaction activity details returned by the provider (Kinexys only).Show transaction_activity_details
Indicates whether recent transaction activity was detected on the account.
transaction_activity_since
Date from which transaction activity was checked.
Balance details for this verification.
Currency from which the merchant was charged for this verification.
Either USD or the merchant’s primary currency, depending on which
was utilised.
Amount consumed for this verification.
Transaction ID of the balance debit entry.
Key-value map of merchant-defined metadata. Echoed from the original
request if provided. Max 10 keys; string values ≤ 500 chars each.
Your reference ID echoed from the original request.
Timestamp when the verification object was created.
Timestamp of the last status update.
