About PayU India

General information about payment methods via PayU India

Logo

Info

With the integration of PayU biz India merchants open the door to a rapidly growing e-commerce market. Only 30% of online customers in India have access to internationally accepted payment methods. With the integration of PayU biz via merchants can offer 76 local payment methods to serve the majority of customers. This comprises of online transfers, credit and debit cards, eWallets and cash-in payments.

Type

Mixed payment methods

Card Scheme
MasterCard
VISA
AMEX
Diners
RuPay

Process flow charts

Process flow for PayU India WebCheckout

Process flow PayU India via form interface payssl.aspx

Process flow PayU India via server-to-server interface direct.aspx

Configuration

For setting up the merchant for PayUIndia the needs some information. These you can find in the PayU backend system for your own merchant account. Execute the command MyAccount and System Settings.

Documentation > PayU India > image2019-8-15_21-41-2.png

You need Salts and Login Alias from the system settings.

Documentation > PayU India > image2019-8-15_21-41-10.png

Transmit both values on a safe way to .

interface

Payment with PayU India via form interface

To make a payment with PayU in India, please use the following URL:

payuindia.aspx

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	O	Merchant’s unique reference number (Must be unique for PayU)	Eindeutige Referenznummer des Händlers (Muss für PayU eindeutig sein)

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..100	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
PayType	ans..25	O	Name of payment method to be executed	Name der auszuführenden Zahlungsart

Key	Format	CND	Description	Beschreibung
			Customer data	Kundendaten
FirstName	ans..60	M	First name of the customer	Vorname des Kunden
LastName	ans..20	M	Last name of the customer	Nachname des Kunden
AddrStreet	ans..100	O	Customer’s street name	Straßenname des Kunden
AddressAddition	ans..100	O	Customer´s address addition	Adresszusatz des Kunden
AddrCity	ans..50	O	Town/city of the customer	Ortsname des Kunden
AddrZip	ans..20	O	Postcode of the customer	Postleitzahl des Kunden
AddrState	ans..50	O	Customer’s federal state	Bundesland des Kunden
AddrCountryCode	a..3	O	Country code of the customer according to ISO 3166; alphanumeric 2 or 3 characters. Presently only India allowed.	Ländercode des Kunden gemäß ISO 3166; alphanumerisch 2- oder 3-stellig. Derzeit nur Indien möglich.
CustomerID	ans..128	O	Customer number. If customer number is not submitted instead the email address is transferred to PayU. The customer number is used to identify the customer in order to be able to select credit card data which might be stored with PayU.	Kundennummer. Wenn keine Kundennummer übergeben wird, wird die E-Mail-Adresse als Kundennummer an PayU übergeben. Die Kundennummer dient zur Identifizierung des Kunden, um ggf. bei PayU gespeicherte Kreditkarten im Formular auswählen zu können.
eMail	ans..128	O	Email address of the customer	E-Mail-Adresse des Kunden
Phone	ans..40	O	Customer’s phone number	Telefonnummer des Kunden
			Credit card payment (in case of credit card payment the following parameters are mandatory)	Kreditkartenzahlung (bei einer Kreditkartenzahlung sind die nachfolgenden Werte Pflicht)
CCNr	n..19	C	Credit card number at least 12-digit, numerical without spaces. You can optionally transmit also a pseudo card number (PCN)	Kreditkartennummer mind. 12-stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer übergeben.
CCCVC	n..4	C	Card verification number: The last 3 digits on the signature strip of the credit card. 4 numbers in the case of American Express.	Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei American Express 4 Ziffern.
CCExpiry	n6	C	Expiry date of the credit card in the format YYYYMM, e.g. 202807	Ablaufdatum der Kreditkarte im Format YYYYMM, z.B. 202807
CCBrand	a..22	C	Card brand: only VISA, MasterCard, AMEX, Diners, RuPay allowed. Please note the spelling!	Kartenmarke: nur VISA, MasterCard, AMEX, Diners, RuPay möglich. Bitte beachten Sie die Schreibweise!
CreditCardHolder	ans..60	C	Name of the credit card holder	Name des Kreditkarteninhabers

