Pay from Fundsource Lite Account

curl -X POST 'https://api.rzp.<bank>.com/v1/upi/tpap/payments/pay' \
-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_transaction_id": "RZP1KuSUGrp2l6MmPuT0163789452QPAY02",
  "reference_id": "RSKwpINfSkdEvtdxf",
  "initiation_mode": "QR Code",
  "purpose": "UPI Lite Send Money",
  "upi_purpose_code": "44",
  "device": {
    "geocode": "12.9667,77.5667",
    "ip": "198.1.1.2"
  },
  "currency": "INR",
  "amount": 50,
  "type": "pay",
  "description": "Lite-Pay",
  "payer": {
    "fundsource_lite_id": "fs_Mock14charID"
  },
  "upi_credentials": {
    "ARQC": "{\"type\":\"ARQC\",\"subType\":\"initial\",\"data\":{\"encryptedBase64String\":\"encrypted_string\",\"code\":\"NPCI-LITE\"}}"
  },
  "payees": [
    {
      "vpa": "acme.corp@rzp"
    }
  ]
}'

{
  "entity": "upi.payment",
  "upi_transaction_id": "RZPc2ed455b797e4add8392110cfc528acc",
  "reference_id": "ord_somfv432nsa",
  "upi_customer_reference_number": "804813039157",
  "upi_reference_url": "https://www.test.com",
  "upi_reference_category": "00",
  "upi_initiation_mode": "00",
  "upi_purpose_code": "44",
  "currency": "INR",
  "amount": 100,
  "type": "pay",
  "description": "flight tickets",
  "payer": {
    "fundsource_lite": {
      "fundsource_lite_id": "lite_Mock14charID",
      "upi_lite_reference_number": "1234567890",
      "upi_lite_credentials": {
        "ARQC": "string"
      }
    },
    "name": "Gaurav Kumar",
    "mcc": "0000",
    "response_code": "00",
    "reversal_response_code": "00"
  },
  "payees": [
    {
      "vpa": "acme.corp@rzp",
      "fundsource": {
        "ifsc": "HDFC0000058",
        "masked_account_number": "XXXXXXXXXXX6000"
      },
      "name": "AcmeCorp Pvt. Ltd.",
      "mcc": "6765",
      "upi_response_code": "00",
      "upi_reversal_response_code": "00"
    }
  ],
  "status": "success",
  "created_at": "1653915355",
  "updated_at": "1691097057"
}

POST

upi

tpap

payments

pay

curl -X POST 'https://api.rzp.<bank>.com/v1/upi/tpap/payments/pay' \
-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_transaction_id": "RZP1KuSUGrp2l6MmPuT0163789452QPAY02",
  "reference_id": "RSKwpINfSkdEvtdxf",
  "initiation_mode": "QR Code",
  "purpose": "UPI Lite Send Money",
  "upi_purpose_code": "44",
  "device": {
    "geocode": "12.9667,77.5667",
    "ip": "198.1.1.2"
  },
  "currency": "INR",
  "amount": 50,
  "type": "pay",
  "description": "Lite-Pay",
  "payer": {
    "fundsource_lite_id": "fs_Mock14charID"
  },
  "upi_credentials": {
    "ARQC": "{\"type\":\"ARQC\",\"subType\":\"initial\",\"data\":{\"encryptedBase64String\":\"encrypted_string\",\"code\":\"NPCI-LITE\"}}"
  },
  "payees": [
    {
      "vpa": "acme.corp@rzp"
    }
  ]
}'

