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

cURL

curl --request GET \
  --url 'https://service-sandbox.tazapay.com/v3/verification/payee/metadata?country=IN&currency=INR' \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "status": "success",
  "message": "",
  "data": {
    "corridors": [
      {provider
        "bank_name_options": [],
        "country": "IN",
        "coverage": 95,
        "currency": "INR",
        "destination_type": "bank",
        "local_payment_network_type": "",
        "required_bank_codes": [
          "ifsc_code"
        ],
        "required_bank_fields": [
          "account_number",
          "country",
          "currency"
        ],
        "required_beneficiary_fields": [
          "name",
          "type"
        ],
        "supported_verification_capabilities": {
          "account_exists": true,
          "corrected_name_returned": false,
          "match_score": true,
          "match_type": true,
          "matched_name_translation": false,
          "name_check": true,
          "transaction_activity": false
        }
      },
      {
        "bank_name_options": [],
        "country": "BE",
        "coverage": 90,
        "currency": "EUR",
        "destination_type": "bank",
        "local_payment_network_type": "",
        "required_bank_codes": [],
        "required_bank_fields": [
          "iban",
          "country",
          "currency"
        ],
        "required_beneficiary_fields": [
          "name",
          "type"
        ],
        "supported_verification_capabilities": {
          "account_exists": true,
          "corrected_name_returned": false,
          "match_score": false,
          "match_type": false,
          "matched_name_translation": false,
          "name_check": true,
          "transaction_activity": false
        }
      }
    ]
  }
}

Get Verification Metadata

GET /v3/verification/payee/metadata Use this endpoint before initiating a verification to check whether payee verification is supported for a given corridor, and to retrieve the exact fields required to run a verification.

Authorizations

Authorization

string

required

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

Query Parameters

country

string

Destination country (ISO 3166-1 alpha-2, e.g. IN, US, GB).

currency

string

Currency of the destination account (ISO 4217, e.g. INR, USD).

type

enum

Type of payout rail. Allowed: local, swift, local_payment_network.

local_payment_network.type

string

Type of local payment network. Required if type = local_payment_network (e.g. upi_inr, pix_brl, promptpay_thb).

Response

data

object

Show data

corridors

array

List of supported corridors matching the query, each with required fields and verification capabilities.

Show corridors[]

country

string

Destination country (ISO 3166-1 alpha-2).

currency

string

Currency of the destination account (ISO 4217).

destination_type

string

Type of payout destination supported for verification. Allowed: bank, local_payment_network.

local_payment_network_type

string

Type of local payment network. Populated when destination_type = local_payment_network (e.g. upi_inr, pix_brl). Empty string otherwise.

coverage

integer

Estimated coverage percentage for this corridor.

bank_name_options

array

List of accepted bank name values for this corridor, where applicable. Empty array if not restricted.

required_bank_fields

string[]

Bank fields required for verification (e.g. account_number, iban, country, currency, account_type). Applicable when destination_type = bank.

required_bank_codes

string[]

Bank routing codes required for verification (e.g. ifsc_code, swift_code, aba_code, sort_code, branch_code, bsb_code, bank_code, cnaps). Applicable when destination_type = bank.

required_beneficiary_fields

string[]

Beneficiary fields required to complete the verification (e.g. name, type, phone, email, address, tax_id).

supported_verification_capabilities

object

Verification capabilities supported for this corridor.

Show supported_verification_capabilities

account_exists

boolean

Whether tazamatch can confirm if the account exists.

name_check

boolean

Whether tazamatch supports name matching against the account holder.

match_score

boolean

Whether a normalised confidence score (0.0 to 1.0) is returned for the name match.

match_type

boolean

Whether the match is classified as strong_match, partial_match, or no_match.

corrected_name_returned

boolean

Whether a corrected or suggested name is returned when a close but imperfect match is found.

matched_name_translation

boolean

Whether a translation of the matched name in local script is returned.

transaction_activity

boolean

Whether recent transaction activity on the account can be confirmed.

​Get Verification Metadata

​Authorizations

​Query Parameters

​Response

Get Verification Metadata

Authorizations

Query Parameters

Response