Parameters for payments with PayU India WebCheckout

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Key	Format	CND	Description	Beschreibung
TransactionID	ans..64	O	Transaction ID from PayU	Transaktions-ID von PayU
Channel	a..5	M	Name of payment category to be used with the following possible values: ‘NB’ for Net Banking, ‘CC’ for Credit Card, ‘DC’ for Debit Card, ‘CASH’ for Cash Card, ‘EMI’ for EMI, ‘wallet’ for PayUMoney, ‘IVR’ for IVR, ‘COD’ for Cash On Delivery	Name der zu verwendenden Zahlungskategorie mit folgenden möglichen Werten: ‘NB’ für Net Banking, ‘CC’ für Credit Card, ‘DC’ für Debit Card, ‘CASH’ für Cash Card, ‘EMI’ für EMI, ‘wallet’ für PayUMoney, ‘IVR’ für IVR, ‘COD’ für Cash On Delivery
BankCode	a..5	M	Identification of the payment option used for the transaction: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR	Identifikation der verwendeten Zahlungsoption für die Transaktion: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR
Brand	a..5	C	Specific card type: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR	Bestimmter Kartentyp: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR

Return parameters for URLSuccess, URLFailure and URLNotify with PayU India WebCheckout

Credit card payment with PayU India via form interface

In order to execute a credit card payment in India with PayU India via a form, please use the following URL:

payssl.aspx

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	M	Unique reference number which appears on your printed card account or in the EPA-file (Electronic Payment Advice). Format must be mutually agreed beforehand with !	Eindeutige Referenznummer, die auf Ihrer gedruckten Kartenabrechnung oder in der EPA-Datei (Electronic Payment Advice) erscheint. Das Format muss vorher mit abgestimmt werden!

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..100	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
RTF	a1	O	„I“ for initializing recurrent payments	„I“ zur Initialisierung von wiederkehrenden Zahlungen

Key	Format	CND	Description	Beschreibung
			Customer data	Kundendaten
FirstName	ans..60	M	First name of the customer	Vorname des Kunden
LastName	ans..20	M	Last name of the customer	Nachname des Kunden
AddrStreet	ans..100	O	Customer’s street name	Straßenname des Kunden
AddressAddition	ans..100	O	Customer´s address addition	Adresszusatz des Kunden
AddrCity	ans..50	O	Town/city of the customer	Ortsname des Kunden
AddrZip	ans..20	O	Postcode of the customer	Postleitzahl des Kunden
AddrState	ans..50	O	Customer’s federal state	Bundesland des Kunden
AddrCountryCode	a..3	O	Country code of the customer according to ISO 3166; alphanumeric 2 or 3 characters. Presently only India allowed.	Ländercode des Kunden gemäß ISO 3166; alphanumerisch 2- oder 3-stellig. Derzeit nur Indien möglich.
CustomerID	ans..128	O	Customer number. The customer number is used to identify the customer at PayU. If this is submitted the PayU stores the card number. If CustomerID is transmitted to PayUIndia.aspx for subsequent payments the customer only needs to input the CVC within the form.	Kundennummer. Die Kundennummer dient der Identifizierung des Kunden bei PayU. Wird diese übergeben, wird die Kartennummer bei PayU gespeichert. Wird die CustomerID bei Folgezahlungen an die PayUIndia.aspx übergeben, muss der Kunde nur noch den CVC im Formular eintragen.
eMail	ans..128	O	Email address of the customer	E-Mail-Adresse des Kunden
Phone	ans..40	O	Customer’s phone number	Telefonnummer des Kunden

Parameters for credit card payments with PayU India in India

Key

Format

CND

Description

Beschreibung

Language

a2

(enum)

M

