Documentation Index Fetch the complete documentation index at: https://developer.tazapay.com/llms.txt
Use this file to discover all available pages before exploring further.
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/verifications/payee?beneficiary=bnf_xxxx&limit=10' \ --header 'Authorization: Basic <encoded-value>'
{ "status" : "success" , "message" : "" , "data" : { "object" : "list" , "has_more" : false , "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" : { "match_details" : { "type" : "continuous" , "value" : 0.97 , "summary" : "strong_match" }, "account_exists" : true , "matched_name_details" : { "matched_name_translation" : null , "corrected_name_returned" : null }, "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 }, "additional_information" : null }, "metadata" : null , "reference_id" : null , "created_at" : "2026-04-07T10:00:00Z" , "updated_at" : "2026-04-07T10:00:05Z" } ] } }
List Verifications GET /v3/verifications/payee
Returns verification objects in reverse chronological order. Use the
beneficiary filter to retrieve all verifications linked to a specific
beneficiary, or use created filters to narrow by date range.
Authorizations Basic authentication header of the form Basic <encoded-value>, where
<encoded-value> is the base64-encoded string username:password.
Query Parameters Filter by beneficiary ID (bnf_xxxx). Returns all verifications linked
to the specified beneficiary.
Number of objects to return. Default: 10. Range: 1–100.
Cursor for forward pagination. Pass the id of the last object from
the previous page.
Cursor for backward pagination. Pass the id of the first object from
the current page.
Filter by creation time. Supports gt, gte, lt, lte as Unix
timestamps (e.g. created[gte]=1700000000).
Response Whether more objects exist beyond the current page.
List of verification objects in reverse chronological order. Unique identifier for the verification object. Prefix: ver_.
Fixed value: verification.
Status of the verification. Allowed: valid, invalid, pending,
not_supported.
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 = 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, weak_match, no_match.
Indicates whether the account was found and recognised at the bank.
Show matched_name_details
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.
Whether the account belongs to an individual or business.
Bank account number of the beneficiary.
Type of bank account (e.g. savings, current, checking).
Container for bank routing identifiers.
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).
Additional provider-specific information. Not consistently
available across all corridors. Show additional_information
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.
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.
