PayU Integration Lab

PayU Hosted Cross Border Payment

Configuration Settings

Cross-Border Payment Alert: Ensure your PayU account is enabled for international transactions and comply with RBI guidelines for cross-border payments.

Use Your Merchant UAT Key & Salt (for testing with test/sandbox credentials provided by PayU payments)

Custom Merchant Key *

Custom Merchant Salt *

Payment Type *

One-Time Payment

Single transaction payment

Subscription Payment

Recurring payment setup

Subscription Configuration

Billing Amount * Amount to be charged per billing cycle

Billing Currency * Currency is fixed to INR

Billing Cycle *

Billing Interval *

Payment Start Date * Select today's date or future dates only. Note: For eNACH payments, select tomorrow's date.

Payment End Date *

SI (Stored Instrument) (Pre-filled) Mandatory for subscription payments (always 1)

API Version (Pre-filled) Mandatory for subscription payments (always 7)

Note: For subscription payments, you may need to select 'Net Banking' if required by your bank.

Enforce Payment Methods (Optional)

Credit Cards

Debit Cards

Net Banking

UPI

Enable Saved Card Feature (Optional)

User Credentials

0/50

Format: MerchantKey:UniqueUserIdentifier (e.g., a4vGC2:user123) - Used for card tokenization and managing saved cards

Payment Details

Transaction ID (Auto-Generated from Back-end - Non Editable) 0/25

Fill all form fields with predefined test data

Amount *

Product Info *

0/100

Customer Details

First Name *

0/60

Last Name *

0/20

Email *

0/50

Phone (10 digits) *

Billing Address

PACB Requirement: Billing address is mandatory for cross-border payments.

Address Line 1 *

0/100

Address Line 2 (Optional)

0/100

City *

0/50

State *

0/50

Country *

0/50

ZIP Code *

0/20

Buyer Type (Optional)

UDF Parameters (User Defined Fields)

UDF Information: These fields provide additional transaction details required for compliance and processing.

UDF1 - PAN Number (Optional)

0/255

UDF2 - Additional Info (Optional)

0/255

UDF3 - Buyer's DOB (Recommended)

0/255

UDF4 - Seller Name (Optional)

0/255

UDF5 - Invoice ID *

0/255

Enable UDF Params (UDF7 & UDF8) for Import/Export Compliance Check this to include additional cross-border compliance parameters (Import/Export Code & Airway Bill Number). Uncheck for backward compatibility.

UDF Parameters (Subscription)

Subscription UDF Requirements: These fields are specifically required for subscription payments.

Conditional Validation:

If UPI payment method is enforced: UDF3 is mandatory
If other payment methods (not UPI) are enforced: UDF5 is mandatory
If no payment method is enforced: Use Udf update API with respect to the paymode.

UDF1 - PAN & DOB (Required if AD bank requests)

0/255

Format: PAN||DOB (DD/MM/YYYY)

UDF2 - Additional Info (Optional)

0/255

UDF3 - Invoice ID & Merchant Name (Required if UPI enforced)

0/255

Format: InvoiceID||MerchantName (Mandatory when UPI is enforced)

UDF4 - Additional Field (Optional)

0/255

UDF5 - Additional Field (Required if non-UPI payment enforced)

0/255

Redirect URLs

Success URL *

0/255

Failure URL *

0/255

Debug Information

CURL Command

PayU Hosted Checkout

Configuration Settings

PreBuilt Checkout: PayU's standard checkout page with built-in payment UI.

Use Your Merchant UAT Key & Salt (for testing with test/sandbox credentials provided by PayU payments)

Custom Merchant Key *

Custom Merchant Salt *

Enforce Payment Methods (Optional)

Credit Cards

Debit Cards

Net Banking

UPI

Enable Saved Card Feature (Optional)

User Credentials

0/50

Format: MerchantKey:UniqueUserIdentifier (e.g., a4vGC2:user123) - Used for card tokenization and managing saved cards

Payment Details

Transaction ID (Auto-Generated from Back-end - Non Editable) 0/25

Fill all form fields with predefined test data

Amount *

Product Info *

0/100

Customer Details

First Name *

0/60

Last Name (Optional)

0/20

Email *

0/50

Phone (10 digits) *

Address Details (Optional)

Address Line 1 (Optional)

0/100

Address Line 2 (Optional)

0/100

City (Optional)

0/50

State (Optional)

0/50

