CB-UPI

post

https://test.payu.in/_payment

Form Data

key

const

enum

required

The merchant key provided by PayU (merchant key used to authenticate the request).

Allowed:

txnid

string

required

Merchant transaction identifier (unique alphanumeric ID for the transaction).

amount

number

required

Transaction amount (rounded to two decimal places; must be ≥ Rs.1.00).

phone

string

required

Customer phone number (10 digits).

productinfo

string

required

Name/brief description of goods or services sold (max 100 characters).

firstname

string

required

Customer first name (max 60 characters).

string

required

Customer email ID.

lastname

string

required

Customer last name (max 20 characters).

const

enum

required

Payment method identifier (for UPI INTENT specify 'UPI').

Allowed:

bankcode

string

required

PayU bank/payment option code (for UPI Intent specify 'INTENT'; changes for specific intents).

surl

string

required

Success URL: URL where PayU will redirect on successful transaction.

furl

string

required

Failure URL: URL where PayU will redirect on failed transaction.

address1

string

Customer address line 1 (up to 100 characters; optional but recommended).

address2

string

Customer address line 2 (up to 100 characters; optional).

city

string

Customer city (max 50 characters; optional but recommended).

state

string

Customer state (max 50 characters; optional).

country

string

Customer country (max 50 characters; optional but recommended).

zipcode

string

required

Customer PIN code (6 digits; mandatory).

udf1

string

User-defined field 1 (conditional; for PACB: buyer's PAN number).

udf2

string

User-defined field 2 (optional; any custom info up to 255 characters).

udf3

string

User-defined field 3 (optional but recommended; buyer DOB in DD-MM-YYYY, up to 255 chars).

udf4

string

User-defined field 4 (mandatory for payment aggregators; end merchant legal entity name; for UPI should not be passed).

udf5

string

required

User-defined field 5 (mandatory; contains invoice ID/number issued to customer, up to 255 chars).

buyer_type_business

string

Binary flag for B2B cross-border transactions ('1' if buyer is a business; optional otherwise; included in hash if posted).

udf_params

string

JSON string for additional UDF values (e.g., udf7/import-export code, udf8/airway bill; must be included in hash if posted).

hash

string

required

SHA512 hash for request integrity (mandatory; calculated per specified hash formula and sequence).

txn_s2s_flow

const

enum

required

Numeric parameter specifying server-to-server flow (must be passed with value 4).

Allowed:

s2s_client_ip

string

required

Source IP of the user's device (mandatory; used for fraud detection/chargebacks).

s2s_device_info

string

required

User-agent/device info (mandatory; used for fraud detection/chargebacks).

upiAppName

string

required

Selected UPI app name for Specific Intent (mandatory for Specific Intent; expected enums like phonepe, googlepay, paytm, bhim, cred, amazonpay, whatsapp, genericintent for others).

curl

string

The Cancel URL, which is the page PayU will redirect to if the transaction is cancelled by customer.

vpa

string

The customer UPI handle provided by bank for UPI payments.

Headers

Content-Type

const

enum

required

Allowed:

Response

200

EXAMPLE QUESTIONS