Mobile to VPA
Overview
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
- It is essential to provide a valid mobile number as input for accurate results.
- In cases where the provided mobile number is associated with multiple VPAs, the API returns details of one VPA.
- 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
Key | Type | Meaning | Example |
---|---|---|---|
reference_id | String | Unique identifier for the transaction | "XX-wqdw-47d7-abe0-XXwege" |
consent | Boolean | User's consent for VPA verification | "true/false" |
purpose | String | Purpose of verification | To verify user VPA/ Name |
mobile | Integer | User'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
Key | Meaning | Example |
---|---|---|
decentroTxnId | Decentro Transaction ID | "D871D26379284A5FD4E550A2D8FE" |
status | Overall status of the verification | "SUCCESS" |
responseCode | Response code indicating the result | "S00000" |
message | Brief description of the status | "VPA fetched successfully" |
data | Detailed information about the verification | See below |
responseKey | Unique identifier for the response type | "success_vpa_found" |
Data Fields Response Mapping
Key | Meaning | Example |
---|---|---|
name | Name of the user | "XXXX XXXX XX" |
upi | UPI id found or not found | "true/false" |
vpa | VPA id | "XXXXXX@ybl" |
Updated 3 months ago