Mobile to VPA


This API facilitates the retrieval of the name and Virtual Payment Address (VPA or UPI ID) associated with a given mobile number.

UPI (Unified Payments Interface) is a real-time payment system widely used in India, enabling users to link multiple bank accounts to a single mobile application. Through UPI, individuals can seamlessly perform various transactions, including peer-to-peer transfers, bill payments, and online purchases.

API Endpoint

The API endpoint is specified in the request, and users are required to include relevant authentication headers such as client_id, client_secret, and module_secret.

These credentials ensure the security and authorization of the API call.

Request Parameters

The API request requires several essential parameters.

The reference_id serves as a unique identifier for the transaction, aiding in tracking and reconciliation.

User consent is captured through the consent parameter, while the purpose field allows businesses to specify the reason for fetching VPA, promoting transparency. Also, the purpose should be a minimum of 20 characters.

The mobile parameter contains the user's mobile number that needs to be verified.


Good to know

  1. It is essential to provide a valid mobile number as input for accurate results.
  2. In cases where the provided mobile number is associated with multiple VPAs, the API returns details of one VPA.
  3. The API ensures robust error handling, providing appropriate responses for invalid inputs or no matching records.

Sample Request Body

    "reference_id": "XXXXXXXX",
    "consent": true,
    "purpose": "To verify user VPA/ Name",
    "mobile": "XXXXXX"

Request Mapping Table

reference_idStringUnique identifier for the transaction"XX-wqdw-47d7-abe0-XXwege"
consentBooleanUser's consent for VPA verification"true/false"
purposeStringPurpose of verificationTo verify user VPA/ Name
mobileIntegerUser's mobile number(10 digits)"9999999999"

Sample Response Body

    "decentroTxnId": "XXXXX",
    "status": "SUCCESS",
    "responseCode": "S00000",
    "message": "VPA fetched successfully",
    "data": {
        "name": "XXX",
        "upi": true/false,
        "vpa": "XXXX"
    "responseKey": "success_vpa_found"

Response Mapping Table

decentroTxnIdDecentro Transaction ID"D871D26379284A5FD4E550A2D8FE"
statusOverall status of the verification"SUCCESS"
responseCodeResponse code indicating the result"S00000"
messageBrief description of the status"VPA fetched successfully"
dataDetailed information about the verificationSee below
responseKeyUnique identifier for the response type"success_vpa_found"

Data Fields Response Mapping

nameName of the user"XXXX XXXX XX"
upiUPI id found or not found"true/false"
vpaVPA id"XXXXXX@ybl"