Country (Optional)

0/50

ZIP Code (Optional)

0/20

UDF Parameters (Optional)

UDF Information: User Defined Fields for custom data - all optional.

UDF1 (Optional)

0/255

UDF2 (Optional)

0/255

UDF3 (Optional)

0/255

UDF4 (Optional)

0/255

UDF5 (Optional)

0/255

Redirect URLs

Success URL *

0/255

Failure URL *

0/255

Debug Information

CURL Command

PayU Hosted Checkout Subscription

Configuration Settings

Subscription/Recurring Payment: This flow is for setting up recurring payments with customer consent.

Use Your Merchant UAT Key & Salt (for testing with test/sandbox credentials provided by PayU payments)

Custom Merchant Key *

Custom Merchant Salt *

Subscription Configuration

Billing Amount * Amount to be charged per billing cycle

Billing Currency * Currency is fixed to INR

Billing Cycle *

Billing Interval *

Payment Start Date * Select today's date or future dates only. Note: For eNACH payments, select tomorrow's date.

Payment End Date *

SI (Stored Instrument) (Pre-filled) Mandatory for subscription payments (always 1)

API Version (Pre-filled) Mandatory for subscription payments (always 7)

Enforce Payment Methods (Optional)

Credit Cards

Debit Cards

Net Banking (eNACH)

UPI

Payment Details

Transaction ID (Auto-Generated from Back-end - Non Editable) 0/25

Fill all form fields with predefined test data

Amount * Note: For eNACH payments, use transaction amount as 1.

Product Info *

0/100

Customer Details

First Name *

0/60

Last Name (Optional)

0/20

Email *

0/50

Phone (10 digits) *

Address Details (Optional)

Address Line 1 (Optional)

0/100

Address Line 2 (Optional)

0/100

City (Optional)

0/50

State (Optional)

0/50

Country (Optional)

0/50

ZIP Code (Optional)

0/20

UDF Parameters

UDF1 (Optional)

0/255

UDF2 (Optional)

0/255

UDF3 (Optional)

0/255

UDF4 (Optional)

0/255

UDF5 (Optional)

0/255

Redirect URLs

Success URL *

0/255

Failure URL *

0/255

Debug Information

CURL Command

PayU Hosted Checkout TPV

Configuration Settings

TPV Payment: Third Party Verification for Net Banking and UPI transactions with beneficiary account validation.

Use Your Merchant UAT Key & Salt (for testing with test/sandbox credentials provided by PayU payments)

Custom Merchant Key *

Custom Merchant Salt *

Enforce Payment Methods (Optional)

UPI

Net Banking

Payment Details

Transaction ID (Auto-Generated from Back-end - Non Editable) 0/25

Fill all form fields with predefined test data

Amount *

Product Info *

0/100

Customer Details

First Name *

0/60

Last Name (Optional)

0/20

Email *

0/50

Phone (10 digits) *

Address Details (Optional)

Address Line 1 (Optional)

0/100

Address Line 2 (Optional)

0/100

City (Optional)

0/50

State (Optional)

0/50

Country (Optional)

0/50

ZIP Code (Optional)

0/20

Beneficiary Details (TPV Validation)

Note: You can add up to 4 beneficiary accounts. Multiple accounts should be separated by pipe (|) symbol in the same order.

Example:
Account: 919013353419388|919013353419387
IFSC: UTIB9992478|UTIB9992478

Beneficiary Account Number(s) * For multiple accounts, separate with pipe (|) - Max 4 accounts

IFSC Code(s) * For multiple IFSCs, separate with pipe (|) in same order

TPV Configuration

API Version * Mandatory for TPV payments (always 6)

UDF Parameters (User Defined Fields)

UDF Information: All UDF fields are optional for TPV transactions. Use these fields to pass additional transaction-specific data.

UDF1 (Optional)

0/255

UDF2 (Optional)

0/255

UDF3 (Optional)

0/255

UDF4 (Optional)

0/255

UDF5 (Optional)

0/255

Redirect URLs

Success URL *

0/255

Failure URL *

0/255

PayU Hosted Checkout UPI OTM

Configuration Settings

UPI One Time Mandate: Create a one-time pre-authorization for UPI payments. The mandate is valid for the specified date range (max 14 days).

Use Your Merchant UAT Key & Salt (for testing with test/sandbox credentials provided by PayU payments)

Custom Merchant Key *

Custom Merchant Salt *