{
  "entity": "upi.payment",
  "upi_transaction_id": "RZPc2ed455b797e4add8392110cfc528acc",
  "reference_id": "ord_somfv432nsa",
  "upi_customer_reference_number": "804813039157",
  "upi_reference_url": "https://www.test.com",
  "upi_reference_category": "00",
  "upi_initiation_mode": "00",
  "upi_purpose_code": "44",
  "currency": "INR",
  "amount": 100,
  "type": "pay",
  "description": "flight tickets",
  "payer": {
    "fundsource_lite": {
      "fundsource_lite_id": "lite_Mock14charID",
      "upi_lite_reference_number": "1234567890",
      "upi_lite_credentials": {
        "ARQC": "string"
      }
    },
    "name": "Gaurav Kumar",
    "mcc": "0000",
    "response_code": "00",
    "reversal_response_code": "00"
  },
  "payees": [
    {
      "vpa": "acme.corp@rzp",
      "fundsource": {
        "ifsc": "HDFC0000058",
        "masked_account_number": "XXXXXXXXXXX6000"
      },
      "name": "AcmeCorp Pvt. Ltd.",
      "mcc": "6765",
      "upi_response_code": "00",
      "upi_reversal_response_code": "00"
    }
  ],
  "status": "success",
  "created_at": "1653915355",
  "updated_at": "1691097057"
}

Available in🇮🇳 India

Use this endpoint to send a payment from a Fundsource Lite account to a VPA.

curl -X POST 'https://api.rzp.<bank>.com/v1/upi/tpap/payments/pay' \
-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_transaction_id": "RZP1KuSUGrp2l6MmPuT0163789452QPAY02",
  "reference_id": "RSKwpINfSkdEvtdxf",
  "initiation_mode": "QR Code",
  "purpose": "UPI Lite Send Money",
  "upi_purpose_code": "44",
  "device": {
    "geocode": "12.9667,77.5667",
    "ip": "198.1.1.2"
  },
  "currency": "INR",
  "amount": 50,
  "type": "pay",
  "description": "Lite-Pay",
  "payer": {
    "fundsource_lite_id": "fs_Mock14charID"
  },
  "upi_credentials": {
    "ARQC": "{\"type\":\"ARQC\",\"subType\":\"initial\",\"data\":{\"encryptedBase64String\":\"encrypted_string\",\"code\":\"NPCI-LITE\"}}"
  },
  "payees": [
    {
      "vpa": "acme.corp@rzp"
    }
  ]
}'

{
  "entity": "upi.payment",
  "upi_transaction_id": "RZPc2ed455b797e4add8392110cfc528acc",
  "reference_id": "ord_somfv432nsa",
  "upi_customer_reference_number": "804813039157",
  "upi_reference_url": "https://www.test.com",
  "upi_reference_category": "00",
  "upi_initiation_mode": "00",
  "upi_purpose_code": "44",
  "currency": "INR",
  "amount": 100,
  "type": "pay",
  "description": "flight tickets",
  "payer": {
    "fundsource_lite": {
      "fundsource_lite_id": "lite_Mock14charID",
      "upi_lite_reference_number": "1234567890",
      "upi_lite_credentials": {
        "ARQC": "string"
      }
    },
    "name": "Gaurav Kumar",
    "mcc": "0000",
    "response_code": "00",
    "reversal_response_code": "00"
  },
  "payees": [
    {
      "vpa": "acme.corp@rzp",
      "fundsource": {
        "ifsc": "HDFC0000058",
        "masked_account_number": "XXXXXXXXXXX6000"
      },
      "name": "AcmeCorp Pvt. Ltd.",
      "mcc": "6765",
      "upi_response_code": "00",
      "upi_reversal_response_code": "00"
    }
  ],
  "status": "success",
  "created_at": "1653915355",
  "updated_at": "1691097057"
}

Request Parameters

string

required

Unique UPI transaction id.

string

Merchant reference id.

enum

Indicates the 2-digit code defined by NPCI. Possible values:

00: Default - When no specific code is assigned or for general default scenarios.
01: QR Code - For making payments by scanning a standard QR code.
02: Secure QR Code - For payments that require additional security with QR codes.
03: Bharat QR Code - For interoperable payments across various payment networks using Bharat QR.
04: Intent - For payments initiated by an intent from an application or browser.
05: Secure Intent - For payments initiated by a secure intent from an app or browser.
06: NFC (Near Field Communication) - For contactless payments using NFC technology.
07: BLE (Bluetooth) - For payments made through Bluetooth Low Energy technology.
08: UHF (Ultra High Frequency) - For payments made using UHF technology, typically for toll payments.
09: Aadhaar - For payments authenticated using an Aadhaar number and biometric verification.
10: SDK (Software Development Kit) - For payments initiated through an SDK embedded in an app.
11: UPI-Mandate - For setting up recurring payments or mandates using UPI.
12: FIR (Foreign Inward Remittance) - For receiving remittances from foreign countries.
13: QR Mandate - For setting up recurring payments using a QR code.
14: BBPS - For making bill payments through the Bharat Bill Payment System.

