Create or Port UPI Number

Create a new UPI Number or port an existing mobile number from another TPAP.

POST /v1/upi/tpap/upi_number

Curl

-X POST 'https://api.rzp.<bank>.com/v1/upi/tpap/upi_number' \
-u [YOUR_KEY_ID]:[YOUR_SECRET] \
-H "Content-Type: application/json" \
-H "x-device-fingerprint: <device_fingerprint>" \
-H "x-device-fingerprint-timestamp: 1496918882000" \
-H "x-customer-reference: cust_ref" \
-d '{
  "upi_number": "1234567890",
  "vpa": "gaurav.kumar@exampleupi",
  "action": "create",
  "existing_vpa": "olduser@upi",
  "consent": true
}'

Response

{
  "entity": "upi_number",
  "upi_transaction_id": "123qwert12",
  "upi_number": "1234567890",
  "type": "mobile",
  "status": "initiated",
  "vpa": "gaurav.kumar@exampleupi"
}

Available in🇮🇳 India

Use this endpoint to create a new UPI Number or port a mobile number to a new VPA.

Curl

-X POST 'https://api.rzp.<bank>.com/v1/upi/tpap/upi_number' \
-u [YOUR_KEY_ID]:[YOUR_SECRET] \
-H "Content-Type: application/json" \
-H "x-device-fingerprint: <device_fingerprint>" \
-H "x-device-fingerprint-timestamp: 1496918882000" \
-H "x-customer-reference: cust_ref" \
-d '{
  "upi_number": "1234567890",
  "vpa": "gaurav.kumar@exampleupi",
  "action": "create",
  "existing_vpa": "olduser@upi",
  "consent": true
}'

Response

{
  "entity": "upi_number",
  "upi_transaction_id": "123qwert12",
  "upi_number": "1234567890",
  "type": "mobile",
  "status": "initiated",
  "vpa": "gaurav.kumar@exampleupi"
}

Request Parameters

upi_number · string · required

The UPI number to check for availability (mobile or numeric id).

vpa · string · required

VPA to which the UPI number has to be linked.

action · string

Action to be performed on UPI Number. Possible values:

• create
• port

existing_vpa · string

VPA linked with the UPI number (Only in case of PORT).

consent · boolean · required

Consent of the user to create a new UPI Number or port a mobile number to a new VPA. Possible values:

• true: The user has given the consent.
• false: The user has not given the consent.

Response Parameters

entity · string

Collection of entity. Here it is upi_number.

upi_transaction_id · string

Unique transaction id created by the originator.

upi_number · string

Unique id mapped to the customer’s VPA.

type · string

Type of number. For example, mobile or numeric.

status · string

Status of the UPI number. Possible values:

• initiated
• active

vpa · string

VPA linked to the UPI number.