Body
Create UpiNumber
This endpoint is used to create a new UPI number.
Request
Response
API Endpoints
Production Link
POST
http://{{host}}/api/{uri}/merchants/upiNumber/create
Headers
Content-Type
*
string
Required
application/json
x-merchant-id
*
string
Required
Will be shared while onboarding.
x-merchant-channel-id
*
string
Required
Will be shared while onboarding.
Accept
*
string
Required
application/json
x-timestamp
*
integer
Required
This is an epoch unix timestamp string. For example, 1496918882000. It can be used by us to invalidate older requests.
x-merchant-checksum
*
string
Required
checksum calculated for the request body
Parameters
merchantCustomerId
*
String
Mandatory
Merchant generated unique profile id for customer
Constraints : Alphanumeric string with dot(.). Maximum length is 256.
upiRequestId
*
String
Mandatory
Unique id sent to UPI switch
Constraints : 35 character alphanumeric that starts with a unique merchant prefix
upiNumber
*
String
Mandatory
Number mapped to a customer’s VPA that is unique to the customer across the UPI ecosystem
Constraints : 8 to 10 digit numeric string. 10 digit number must be the mobile number. Last 3 digits must not be same. Must not start with a 0.
vpa
*
String
Mandatory
Vpa to be linked with the provided Upi Number
Constraints : vpa@handle
existingVpa
String
optional
Previous Vpa that was linked with the provided Upi Number at other PSP.
Constraints : Required while porting Upi Number of 10 digits (Mobile Number)
deviceFingerPrint
*
String
Mandatory
Device fingerprint of the customer
fallbackDeviceFingerPrint
String
optional
Fallback Device fingerprint of the customer
udfParameters
JSON string
optional
Stringified JSON for udf parameters
packageName
String
optional
Package name of the UPI application
200 : Success
Response Body
status
*
String
Mandatory
Status of the API.
Values : SUCCESS, FAILURE
responseCode
*
String
Mandatory
PSP response code for the API
Values : Refer error code section
responseMessage
*
String
Mandatory
PSP response message for the API
Values : Refer error code section
payload
*
JSON
Mandatory
merchantChannelId
*
String
Mandatory
Unique id for the merchant channel as passed in request headers
status
*
String
Mandatory
Status of the Upi Number.
Values : String(ACTIVE, FAILED)
gatewayResponseStatus
*
String
Mandatory
Response status returned by gateway.
Values : String(SUCCESS, FAILURE)
vpa
*
String
Mandatory
Vpa linked to the upiNumber
Values : vpa@handle
merchantId
*
String
Mandatory
Unique id for the merchant as passed in request headers
gatewayResponseMessage
*
String
Mandatory
Response message for code returned by gateway.
gatewayResponseCode
*
String
Mandatory
Response code returned by gateway. Refer the table below for all possible values.
gatewayTransactionId
*
String
Mandatory
Transaction id returned by gateway. Same as upiRequestId passed in request
customerMobileNumber
*
String
Mandatory
Mobile number of the customer.
Values : 12 character string
upiNumber
*
String
Mandatory
Number mapped to a customer’s VPA that is unique to the customer across the UPI ecosystem
Values : As passed in request
merchantCustomerId
*
String
Mandatory
Merchant generated unique profile id for customer as passed in the request
gatewayTimestamp
*
String
Mandatory
Gateway timestamp for the Api call.
Values : String(YYYY-MM-DDTHH:MM:SS+05:30)
udfParameters
JSON string
Optional
Stringified json for udf parameters.
Have questions?
- Need help? Contact support
- LLM? Read llms.txt