enum

The 2-digit code defined by NPCI present in the intent URL or QR codes. Possible values:

01: SEBI
02: AMC
03: Travel
04: Hospitality
05: Hospital
06: Telecom
07: Insurance
08: Education
09: Gifting
10: BBPS
11: Global UPI
12: Metro ATM QR
13: Non-metro ATM QR
14: Standing Instruction
15: Corporate disbursement

string

required

The purpose of the payout.

object

The device details.

string

The IP address of the device.

string

The location coordinates of the device. For example, 12.9667,77.5667.

string

required

The currency in which the payment should be made by the customer. For example, INR.

integer

required

The amount to be paid by the customer in currency subunits. For example, if the amount is ₹100, enter 10000

string

required

Type of transaction. Always pay.

string

Description of the payment.

string

required

Payer details.

string

required

Fundsource Lite id of the sender.

object

required

ARQC encrypted credential for authorisation.

string

Authentication Response Code credential.payees mandatory : string Payee details.vpa mandatory : string Target recipient’s VPA address.

Response Parameters

string

Name of entity. Here it is, upi.payment.

string

UPI transaction id generated.

string

Merchant reference id.

string

Customer Reference number at NPCI.

string

URL for the payment reference.

string

UPI Reference Category Code.

enum

Indicates the 2-digit code defined by NPCI. Possible values:

00: Default - When no specific code is assigned or for general default scenarios.
01: QR Code - For making payments by scanning a standard QR code.
02: Secure QR Code - For payments that require additional security with QR codes.
03: Bharat QR Code - For interoperable payments across various payment networks using Bharat QR.
04: Intent - For payments initiated by an intent from an application or browser.
05: Secure Intent - For payments initiated by a secure intent from an app or browser.
06: NFC (Near Field Communication) - For contactless payments using NFC technology.
07: BLE (Bluetooth) - For payments made through Bluetooth Low Energy technology.
08: UHF (Ultra High Frequency) - For payments made using UHF technology, typically for toll payments.
09: Aadhaar - For payments authenticated using an Aadhaar number and biometric verification.
10: SDK (Software Development Kit) - For payments initiated through an SDK embedded in an app.
11: UPI-Mandate - For setting up recurring payments or mandates using UPI.
12: FIR (Foreign Inward Remittance) - For receiving remittances from foreign countries.
13: QR Mandate - For setting up recurring payments using a QR code.
14: BBPS - For making bill payments through the Bharat Bill Payment System.

enum

The 2-digit code defined by NPCI present in the intent URL or QR codes. Possible values:

01: SEBI
02: AMC
03: Travel
04: Hospitality
05: Hospital
06: Telecom
07: Insurance
08: Education
09: Gifting
10: BBPS
11: Global UPI
12: Metro ATM QR
13: Non-metro ATM QR
14: Standing Instruction
15: Corporate disbursement

string

Currency for transaction (INR).

string

Transaction amount in paisa.

string

Transaction type.

string

Payment description.

object

Payer details.

string

Indicates the Lite details.

string

Fundsource Lite id.

string

Reference number of Lite.

string

Contains encrypted ARPC proof.

string

Authentication Response Code credential.

string

Payer name.

string

Merchant Category Code.

string

Response code from UPI.

string

Reversal response code.

array

List of payee objects.

string

Payee’s VPA.

object

Payee’s bank fundsource.

string

Payee’s IFSC code.

string

Masked account number.

string

Payee name.

string

Merchant Category Code for payee.

string

UPI response code for payee.

string

Reversal response code.

string

Transaction status. Possible values:

created
pending
success
failed

integer

UNIX timestamp at which the payment was created.

integer

UNIX timestamp at which the payment was updated.

​Request Parameters

​Response Parameters

Request Parameters

Response Parameters