Fintech APIs & Platform for KYC, Verification & Transactions in India | Eko Platform Services
Eko Platform Services Logo
← Back to Home

UPI ID (VPA) Verification API – Confirm Payee Before Payment

Validate UPI IDs — also known as Virtual Payment Address (VPA) — and registered phone numbers in real time. Confirm payee name before initiating transfers to reduce payout failures and payment fraud.

Starts at ₹1.44 per lookup · excl. GSTView Pricing

UPI ID (VPA) Verification API – Confirm Payee Before Payment

Overview

The UPI ID (VPA) Verification API validates Virtual Payment Addresses and registered phone numbers in real time. It returns the verified payee name, VPA, and registered mobile — helping you confirm the recipient before initiating UPI transfers and reducing wrong-payee payment failures.

What Can You Verify With UPI ID (VPA) Verification API?

Key details returned across all UPI ID (VPA) Verification API endpoints, ready to power your KYC and onboarding workflows.

VPA (UPI ID)

The validated UPI Virtual Payment Address (VPA / UPI ID) exactly as registered.

Is VPA Valid?

Whether the VPA is active and valid. true = valid VPA; false = invalid or inactive.

Recipient Name

Verified payee name as returned by the UPI network — use this for name-match checks before payment.

Mobile Number

Registered mobile number linked to the VPA.

Simplified API Preview

UPI ID (VPA) Verification API Flow – Sample Request and Response

Send simple inputs. Get rich, verified data in seconds.

Validate a UPI Virtual Payment Address (VPA) and retrieve the registered payee name and mobile number in real time.

REQUEST
Customer VPArajesh.kumar@okicici
Recipient Mobile9876543210
NameRajesh Kumar
Latlong28.6139,77.2090
RESPONSE
200 OK
VPA (UPI ID)rajesh.kumar@okicici
Is VPA Valid?true
Recipient NameRajesh Kumar
Mobile Number9876543210

Key Features

Everything you need to integrate and scale

Verify UPI ID (VPA)

Validate whether a UPI ID (VPA) is correct and retrieve the registered payee name before initiating a transfer.

Verify Registered Phone Number

Confirm the mobile number registered with the UPI ID (VPA) to strengthen payee verification.

Payee Name Confirmation

Returns the verified recipient name linked to the UPI ID (VPA) — enables name-match checks before payment.

Secure & Robust

Every API call is secured with one-time-use tokens generated using asymmetric cryptography.

Primary Use Cases

Pre-payment UPI ID (VPA) validation for UPI transfers
Reducing payout failures caused by incorrect UPI IDs
Customer onboarding where UPI ID (VPA) discovery is required
Assisted payments (agent or retailer-led transactions)
Payee name confirmation before bulk payouts

How to Integrate

Get started in minutes with our simple integration process

  1. 1

    Sign Up

    Sign up in minutes with your mobile number (OTP verify).

  2. 2

    Verify Identity

    Complete your basic KYC with PAN and address details to verify your identity.

  3. 3

    Test APIs Live

    Load funds into your wallet and test the verification APIs live — evaluate before you integrate.

  4. 4

    Integrate with AI

    Ready to build? Visit our AI hub for free plugins & tools to integrate faster.

  5. 5

    Go Live

    Start validating UPI ID (VPAs) in production.

Frequently Asked Questions

What is a VPA/UPI-ID?+

VPA (Virtual Payment Address) is the UPI ID used for sending and receiving payments — for example, rajesh@okicici. This API verifies whether a VPA is valid and returns the registered payee name.

Can I verify the registered phone number?+

Yes. The API accepts a UPI ID (VPA) and registered mobile number, and returns the verified payee details including recipient name.

What details are returned?+

The API returns the verified UPI ID (VPA), recipient name, registered mobile number, transaction ID, and verification status.

How do I get started?+

Four steps: sign up at the developer console page, verify your identity with PAN and address details, load your wallet to test the APIs live, then integrate and go live. Sandbox credentials are issued immediately — you can call your first endpoint before any paperwork clears.

What is EPS?+

EPS (Eko Platform Services) is the technology arm of Eko — the developer tools, AI tooling and APIs that power modern fintech integration, from money transfer and AePS to identity verification.

Also see:About Eko
What are the different ways to integrate with Eko EPS?+

Three paths, pick whichever suits your stack:

  • Call the REST APIs directly.
  • Use our official Node.js, Python, PHP, Go or Java SDKs to skip request-signing boilerplate.
  • Let an AI coding agent build it via our MCP server and agent skills.

For multi-step flows (onboard a sender, then transfer) start from a transaction-flow recipe rather than wiring single endpoints together yourself.

How does API authentication work?+

Each request carries your static developer_key header plus a per-request secret-key header — an HMAC-SHA256 signature of the current timestamp, keyed by your access key. The access key itself is never sent over the wire. You receive UAT keys on signup and production keys after KYC.

The How Authentication Works guide has the full signing recipe in five languages plus an in-browser playground that generates and verifies a real secret-key against your own access key.

Is there a sandbox environment for testing?+

Yes. A full sandbox is available immediately on signup — test your integration end-to-end before going live, no commitment required. For offline work you can also run our mock server (npx -y @ekoindia/eps-mock-server) and get canned responses with no network calls at all.

Also see:Get started
What are the sandbox and production base URLs?+

Sandbox and production share the same paths and differ only by base URL:

  • UAT / Sandbox — https://staging.eko.in/ekoapi/v3
  • Production — https://api.eko.in/ekoicici/v3

A common cause of failures is calling the sandbox URL with live credentials, or vice-versa — make sure the base URL matches the keys you are using.

Do I need to whitelist my server IP?+

Production API access may require your static public (server) IP to be whitelisted. If your calls work from Postman but fail or time out from your own server, that is almost always the cause — share your static public IP with us so we can whitelist it.

Can an AI coding agent build the integration for me?+

Yes — that is the fastest path. Point your agent (Claude Code, Codex, Cursor, Copilot, …) at our MCP server and it can look up any endpoint, generate correctly-signed requests, and scaffold the integration in your own stack. Install it in one step from the AI hub, or start from a ready-made prompt.

We also publish an OpenAPI 3.1 spec, a Postman collection and per-agent context packs (AGENTS.md, CLAUDE.md, .cursorrules) so an agent has the ground truth instead of guessing.

What response times can I expect?+

Most verification APIs return in real time with sub-second responses, and 99th-percentile latency stays under two seconds across verification endpoints. Transaction APIs (DMT, AePS, BBPS) respond within seconds.

Can the API handle high volumes?+

Yes. The API is designed to handle large-scale volumes reliably without performance degradation.

How is API usage billed?+

Usage is billed per successful API call with no minimum commitment. Volume-based pricing tiers are available — see the pricing calculator for indicative rates, or contact our team for a custom quote.

Get API Access

Sign up now and start integrating in minutes. Our team will help you go live quickly.

  • Sandbox access in minutes
  • Dedicated integration support
  • Comprehensive documentation
  • Reliable, high-volume workflows

Get UPI ID (VPA) Verification API Access

Get started in 10 minutes