Skip to main content

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
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": {
    "object": "list",
    "has_more": false,
    "results": [
      {
        "country": "IN",
        "currency": "INR",
        "payout_type": "local",
        "destination_type": "bank",
        "coverage_percent": 95,
        "required_bank_fields": [
          "account_number",
          "country",
          "currency"
        ],
        "required_bank_codes": [
          "ifsc_code"
        ],
        "required_beneficiary_fields": [
          "name",
          "type"
        ],
        "supported_verification_capabilities": {
          "account_exists": true,
          "name_check": true,
          "match_score": true,
          "match_type": true,
          "corrected_name_returned": false,
          "matched_name_translation": false,
          "transaction_activity": false
        }
      },
      {
        "country": "IN",
        "currency": "INR",
        "payout_type": "local_payment_network",
        "destination_type": "local_payment_network",
        "local_payment_network": {
          "type": "upi_inr",
          "deposit_key": "example@upi",
          "deposit_key_type": ""
        },
        "coverage_percent": 95,
        "required_bank_fields": [],
        "required_bank_codes": [],
        "required_beneficiary_fields": [
          "name",
          "type"
        ],
        "supported_verification_capabilities": {
          "account_exists": true,
          "name_check": true,
          "match_score": true,
          "match_type": true,
          "corrected_name_returned": false,
          "matched_name_translation": false,
          "transaction_activity": false
        }
      },
      {
        "country": "IN",
        "currency": "INR",
        "payout_type": "swift",
        "destination_type": "bank",
        "coverage_percent": 60,
        "required_bank_fields": [
          "account_number",
          "country",
          "currency"
        ],
        "required_bank_codes": [
          "swift_code"
        ],
        "required_beneficiary_fields": [
          "name",
          "type"
        ],
        "supported_verification_capabilities": {
          "account_exists": true,
          "name_check": true,
          "match_score": true,
          "match_type": true,
          "corrected_name_returned": false,
          "matched_name_translation": false,
          "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).
type
enum
Type of payout rail for which verification metadata is being requested. Allowed: local, swift, local_payment_network.
currency
string
Currency of the destination account (ISO 4217, e.g. INR, USD). Required for currency-bound rails.
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

status
string
Indicates whether the request to retrieve verification metadata was successful.
message
string
Additional message providing context or status information about the request.
data
object
Contains the verification capability details for the requested corridor and rail.