UPI Verification

POST

/api/v1/verification/upi-verify

UPI Verification

Verify a customer’s UPI ID (VPA) to ensure it exists and is active, and fetch the name returned by the issuing bank. Use this before initiating collect/payments to reduce failures and fraud.

What it does

Validates whether a given VPA is active and reachable.

Returns the account holder name as reported by the bank (name-at-bank).

Helps decide if a payment request should be initiated to this VPA.

Request

Header Params

Body Params application/json

Example

{
    "upi_id": "test1234@ybl"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/verification/upi-verify' \
--header 'x-client-id: {{client_id}}' \
--header 'x-client-secret: {{client_secret}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "upi_id": "test1234@ybl"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "response_code": 200,
    "status": "success",
    "message": "Success",
    "data": {
        "request_id": "UPIVFR14476546568_76effd82",
        "account_exists": true,
        "upi_id": "test1234@ybl",
        "holder_name": "JOHN DOE",
        "note": "",
        "status": "verified"
    },
    "meta": {
        "request_id": "cdd386a0-e059-4ad7-9db0-c8b6fab12250",
        "time": "2025-09-18T14:47:28+05:30"
    }
}

🟠422Validation Error

Verify OTP

Bank Verification

UPI Verification