Mandate Date Configuration

Payment Start Date * Select current or future date only

Payment End Date * Max 14 days from start date

API Version * Mandatory for UPI OTM (always 7)

Pre-Authorize * Mandatory for UPI OTM (always 1)

Payment Details

Amount Condition: For Success Amount >= Rs. 17,000

Transaction ID (Auto-Generated from Back-end - Non Editable) 0/25

Fill all form fields with predefined test data

Amount *

Product Info *

0/100

Customer Details

First Name *

0/60

Last Name (Optional)

0/20

Email *

0/50

Phone (10 digits) *

Address Details (Optional)

Address Line 1 (Optional)

0/100

Address Line 2 (Optional)

0/100

City (Optional)

0/50

State (Optional)

0/50

Country (Optional)

0/50

ZIP Code (Optional)

0/20

UDF Parameters

UDF1 (Optional)

0/255

UDF2 (Optional)

0/255

UDF3 (Optional)

0/255

UDF4 (Optional)

0/255

UDF5 (Optional)

0/255

Redirect URLs

Success URL *

0/255

Failure URL *

0/255

Debug Information

CURL Command

PayU Hosted Checkout PreAuth

Configuration Settings

Pre-Authorization Payment: Amount will be blocked on customer's card but not captured immediately.

Use Your Merchant UAT Key & Salt (for testing with test/sandbox credentials provided by PayU payments)

Custom Merchant Key *

Custom Merchant Salt *

Enforce Payment Methods *

Credit Cards

Pre-Authorize * Mandatory for PreAuth flow (always 1)

Payment Details

Transaction ID (Auto-Generated from Back-end - Non Editable) 0/25

Fill all form fields with predefined test data

Amount *

Product Info *

0/100

Customer Details

First Name *

0/60

Last Name (Optional)

0/20

Email *

0/50

Phone (10 digits) *

Address Details (Optional)

Address Line 1 (Optional)

0/100

Address Line 2 (Optional)

0/100

City (Optional)

0/50

State (Optional)

0/50

Country (Optional)

0/50

ZIP Code (Optional)

0/20

UDF Parameters

UDF1 (Optional)

0/255

UDF2 (Optional)

0/255

UDF3 (Optional)

0/255

UDF4 (Optional)

0/255

UDF5 (Optional)

0/255

Redirect URLs

Success URL *

0/255

Failure URL *

0/255

Debug Information

CURL Command

Checkout Plus

Configuration Settings

Checkout Plus: JavaScript SDK-based payment with modal checkout experience.

Use Your Merchant UAT Key & Salt (for testing with test/sandbox credentials provided by PayU payments)

Custom Merchant Key *

Custom Merchant Salt *

Enforce Payment Methods (Optional)

Credit Cards

Debit Cards

Net Banking

UPI

Payment Details

Transaction ID (Auto-Generated from Back-end - Non Editable) 0/25

Fill all form fields with predefined test data

Amount *

Product Info *

0/100

Customer Details

First Name *

0/60

Last Name (Optional)

0/20

Email *

0/50

Phone (10 digits) *

Address Details (Optional)

Address Line 1 (Optional)

0/100

Address Line 2 (Optional)

0/100

City (Optional)

0/50

State (Optional)

0/50

Country (Optional)

0/50

ZIP Code (Optional)

0/20

UDF Parameters (Optional)

UDF Information: User Defined Fields for custom data - all optional.

UDF1 (Optional)

0/255

UDF2 (Optional)

0/255

UDF3 (Optional)

0/255

UDF4 (Optional)

0/255

UDF5 (Optional)

0/255

Callback URLs

Success URL *

0/255

Failure URL *

0/255

Debug Information

CURL Command

PayU Hosted Checkout Split Payment

Configuration Settings

About Split Payment: Distribute a single transaction amount across multiple merchant accounts. Supports both absolute amount and percentage-based splitting.
Use Cases: Marketplace platforms, commission-based transactions, aggregator models.

Use Your Merchant UAT Key & Salt (for testing with test/sandbox credentials provided by PayU payments)

Custom Merchant Key *

Custom Merchant Salt *

Payment Details

Transaction ID (Auto-Generated from Back-end - Non Editable) 0/25

Fill all form fields with predefined test data

Amount (INR) * Total transaction amount

Product Info *

Customer Information

First Name *

Last Name (Optional)

Email *

Phone *

Address Information (Optional)

