Skip to content

Published services, current details, and clear categories.

Explore APIs

UPI Verification API

Check that a UPI VPA is valid and read the name available against it. That confirms a payout destination before the money moves.

UPI IDNAME
Request and response

You confirm the required fields and consent steps with us during onboarding.

You send

UPI Virtual Payment Address (VPA), captured with consent

You receive

Validity status for the handle and the name available against it, where the source provides one

Coverage
India; UPI Virtual Payment Addresses, subject to the availability of the underlying record
Typical users
Payout, onboarding, treasury and risk teams across lending, insurance, marketplaces and gig platforms
Coverage note
Name formatting and available fields vary by data source and record; some handles return no name
Overview

What you can do with the UPI Verification API

UPI Verification checks whether a Virtual Payment Address is valid and usable, and returns the name available against it. It answers the two questions a business asks before paying over UPI. Does this handle exist, and does the name behind it look like the person you mean to pay? A handle is easy to mistype, and one wrong character can produce an address that still belongs to somebody. Run the check when a beneficiary is added, and again before a payout run, and a misdirected payment becomes a caught error. Available fields vary by data source and by record, and some handles return an abbreviated or bank-formatted name. Verify only handles a customer has given you for a payment purpose.

  • Catch a wrong handle before release

    The check runs before funds move. A wrong or edited handle is caught while it is still a correction. A misdirected UPI transfer is harder to unwind than a failed one.

  • Validity status and the payee name

    The response carries validity status for the submitted handle and the name available against it, with whatever status information the underlying source provides. Available fields vary by data source and by record, and some handles return no name.

  • No money moves: repeat it often

    The check does not move money. You can run it at every point where the risk sits. Run it when a beneficiary is added, before a payout run, and again whenever a handle is edited.

  • Your risk team sets the match threshold

    The returned name is compared against the one you already hold. Indian names vary in order, initials and formatting. Your risk team sets the match threshold and decides what a partial match should trigger.

How it works

The five-step UPI Verification API workflow

Our team walks you through the exact request and response for this service during onboarding.

Step 1

Collect the UPI handle for a payment

Take the UPI handle from the customer, worker or seller for a stated payment purpose, with a notice explaining what the check is for.

Step 2

Send the handle for verification

Your application sends the handle through the API from the beneficiary-add screen, the onboarding journey or the payout run that needs it.

Step 3

Read the status and the name

The response carries validity status for the handle and the name available against it, where the underlying source provides one.

Step 4

Compare it with the name on file

Match the returned name against the KYC record, policy or agreement you already hold, using a threshold your risk team has agreed.

Step 5

Release, review or ask for a new handle

Release the payout on a clean match, route a partial match to manual review, and ask for a corrected handle where nothing was returned.

Industries

Where teams use UPI Verification API

These sectors build the check into a decision they already make.

  • Lending

    Confirm the disbursement destination before a loan amount is released

  • Insurance

    Verify a claimant's handle before settlement and agent handles before commission runs

  • Fintech and payments

    Show a confirmed payee name on the beneficiary-add screen

  • Marketplaces

    Re-verify seller payout handles whenever settlement details are changed

  • Gig, staffing and logistics

    Validate worker and driver handles before recurring payout cycles

  • Travel and healthcare

    Check refund destinations before a cancellation or billing refund is approved

What Is UPI Verification?

A Virtual Payment Address, or VPA, is the readable handle a person shares in place of an account number and IFSC code. UPI Verification is a non-monetary check on that handle. It establishes whether the address is valid and usable, and returns the name held against it.

The handle is built to be spoken, typed and forwarded, which makes it fragile as a payment instruction. A mistyped handle is often still a valid one, belonging to somebody else. The mistake surfaces as a payment that left, not one that failed.

Confirming a Payee Name Before a UPI Payout

Seeing a name before approving a transfer is now a normal expectation in Indian payment journeys. Businesses paying out at volume have the same need in reverse. They want the name on the destination handle visible before a batch is released.

The risk moves between those two moments. A beneficiary record can be edited after approval, and a worker can change a handle between cycles. A file assembled on Monday can be released on Friday against details that shifted in between.

What a VPA Check Sends and Returns

The request starts with the handle itself. The check is cheap to place wherever the handle appears. That could be a beneficiary screen, an onboarding step, or a batch file staged for release.

What comes back depends on the record behind the address. A name may arrive in full, abbreviated, or in the form a bank keeps it, since available fields vary by data source and by record. A closed or dormant address may carry nothing at all, and a response with no name is a reason to ask, not to reject.

Where UPI Verification Fits Across Industries

  • Lending and NBFCs: a disbursement is watched for and a refund is not. A handle changed late in the journey goes unnoticed on the refund.
  • Insurance: a claimant is usually a one-time payee, while agent, surveyor and hospital handles repeat every cycle and are worth re-checking before each run.
  • Fintech and payment platforms: a confirmed name on the beneficiary-add screen makes the customer the last line of the check, since they know who they meant to pay.
  • Marketplaces: the moment seller payout details change is a common point of account-takeover loss. The check belongs at every edit.
  • Logistics, staffing and gig platforms: driver, partner and worker handles feed recurring cycles on rosters that turn over quickly, where one wrong entry repeats until somebody goes unpaid.
  • Real estate: brokerage payouts and token refunds are infrequent, high-value, and paid to people the business has no other relationship with.
  • Healthcare: patient refunds and provider settlements sit in billing and claims workflows where the payee is rarely the person on screen.
  • Travel: a cancellation refund is approved long after the booking, and where an agent booked for the traveler the destination is worth confirming.

The shared decision is the last one before release. Is this the right destination, and does the available name support paying it?

Designing the Name Comparison Step

The returned name earns its value once you compare it with a name you already hold, from a KYC record, a policy or a seller agreement. That comparison is a product decision. A threshold set too loose releases payouts nobody looked at, and one set too tight fills a review queue nobody staffed.

Decide in advance what each outcome routes to, and record the compared pair and the result so the decision can be audited later. Revisit the threshold once you can see what your queue is rejecting. A mismatch is a reason to look closer, and it proves nothing on its own.

Placing UPI Verification in a Batch Payout Run

Treat a no-result response as its own state rather than as an error. A record that could not be checked differs from a record that failed a check. Collapse the two into one error path, and good beneficiaries end up in the rejected pile.

For batch payouts, verify the file before the run. An unusable handle is then a line to fix in the file. Cache the result with a timestamp, since a check run months ago may no longer fit the work it is doing.

A handle and the name behind it are personal data about a payee who is often not the person operating your software. Verify only handles given to you for a payment purpose, and tell the payee what the check is for. Notice, a lawful basis, and retention limited to the purpose are what India's data-protection framework expects.

Keep an audit trail of who verified what and when, and restrict access to the staff whose work requires it. Give the payee a route to have a stored result corrected or removed once the purpose has ended. Which checks are available to you depends on the selected service contract.

FAQ

Common questions

What teams ask before they integrate UPI Verification API.

An interface that validates a UPI Virtual Payment Address and returns the name available against it. A business can confirm a payout destination inside its own software, instead of checking each handle separately by hand.

Get started

Add UPI Verification API to your workflow

Tell us how you plan to use it. Our team sets up API access, agrees your pricing and takes you through onboarding.