Tazamatch 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"
}'
- valid — strong match
- valid — partial match
- valid — no match score
- invalid
- not_supported
200
{
"status": "success",
"message": "",
"data": {
"id": "pyv_xxxx",
"object": "verification",
"verification_status": "valid",
"status_description": "ValidationSucceeded",
"beneficiary": "",
"beneficiary_details": {
"type": "individual",
"email": "",
"tax_id": "",
"phone": {
"calling_code": "",
"number": ""
},
"address": {
"line1": "",
"line2": "",
"city": "",
"state": "",
"postal_code": "",
"country": ""
},
"destination_details": {
"type": "bank",
"bank": {
"account_holder_name": "John Doe",
"account_holder_name_local": "",
"account_number": "9876543210",
"account_type": "",
"address": null,
"bank_codes": {
"ifsc_code": "HDFC0001234"
},
"bank_name": "",
"branch_name": "",
"country": "IN",
"currency": "INR",
"firc_required": false,
"iban": "",
"phone": null,
"purpose_code": ""
}
}
},
"verified_information": {
"account_exists": true,
"additional_information": null,
"beneficiary_type": "individual",
"name_match_details": {
"type": "continuous",
"value": 1,
"summary": "strong_match",
"corrected_name_returned": "",
"matched_name_translation": ""
},
"transaction_activity_details": null
},
"balance": {
"holding_currency": "USD",
"initial_balance": 99845,
"balance_impact": -25,
"balance_remaining": 99820,
"balance_transaction_id": "btr_xxxx"
},
"metadata": null,
"reference_id": "your-internal-ref-001",
"created_at": "2026-04-07T10:00:00Z",
"updated_at": "2026-04-07T10:00:00Z"
}
}
200
{
"status": "success",
"message": "",
"data": {
"id": "pyv_xxxx",
"object": "verification",
"verification_status": "valid",
"status_description": "ValidationSucceeded",
"beneficiary": "",
"beneficiary_details": {
"type": "individual",
"email": "",
"tax_id": "",
"phone": {
"calling_code": "",
"number": ""
},
"address": {
"line1": "",
"line2": "",
"city": "",
"state": "",
"postal_code": "",
"country": ""
},
"destination_details": {
"type": "bank",
"bank": {
"account_holder_name": "Jonathan Doe",
"account_holder_name_local": "",
"account_number": "9876543210",
"account_type": "",
"address": null,
"bank_codes": {
"ifsc_code": "HDFC0001234"
},
"bank_name": "",
"branch_name": "",
"country": "IN",
"currency": "INR",
"firc_required": false,
"iban": "",
"phone": null,
"purpose_code": ""
}
}
},
"verified_information": {
"account_exists": true,
"additional_information": null,
"beneficiary_type": "individual",
"name_match_details": {
"type": "continuous",
"value": 0.6,
"summary": "partial_match",
"corrected_name_returned": "Jonathan Doe",
"matched_name_translation": ""
},
"transaction_activity_details": null
},
"balance": {
"holding_currency": "USD",
"initial_balance": 99845,
"balance_impact": -25,
"balance_remaining": 99820,
"balance_transaction_id": "btr_xxxx"
},
"metadata": null,
"reference_id": "your-internal-ref-001",
"created_at": "2026-04-07T10:00:00Z",
"updated_at": "2026-04-07T10:00:00Z"
}
}
200
{
"status": "success",
"message": "",
"data": {
"id": "pyv_xxxx",
"object": "verification",
"verification_status": "valid",
"status_description": "ValidationSucceeded",
"beneficiary": "",
"beneficiary_details": {
"type": "individual",
"email": "",
"tax_id": "",
"phone": {
"calling_code": "",
"number": ""
},
"address": {
"line1": "",
"line2": "",
"city": "",
"state": "",
"postal_code": "",
"country": ""
},
"destination_details": {
"type": "bank",
"bank": {
"account_holder_name": "",
"account_holder_name_local": "",
"account_number": "9876543210",
"account_type": "",
"address": null,
"bank_codes": {
"ifsc_code": "HDFC0001234"
},
"bank_name": "",
"branch_name": "",
"country": "IN",
"currency": "INR",
"firc_required": false,
"iban": "",
"phone": null,
"purpose_code": ""
}
}
},
"verified_information": {
"account_exists": true,
"additional_information": null,
"beneficiary_type": "individual",
"name_match_details": null,
"transaction_activity_details": null
},
"balance": {
"holding_currency": "USD",
"initial_balance": 99845,
"balance_impact": -25,
"balance_remaining": 99820,
"balance_transaction_id": "btr_xxxx"
},
"metadata": null,
"reference_id": "your-internal-ref-001",
"created_at": "2026-04-07T10:00:00Z",
"updated_at": "2026-04-07T10:00:00Z"
}
}
200
{
"status": "success",
"message": "",
"data": {
"id": "pyv_xxxx",
"object": "verification",
"verification_status": "invalid",
"status_description": "ValidationFailed",
"beneficiary": "",
"beneficiary_details": {
"type": "individual",
"email": "",
"tax_id": "",
"phone": {
"calling_code": "",
"number": ""
},
"address": {
"line1": "",
"line2": "",
"city": "",
"state": "",
"postal_code": "",
"country": ""
},
"destination_details": {
"type": "bank",
"bank": {
"account_holder_name": "",
"account_holder_name_local": "",
"account_number": "9876543210",
"account_type": "",
"address": null,
"bank_codes": {
"ifsc_code": "HDFC0001234"
},
"bank_name": "",
"branch_name": "",
"country": "IN",
"currency": "INR",
"firc_required": false,
"iban": "",
"phone": null,
"purpose_code": ""
}
}
},
"verified_information": {
"account_exists": false,
"additional_information": null,
"beneficiary_type": "",
"name_match_details": null,
"transaction_activity_details": null
},
"balance": {
"holding_currency": "USD",
"initial_balance": 99845,
"balance_impact": -25,
"balance_remaining": 99820,
"balance_transaction_id": "btr_xxxx"
},
"metadata": null,
"reference_id": "your-internal-ref-001",
"created_at": "2026-04-07T10:00:00Z",
"updated_at": "2026-04-07T10:00:00Z"
}
}
200
{
"status": "success",
"message": "",
"data": {
"id": "pyv_xxxx",
"object": "verification",
"verification_status": "not_supported",
"status_description": "VerificationNotSupported",
"beneficiary": "",
"beneficiary_details": {
"type": "individual",
"email": "",
"tax_id": "",
"phone": {
"calling_code": "",
"number": ""
},
"address": {
"line1": "",
"line2": "",
"city": "",
"state": "",
"postal_code": "",
"country": ""
},
"destination_details": {
"type": "bank",
"bank": {
"account_holder_name": "",
"account_holder_name_local": "",
"account_number": "9876543210",
"account_type": "",
"address": null,
"bank_codes": {
"ifsc_code": "HDFC0001234"
},
"bank_name": "",
"branch_name": "",
"country": "IN",
"currency": "INR",
"firc_required": false,
"iban": "",
"phone": null,
"purpose_code": ""
}
}
},
"verified_information": null,
"balance": null,
"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
Basic authentication header of the form
Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.Body
Full name of the beneficiary (payee) to match against the account holder.
Type of beneficiary entity. Allowed:
individual, business.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.Inline payee details. Pass this or
beneficiary, not both.Show beneficiary_details
Show beneficiary_details
Email address of the beneficiary.
Container object holding payout destination details.
Show destination_details
Show destination_details
Type of payout destination. Allowed:
bank, wallet, local_payment_network.Required when
destination_details.type = bank.Show bank
Show bank
Bank account number of the beneficiary.
IBAN of the beneficiary. Required for IBAN corridors.
Name of the beneficiary’s bank.
Name or identifier of the bank branch.
Country where the bank account is held (ISO 3166-1 alpha-2).
Currency of the bank account (ISO 4217).
Container for bank routing identifiers. Which codes are required depends on the corridor — use Get Verification Metadata to check.
Type of bank account (e.g.
savings, current, checking).Required when
destination_details.type = local_payment_network.Tax identification number of the beneficiary.
Name of the beneficiary in local language or script.
Additional key-value data. Max 10 keys; string values ≤ 500 chars each.
Reference ID of the verification on your system. Echoed in the response.
Response
Unique identifier for the verification object. Prefix:
pyv_.Fixed value:
verification.Current 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). Empty string for inline (Mode B) verifications.Echo of the beneficiary details submitted in the request or retrieved from the saved beneficiary object.
Show beneficiary_details
Show beneficiary_details
Type of beneficiary entity (
individual or business).Email address of the beneficiary.
Tax identification number of the beneficiary.
Destination details echoed from the request.
Show destination_details
Show destination_details
Type of payout destination (e.g.
bank, local_payment_network).Present when
destination_details.type = bank.Show bank
Show bank
Name of the account holder as registered at the bank.
Account holder name in local language or script.
Bank account number.
Type of bank account (e.g.
savings, current, checking).Bank address.
null if not provided.Bank routing identifiers (e.g.
ifsc_code, swift_code).Name of the bank.
Name or identifier of the bank branch.
Country where the bank account is held (ISO 3166-1 alpha-2).
Currency of the bank account (ISO 4217).
Whether a Foreign Inward Remittance Certificate is required for this corridor.
IBAN of the beneficiary.
Bank phone number.
null if not provided.Purpose code for the transfer, where required by the corridor.
Verification result. Present when
verification_status = valid. null for not_supported.Show verified_information
Show verified_information
Indicates whether the account was found and recognised at the bank.
Additional provider-specific information returned for the verification.
null if not returned.Whether the account belongs to an
individual or business.Name match result.
null when the corridor does not support name matching.Show name_match_details
Show name_match_details
Scoring methodology used (e.g.
continuous).Normalised confidence score from
0.0 to 1.0.Tazapay normalised match classification. Allowed:
strong_match, partial_match, no_match.Suggested name returned by the provider where a close but imperfect match was found. Empty string if not returned.
Translation of the matched name, where returned by the provider. Empty string if not applicable.
Transaction activity details returned by the provider (Kinexys only).
Balance snapshot at the time of this verification.
null when verification_status = not_supported as no charge is applied.Show balance
Show balance
Currency from which the merchant is charged for this verification. Either
USD or the merchant’s primary currency, depending on which is utilised.Balance of the holding currency before this deduction.
Amount consumed for this verification. Expressed as a negative value.
Balance of the holding currency remaining after this deduction.
Transaction ID of the balance debit entry. Prefix:
btr_.Key-value map of merchant-defined metadata. Echoed from the request if provided. Max 10 keys; string values ≤ 500 chars each.
Your reference ID echoed from the request.
Timestamp when the verification object was created.
Timestamp of the last status update.