Language code: <de> German, <al> Albanian, <at> Austrian, <cz/cs> Czech, <dk> Danish, <en> English, <fi> Finish, <fr> French, <gr> Greek, <hu> Hungarian, <it> Italian, <jp> Japanese, <nl> Dutch, <no> Norwegian, <pl> Polish, <pt> Portuguese, <ro> Romanian, <ru> Russian, <sp> Spanish, <se> Swedish, <sk> Slovakian, <sl> Slovenian, <tr> Turkey, <zh> Simplified Chinese.

No details means the language is German.

Sprachcode: <de> deutsch, <al> albanisch, <at> österreichisch, <cz/cs> tschechisch, <dk> dänisch, <en> englisch, <fi> finnisch, <fr> französisch, <gr> griechisch, <hu> ungarisch, <it> italienisch, <jp> japanisch, <nl> holländisch, <no> norwegisch, <pl> polnisch, <pt> portugiesisch, <ro> rumänisch, <ru> russisch, <tr> türkisch, <sp> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese

Ohne Angabe ist die Sprache Deutsch.

CCSelect

a..10

M

Determines preselected card type in the form: VISA, MasterCard, AMEX, Diners, RuPay

Bestimmt die vorausgewählte Kartenmarke im Formular: VISA, MasterCard, AMEX, Diners, RuPay

Layout parameters for forms for credit card payments with PayU India

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Key	Format	CND	Description	Beschreibung
CCBrand	a..22	O	In combination with PCNr: Name of credit card brand like Visa, MasterCard	In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard
CCExpiry	n6	O	In combination with PCNr: Expiry date of the credit card in the format YYYYMM.	In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM
MaskedPan	an..19	OC	Masked card number 6x4	Maskierte Kartennummer 6x4
TransactionID	ans..64	C	Transaction ID from PayU	Transaktions-ID von PayU
TokenExt	an..64	C	For recurring payments (RTF=I) the Token is transmitted for referencing the credit card data	Bei wiederkehrenden Zahlungen (RTF=I) wird der Token übergeben, um die Kreditkartendaten zu referenzieren
Channel	a..5	M	Name of payment category to be used with the following possible values: ‘NB’ for Net Banking, ‘CC’ for Credit Card, ‘DC’ for Debit Card, ‘CASH’ for Cash Card, ‘EMI’ for EMI, ‘wallet’ for PayUMoney, ‘IVR’ for IVR, ‘COD’ for Cash On Delivery	Name der zu verwendenden Zahlungskategorie mit folgenden möglichen Werten: ‘NB’ für Net Banking, ‘CC’ für Credit Card, ‘DC’ für Debit Card, ‘CASH’ für Cash Card, ‘EMI’ für EMI, ‘wallet’ für PayUMoney, ‘IVR’ für IVR, ‘COD’ für Cash On Delivery
BankCode	a..5	M	Identification of the payment option used for the transaction: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR	Identifikation der verwendeten Zahlungsoption für die Transaktion: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR
Brand	a..5	C	Specific card type: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR	Bestimmter Kartentyp: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR

Return parameters for URLSuccess, URLFailure and URLNotify with PayU India

Credit card payment via Server-to-Server connection

In order to execute a recurring credit card payment with PayU India in India via a server-to-server connection, please use the following URL:

direct.aspx

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	C	Merchant’s unique reference number (Must be unique for PayU). Mandatory for the initial payment of a new abo (RTF=I).	Eindeutige Referenznummer des Händlers (Muss für PayU eindeutig sein). Pflicht bei Initialzahlung eines neuen Abos (RTF=I).

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..100	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
RTF	a1	O	„I“ for initializing recurrent payments	„I“ zur Initialisierung von wiederkehrenden Zahlungen
CCNr	n..19	M	Pseudo card number	Pseudokartennummer
CCExpiry	n6	M	Credit card expiry date (YYYYMM), e.g. 202807	Ablaufdatum der Kreditkarte (YYYYMM), z.B. 202807
CCBrand	a..22	M	Card brand: only VISA, MasterCard, AMEX, Diners, RuPay. Please note the spelling!	Kartenmarke: VISA, MasterCard, AMEX, Diners, RuPay. Bitte beachten Sie die Schreibweise!
TokenExt	an..64	M	Token for referencing the credit card data with PayU	Der Token, um die Kreditkartendaten bei PayU zu referenzieren
TransactionID	ans..64	M	TransactionID from PayU which is returned with the initial payment (RTF=I)	Transaktions-ID von PayU, die bei der initialen Zahlung (RTF=I) zurückgeliefert wurde
CustomerID	ans..128	O	Customer number. If customer number is not submitted instead the email address is transferred to PayU. The customer number is used to identify the customer in order to be able to select credit card data which might be stored with PayU.	Kundennummer. Wenn keine Kundennummer übergeben wird, wird die E-Mail-Adresse als Kundennummer an PayU übergeben. Die Kundennummer dient zur Identifizierung des Kunden, um ggf. bei PayU gespeicherte Kreditkarten im Formular auswählen zu können.
eMail	ans..128	O	Email address of the customer	E-Mail-Adresse des Kunden

Parameters for credit card payments with PayU India via socket connection

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Key	Format	CND	Description	Beschreibung
Channel	a..5	M	Name of payment category to be used with the following possible values: ‘NB’ for Net Banking, ‘CC’ for Credit Card, ‘DC’ for Debit Card, ‘CASH’ for Cash Card, ‘EMI’ for EMI, ‘wallet’ for PayUMoney, ‘IVR’ for IVR, ‘COD’ for Cash On Delivery	Name der zu verwendenden Zahlungskategorie mit folgenden möglichen Werten: ‘NB’ für Net Banking, ‘CC’ für Credit Card, ‘DC’ für Debit Card, ‘CASH’ für Cash Card, ‘EMI’ für EMI, ‘wallet’ für PayUMoney, ‘IVR’ für IVR, ‘COD’ für Cash On Delivery
BankCode	a..5	M	Identification of the payment option used for the transaction: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR	Identifikation der verwendeten Zahlungsoption für die Transaktion: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR
Brand	a..5	C	Specific card type: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR	Bestimmter Kartentyp: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR

Result parameters for socket connection with PayU India

Credit with reference

credit.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..100	O	Description of refunded goods, unit prices, merchant’s comment etc.	Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.

Parameters for credit of credit card payments with PayU India via socket connection

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Response parameters for credit of credit card payments with PayU India via socket connection

Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing payments / credits with PayU India and which information can be found within the response file about the payment status.

Following table gives an overview of all batch versions that are possible for a specific action and their specialities:

Action	Version	Description	Beschreibung
Credit	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2.x	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)
Reverse	1.0 / 2.0	Standard version without return of parameter Code	Standardversion ohne Rückgabe von Parameter Code
	1.x / 2x.	with RefNr (valid for all versions other than 1.0)	mit RefNr (gilt für alle Versionen außer 1.0)

Description of the possible batch versions

The structure for a PayU India transaction within a Batch file to be submitted is as follows:

HEAD,<MerchantID>,<Date>,<Version>
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, CC for credit card

HEAD für Header, FOOT für Footer, CC für Kreditkarte

Action

a..20

M

The parameter Action defines the type of transaction:

Credit

Reverse

Der Action-Parameter definiert die Art der Transaktion:

Credit (Gutschrift)

Reverse (Storno)

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur INR, USD, GBP, CAD, EUR, AED, QAR, OMR, SGD, AUD, HKD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
RefNr	ns..30	O	Merchant’s unique reference number (Must be unique for PayU)	Eindeutige Referenznummer des Händlers (Muss für PayU eindeutig sein)

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks as follows:

HEAD,<MerchantID>,<Date>,<Version>
CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction: Credit Reverse	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift) Reverse (Storno)

Description of result parameters within the record for Batch files