Address Line 1

Address Line 2

City

State

Country

Zip Code

UDF Parameters (Optional)

UDF Information: User Defined Fields for custom data - all optional.

UDF1 (Optional)

UDF2 (Optional)

UDF3 (Optional)

UDF4 (Optional)

UDF5 (Optional)

Split Payment Configuration *

Important: Split merchant keys must be pre-configured and linked to your parent merchant account. Contact PayU support for split setup.

Split Type *

Amount Based (Absolute) Specify exact amounts in INR Percentage Based Specify percentage of total amount

Split Details (Child Merchants)

Enforce Payment Methods (Optional)

Credit Card Debit Card Net Banking UPI

Redirect URLs

Success URL *

Failure URL *

Debug Information

CURL Command

PayU Hosted Checkout Bank Offers

Configuration Settings

About Bank Offers: Test instant discount and cashback offers with SKU/item-based cart details. Supports both predefined test scenarios and custom cart configurations.
Note: Minimum transaction amount ₹20,000 required for bank offers (For Predefined Credentials).

Use Your Merchant UAT Key & Salt (for testing with test/sandbox credentials provided by PayU payments)

Custom Merchant Key *

Custom Merchant Salt *

Payment Details

Transaction ID (Auto-Generated from Back-end - Non Editable) 0/25

Fill all form fields with predefined test data

Amount (INR) * ⚠️ Minimum amount ₹20,000 required for Bank Offers (For Predefined Credentials)

Product Info *

Offer Key (Optional) For non-SKU based offers. Leave blank if using SKU details or to let PayU automatically apply the best available offer.

User Token (Optional) User token for bank offer transactions (both SKU and non-SKU)

SKU/Item Based Offers

Enable SKU Details: Add cart details with item-level information to test bank offers. Leave unchecked for standard payment without SKU offers.

Enable SKU/Item Based Offers

Customer Information

First Name *

Last Name (Optional)

Email *

Phone (10 digits) *

Address Information (Optional)

Address Line 1 (Optional)

Address Line 2 (Optional)

City (Optional)

State (Optional)

Country (Optional)

ZIP Code (Optional)

UDF Parameters (Optional)

UDF Information: User Defined Fields for custom data - all optional.

UDF1 (Optional)

UDF2 (Optional)

UDF3 (Optional)

UDF4 (Optional)

UDF5 (Optional)

Enforce Payment Methods (Optional)

Enforce Payment Methods: Select specific payment methods to show on the payment page. Leave all unchecked to show all available payment methods.

Credit Card Debit Card Net Banking UPI EMI

Redirect URLs

Success URL *

Failure URL *

PayU Integration Lab BETA

Select a Payment Flow

PayU Hosted Checkout

Checkout Plus

Subscription Payment

TPV Payment

UPI OTM

Split Payment

Cross Border Payment

Bank Offers

PreAuth Card Flow

PayU Hosted Cross Border Payment

Configuration Settings

One-Time Payment

Subscription Payment

Subscription Configuration

Payment Details

Customer Details

Billing Address

UDF Parameters (User Defined Fields)

Cross-Border Compliance Parameters

UDF Parameters (Subscription)

Cross-Border Compliance Parameters

Redirect URLs

Debug Information

CURL Command

PayU Hosted Checkout

Configuration Settings

Payment Details

Customer Details

Address Details (Optional)

UDF Parameters (Optional)

Redirect URLs

Debug Information

CURL Command

PayU Hosted Checkout Subscription

Configuration Settings

Subscription Configuration

Payment Details

Customer Details

Address Details (Optional)

UDF Parameters

Redirect URLs

Debug Information

CURL Command

PayU Hosted Checkout TPV

Configuration Settings

Payment Details

Customer Details

Address Details (Optional)

Beneficiary Details (TPV Validation)

TPV Configuration

UDF Parameters (User Defined Fields)

Redirect URLs

Debug Information

CURL Command

PayU Hosted Checkout UPI OTM

Configuration Settings

Mandate Date Configuration

Payment Details

Customer Details

Address Details (Optional)

UDF Parameters

Redirect URLs

Debug Information

CURL Command

PayU Hosted Checkout PreAuth

Configuration Settings

Payment Details

Customer Details

Address Details (Optional)

UDF Parameters

Redirect URLs

Debug Information

CURL Command

Checkout Plus

Configuration Settings

Payment Details

Customer Details

Address Details (Optional)