About PayU Hub

General information about payment methods via PayU Hub


Logo

Info

PayU Hub allows to streamline and consolidate all aspects of payment stack into one, customizable payment platform. The new platform allows to integrate local and global payments together and enter new markets with minimal friction.

PayU Hub enables a single and direct connection to popular global and local payment methods around the world. With hundreds of available payment methods, merchants can localize effectively and meet customers where they are.

TypeMixed payment methods
Card Scheme

MasterCard

VISA

AMEX

DINERS

RuPay

Process flow charts

Process flow PayU Hub WebCheckout


Process flow for PayU Hub Refund ‒ Asynchronous


Configuration

Credentials

For setting up the merchant for PayU Hub the needs some information. These you can find in the PayU backend system ( https://control.paymentsos.com ) for your own merchant account under Account / Business Units.



You need App ID, Public API Key and Private API Key from the system settings.

Transmit the values on a safe way to .

Webhook setup

On PayU backend system ( https://control.paymentsos.com ) under Account / Webhooks you should setup webhooks as follows.


interface


Payment with PayU Hub via form interface

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

payuhub.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

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise usw.

PayTypeans..25O

Name of payment method to be executed.

In case the parameter is empty, the customer will be redirected to PayU Hub payment page. On PayU Hub payment page the customer can choose a payment method from list of available payment methods.

Possible values for the parameter in case of PayU India as Provider:

  • Challan
  • Dynamic_QR
  • Netbanking   
  • UPI
  • Airtel Money   
  • Amazon pay
  • FreeCharge
  • JioMoney    
  • Ola Money   
  • Paytm
  • Pay Zapp
  • Phonepe

Possible values for the parameter in case of PayU lyzico as Provider:

  • Pay_with_iyzico

Name der auszuführenden Zahlungsmethode.

Falls der Parameter leer ist, wird der Kunde zur Zahlungsseite von PayU Hub weitergeleitet. Auf der Zahlungsseite von PayU Hub kann der Kunde eine Zahlungsmethode aus der Liste der verfügbaren Zahlungsmethoden auswählen.

Mögliche Werte für den Parameter bei PayU India als Provider:

  • Challan
  • Dynamic_QR
  • Netbanking   
  • UPI
  • Airtel Money   
  • Amazon pay
  • FreeCharge
  • JioMoney    
  • Ola Money   
  • Paytm
  • Pay Zapp
  • Phonepe

Mögliche Werte für den Parameter bei PayU lyzico als Provider:

  • Pay_with_iyzico
BankCodeans..25CMandatory in case PayType=NetbankingPflicht bei PayType=Netbanking

Key

Format

CND

Description

Beschreibung




Customer dataKundendaten

bdFirstName

ans..60

C

First name of the customer

Mandatory in case Provider=PayU India

Vorname des Kunden

bdLastName

ans..20

C

Last name of the customer

Mandatory in case Provider=PayU India

Nachname des Kunden

bdStreet

ans..100

O

Customer’s street name

Straßenname des Kunden

bdStreet2

ans..100

O

Customer´s address addition

Adresszusatz des Kunden

bdCity

ans..50

O

Town/city of the customer

Ort des Kunden

bdZIP

ans..20

O

Postcode of the customer

Postleitzahl des Kunden

bdState

ans..50

O

Customer’s federal state

Bundesstaat des Kunden

bdCountryCode

a..3

O

Country code of the customer according to ISO 3166; alphanumeric 2 or 3 characters

Ländercode des Kunden gemäß ISO 3166; alphanumerisch 2 oder 3 Zeichen

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.

Wird die Kundennummer nicht angegeben, wird stattdessen die E-Mail-Adresse an PayU übermittelt.

Die Kundennummer dient der Identifizierung des Kunden, um ggf. bei PayU hinterlegte Kreditkartendaten auswählen zu können.

bdEmail

ans..128

C

Email address of the customer

Mandatory in case Provider=PayU India, Provider=PayU Mexico, Provider=PayU Single (Poland), Provider=PayU iyzico

E-Mail-Adresse des Kunden

Obligatorisch falls Provider=PayU India

bdPhone

ans..40

C

Customer’s phone number

Mandatory in case Provider=PayU India

Telefonnummer des Kunden

Obligatorisch falls Provider=PayU India




Credit card payment (in case of credit card payment the following parameters are mandatory)Kreditkartenzahlung (bei Kreditkartenzahlung sind die folgenden Parameter obligatorisch)

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 mindestens 12-stellig, numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer (PCN) übermitteln.

CCCVC

n..4

C

Card verification number: The last 3 digits on the signature strip of the credit card. 4 digits in the case of American Express.

Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsstreifen der Kreditkarte. 4 Ziffern bei American Express.

CCExpiry

n6

C

Expiry date of the credit card in the format YYYYMM, e.g. 202807

Ablaufdatum der Kreditkarte im Format JJJJMM, 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 erlaubt.

Bitte beachten Sie die Schreibweise!

CreditCardHolder

ans..60

C

Name of the credit card holder

Name des Kreditkarteninhabers

Parameters for payments with PayU Hub WebCheckout


Key

Format

CND

Description

Beschreibung

CodeExtn..10O

Error code from PayU, if agreed with

Fehlercode von PayU, wenn mit abgesprochen

ErrorTextans..256O

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 PayUTransaktions-ID von PayU
Channela..5MName 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 DeliveryName der zu verwendenden Zahlungskategorie mit den folgenden möglichen Werten: 'NB' für Net Banking, 'CC' für Kreditkarte, 'DC' für Debitkarte, 'CASH' für Geldkarte, 'EMI' für EMI, 'Wallet' für PayUMoney, 'IVR' für IVR, 'COD' für Nachnahme
BankCodea..5MIdentification of the payment option used for the transaction: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINRIdentifizierung der für die Transaktion verwendeten Zahlungsoption: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR
Branda..5CSpecific card type: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINRSpezifischer Kartentyp: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR

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



Credit card payment with PayU Hub via form interface

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

payssl.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

M

Description of purchased goods, unit prices etc.

Beschreibung der gekauften Waren, Einzelpreise usw.

RTFa1O„I“ for initializing recurrent payments„I“ zum Initialisieren wiederkehrender Zahlungen

Key

Format

CND

Description

Beschreibung




Customer dataKundendaten

bdFirstName

ans..60

C

First name of the customer

Mandatory in case Provider=PayU India

Vorname des Kunden

bdLastName

ans..20

C

Last name of the customer

Mandatory in case Provider=PayU India

Nachname des Kunden

bdStreet

ans..100

O

Customer’s street name

Straßenname des Kunden

bdStreet2

ans..100

O

Customer´s address addition

Adresszusatz des Kunden

bdCity

ans..50

O

Town/city of the customer

Ort des Kunden

bdZIP

ans..20

O

Postcode of the customer

Postleitzahl des Kunden

bdState

ans..50

O

Customer’s federal state

Bundesstaat des Kunden

bdCountryCode

a..3

O

Country code of the customer according to ISO 3166; alphanumeric 2 or 3 characters

Ländercode des Kunden gemäß ISO 3166; alphanumerisch 2 oder 3 Zeichen

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 PayUHub.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 übermittelt, speichert PayU die Kartennummer.

Wird die CustomerID für Folgezahlungen an PayUHub.aspx übermittelt, muss der Kunde lediglich den CVC innerhalb des Formulars eingeben.

bdEmail

ans..128

C

Email address of the customer

Mandatory in case Provider=PayU India, Provider=PayU iyzico, Provider=PayU Single (Poland), Provider=PayU Mexico

E-Mail-Adresse des Kunden

Obligatorisch falls Provider=PayU India

bdPhone

ans..40

C

Customer’s phone number

Mandatory in case Provider=PayU India

Telefonnummer des Kunden

Obligatorisch falls Provider=PayU India

Parameters for credit card payments with PayU Hub


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.

CCSelecta..10MDetermines preselected card type in the form: VISA, MasterCard, AMEX, Diners, RuPayBestimmt die vorausgewählte Kartenmarke im Formular: VISA, MasterCard, AMEX, Diners, RuPay

Layout parameters for forms for credit card payments with PayU Hub


Key

Format

CND

Description

Beschreibung

CodeExtans..10O

Error code from PayU, if agreed with

Fehlercode von PayU, wenn mit abgesprochen

ErrorTextans..256O

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 6x4Maskierte Kartennummer 6x4

TransactionID

ans..64

C

Transaction ID from PayUTransaktions-ID von PayU

TokenExt

an..64

C

For recurring payments (RTF=I) the Token is transmitted for referencing the credit card dataFür wiederkehrende Zahlungen (RTF=I) wird das Token als Referenz auf die Kreditkartendaten übertragen
Channela..5MName 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 DeliveryName der zu verwendenden Zahlungskategorie mit den folgenden möglichen Werten: 'NB' für Net Banking, 'CC' für Kreditkarte, 'DC' für Debitkarte, 'CASH' für Geldkarte, 'EMI' für EMI, 'Wallet' für PayUMoney, 'IVR' für IVR, 'COD' für Nachnahme
BankCodea..5MIdentification of the payment option used for the transaction: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINRIdentifizierung der für die Transaktion verwendeten Zahlungsoption: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR
Branda..5CSpecific card type: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINRSpezifischer Kartentyp: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR

Return parameters for URLSuccess, URLFailure and URLNotify with PayU Hub

 


Credit card payment via Server-to-Server connection

In order to execute a recurring credit card payment with PayU Hub 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. Mandatory for the initial payment of a new abo (RTF=I).

Eindeutige Referenznummer des Händlers. Obligatorisch für die Erstzahlung 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.

RTFa1O„I“ for initializing recurrent payments„I“ zum Initialisieren wiederkehrender Zahlungen

CCNr

n..19

M

Pseudo card number

Pseudokartennummer

CCExpiry

n6

M

Credit card expiry date (YYYYMM), e.g. 202807

Ablaufdatum der Kreditkarte (JJJJMM), z.B. 202807

CCBrand

a..22

M

Card brand: only VISA, MasterCard, AMEX, Diners, RuPay.

Please note the spelling!

Kartenmarke: nur VISA, MasterCard, AMEX, Diners, RuPay.

Bitte beachten Sie die Schreibweise!

TokenExt

an..64

M

Token for referencing the credit card data with PayU

Token zum Referenzieren der Kreditkartendaten bei PayU

TransactionID

ans..64

M

TransactionID from PayU which is returned with the initial payment (RTF=I)

Transaktions-ID von PayU, die mit der ursprünglichen Zahlung zurückgegeben wird (RTF=I)

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.

Wird die Kundennummer nicht angegeben, wird stattdessen die E-Mail-Adresse an PayU übermittelt.

Die Kundennummer dient der Identifizierung des Kunden, um ggf. bei PayU hinterlegte Kreditkartendaten auswählen zu können.

eMail

ans..128

C

Email address of the customer

Mandatory in case Provider=PayU India

E-Mail-Adresse des Kunden

Obligatorisch falls Provider=PayU India

Phone

ans..40

C

Customer’s phone number

Mandatory in case Provider=PayU India

Telefonnummer des Kunden

Obligatorisch falls Provider=PayU India

Parameters for credit card payments with PayU Hub via socket connection


Key

Format

CND

Description

Beschreibung

CodeExtans..10O

Error code from PayU, if agreed with

Fehlercode von PayU, wenn mit abgesprochen

ErrorTextans..256O

Error text from PayU, if agreed with

Fehlertext von PayU, wenn mit abgesprochen

Key

Format

CND

Description

Beschreibung

Channela..5MName 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 DeliveryName der zu verwendenden Zahlungskategorie mit den folgenden möglichen Werten: 'NB' für Net Banking, 'CC' für Kreditkarte, 'DC' für Debitkarte, 'CASH' für Geldkarte, 'EMI' für EMI, 'Wallet' für PayUMoney, 'IVR' für IVR, 'COD' für Nachnahme
BankCodea..5MIdentification of the payment option used for the transaction: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINRIdentifizierung der für die Transaktion verwendeten Zahlungsoption: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR
Branda..5CSpecific card type: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINRSpezifischer Kartentyp: VISA, MAST, SAME, MAES, RUPAY, CC, AMEX, DINR

Result parameters for socket connection with PayU Hub

 


Credit with reference

credit.aspx


For PayUIndia as Provider, credits (refunds) are asynchronous. This means that PayU Hub can respond with status "Refund Request Queued" for credit (refund) request. After credit (refund) processing, PayU Hub will send additional notification with results of the processing. will forward the additional notification to the merchant.


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

OrderDescans..100ODescription 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 Hub via socket connection

 

Key

Format

CND

Description

Beschreibung

CodeExtn..10O

Error code from PayU, if agreed with

Fehlercode von PayU, wenn mit abgesprochen

ErrorTextans..256O

Error text from PayU, if agreed with

Fehlertext von PayU, wenn mit abgesprochen

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