Body
Update UPI Number
This is a clubbed api endpoint for change vpa, disable, delete and reactivate the Upi Number.
Request
Response
API Endpoints
Production Link
POST
http://{{host}}/api/{uri}/merchants/upiNumber/update
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
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.
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
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
Constraints : Required when action is CHANGE_VPA. existingVpa and vpa should belong to the same customer and be part of the same PSP
action
*
String
Mandatory
Update action to be performed on UPI Number
Constraints : CHANGE_VPA, DISABLE, DELETE, REACTIVATE
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 : ACTIVE, DISABLED, DELETED
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.