About PayU CEE GECAD

General information about payment methods via PayU CEE GECAD

For the PayU Connection there are two different variants of the interface depending on the countries as well as two manuals. This connection PayU CEE GECAD is valid for Hungary, Romania, Russia and Turkey. For Poland, Czech and Slovakia the connection PayU CEE Single has to be used. For that a separate manual exist: PayU CEE Single.

Logo

Info

Integration of the PayU CEE GECAD platform is ideal for facilitating e-commerce in fast-growing eastern European countries, and covers the most popular payment methods now available in countries such as Hungary, Romania, Russia or Turkey. With an average internet usage rate of 60%, citizens of these countries provide an attractive market for expansion of international business.

Type

Mixed payment methods

Process flow charts

PayU CEE GECAD process flow

Process flow PayU CEE GECAD via form interface payssl.aspx

Process flow PayU CEE GECAD via server-to-server interface direct.aspx

Configuration for PayU CEE GECAD

For configuring PayU CEE GECAD some settings are necessary in the PayU back end. Calling the back end is carried out by calling the respective URL for each country:

Romania: https://secure.payu.ro/cpanel/

Russian Federation: https://secure.payu.ru/cpanel/

Hungary: https://secure.payu.hu/cpanel/

Turkey: https://secure.payu.com.tr/cpanel/

Activate the tab Account settings at System settings. In the section of notifications IPN or Email Text & IPN must be selected. Additionally the options Canceled and returned orders and Complete orders must be activated.

Documentation > PayU CEE GECAD > image2019-8-16_0-27-40.png

Now go to the tab IPN settings. Within the URL field enter the modified link in that form payuceecomplete.aspx?merchantid=MID, but you must insert your own MID.

Documentation > PayU CEE GECAD > image2019-8-16_0-27-48.png

Furthermore the parameters REFNO, REFNOEXT, ORDERSTATUS, IPN_TOTALGENERAL and CURRENCY must be activated.

Documentation > PayU CEE GECAD > image2019-8-16_0-28-1.png

In the back end of PayU CEE GECAD additional parameters can be created. They will be displayed on the payment page and can/must be filled in by the customer.

If Customfields is selected within IPN Settings, will forward these parameters to the merchant.

Documentation > PayU CEE GECAD > image2019-8-16_0-28-20.png

interface

Payment with PayU CEE GECAD via form interface

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

payucee.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only TRY, RON, EUR and USD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur TRY, RON, EUR und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
ArticleList(n)	ans..2048	M	Customer’s article list in the form: Articlelist(n)= ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+… Articlelist1 to max. Articlelist10 permissible The ArticleCode hast to be one-to-one because otherwise identical article numbers will be overwritten by PayU and not added. Thereby the total amount of trasaction could be changed by mistake. Example: Articlelist1=article1,123456,100,1,16,GROSS+article2,321654,200,2,16,NET Articlelist2=article3,987654,100,2,16,GROSS+article4,654231,150,1,16,NET The amount must be equal to the sum of the amounts in ArticleList, i.e. in the sample above: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 1 x 150)	Artikelliste des Kunden in der Form: Articlelist(n)= Artikelname,ArtikelCode,Einzelpreis,Anzahl,Umsatzsteuersatz,Typ+Artikelname,ArtikelCode,Einzelpreis, Anzahl,Umsatzsteuersatz,Typ+… Articlelist1 bis max. Articlelist10 zulässig Der ArtikelCode muss eineindeutig sein, da ansonsten identische Artikelnummern seitens PayU überschrieben und nicht addiert werden. Dadurch könnte sich fälschlicherweise der Gesamtbetrag der Transaktion ändern. Beispiel: Articlelist1=artikel1,123456,100,1,16,GROSS+artikel2,321654,200,2,16,NET Articlelist2=artikel3,987654,100,2,16,GROSS+artikel4,654231,150,1,16,NET Der Amount muss mit der Summe der Artikelbeträge übereinstimmen, d.h. im obigen Beispiel: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 150)
Discount	n..10	O	Discount in the smallest currency unit	Nachlass in der kleinsten Währungseinheit
ChargeAmount	n..10	O	Shipping costs. Amount in the smallest currency unit (e.g. EUR Cent)	Versandkosten. Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
AutoStart	bool	O	If you transfer the value 1 here you bypass the first page in the PayU-process. Important: This is possible only, if all necessary parameters are transferred.	Wenn Sie hier den Wert 1 übergeben, überspringen Sie die erste Seite im PayU-Prozess. Wichtig: Das ist nur möglich, wenn alle nötigen Parameter übergeben werden.
Language	a2	O	Language: RO – Romanian EN – English HU – Hungarian DE – German FR – French IT – Italian ES – Spanish BG – Bulgarian PL – Polish RU – Russian	Sprache RO – Rumänisch EN – Englisch HU – Ungarisch DE – Deutsch FR – Französisch IT – Italienisch ES – Spanisch BG – Bulgarisch PL – Polnisch RU – Russisch
PayType	ans..25	M	Name of payment method to be executed Possible values for Romania: <Card> - VISA/MasterCard Installment payments: <BRDF> – BRDFinance Installment <STAR_BT> – Banca Transilvania’s StarBT <CARD_AVANTAJ> – Credit Europe’s CardAvantaj <ALPHABANK> – Alpha Bank Online bank transfers: <TRANSFER_ING> – Internet banking with ING Home Bank <ITRANSFER_BCR> – Internet banking with Click24 Banking BCR <ITRANSFER_BT> – Internet banking with BT24 Other: <ZEBRA> – cash deposit with ZebraPay Self Service <PAYPAL> – PayPal payments <WIRE> – Bank Wire Possible values for Turkey: <Card> - VISA/MasterCard Other: <WEBMONEY> <QIWI> <MAILRU> <YANDEX> (not valid for new customers) <EUROSET_SVYAZNOI> <ALFACLICK> <BKM> Value for merchants which have activated this method: <MASTERPASS> Note: If PayType is used, then parameter bdCountryCode becomes mandatory.	Name der auszuführenden Zahlungsart Mögliche Werte für Rumänien: <Card> - VISA/MasterCard Ratenzahlungen: <BRDF> – BRDFinance Installment <STAR_BT> – Banca Transilvania’s StarBT <CARD_AVANTAJ> – Credit Europe’s CardAvantaj <ALPHABANK> – Alpha Bank Online-Überweisungen: <TRANSFER_ING> – Internet banking with ING Home Bank <ITRANSFER_BCR> – Internet banking with Click24 Banking BCR <ITRANSFER_BT> – Internet banking with BT24 Sonstige: <ZEBRA> – Bareinzahlung bei ZebraPay Self Service <PAYPAL> – PayPal-Zahlungen <WIRE> – Bank Wire Mögliche Werte für Türkei: <Card> - VISA/MasterCard Sonstige: <WEBMONEY> <QIWI> <MAILRU> <YANDEX> (Gilt nicht für neue Kunden) <EUROSET_SVYAZNOI> <ALFACLICK> <BKM> Wert für Händler, die diese Methode aktiviert haben: <MASTERPASS> Hinweis: Wenn PayType verwendet wird, ist der Parameter bdCountryCode Pflicht.
InstallmentData	ans..24	OC	Only for Channel=RO: Preconfiguration of possible number of rates Default value is the configuration from the PayU system „2,3,4,5,6,7,8,9,10,11,12“ – All are displayed for choosing „2,3,7,10,12“ – 2,3,7,10,12 are displayed for choosing „2“– only 2 is displayed as an option „1„ – no installments possible	Nur bei Channel=RO: Vorbelegung der möglichen Ratenanzahl Standard ist die Konfiguration aus dem PayU System „2,3,4,5,6,7,8,9,10,11,12“ – Alle werden als Option zur Auswahl angezeigt „2,3,7,10,12“ – 2,3,7,10,12 werden als Option zur Auswahl angezeigt „2“– nur 2 wird als Option zur Auswahl angezeigt „1„ – keine Ratenzahlung möglich
InstallmentNumber	n..2	OC	Only for Channel=TR: Number of months of the payment by instalments (1-12)	Nur bei Channel=TR: Anzahl Monate der Ratenzahlung (1-12)
Timeout	n..3	O	Validity of transaction in seconds	Gültigkeit der Transaktion in Sekunden
Channel	a2	O	Channel (country) of payment (the default channel will be configured by ): RO = Romania TR = Turkey RU = Russian Federation HU = Hungary UA = Ukraine	Kanal (Land) der auszuführenden Zahlung (der Standardkanal wird vom konfiguriert): RO = Rumänien TR = Türkei RU = Russland HU = Ungarn UA = Ukraine

Key	Format	CND	Description	Beschreibung
			Billing address (PayU)	Rechnungsadresse (PayU)
bdFirstName	ans..128	M	First name of the customer	Vorname des Kunden
bdLastName	ans..128	M	Last name of the customer	Nachname des Kunden
bdStreet	ans..46	O	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdAddressAddition	ans..60	O	Address addition in the billing address	Adresszusatz der Rechnungsadresse
bdCity	ans..40	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdZip	ans..8	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdState	ans..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdCountryCode	a2	OC	Country code in the invoicing address according to ISO 3166. Mandatory if PayType is submitted.	Ländercode der Rechnungsadresse gemäß ISO 3166. Pflicht, wenn PayType angegeben ist.
bdFax	ans..20	O	Customer’s fax number	Faxnummer des Kunden
bdeMail	ans..128	M	Email address of the customer	E-Mail-Adresse des Kunden
bdPhone	ans..40	O	Customer’s phone number	Telefonnummer des Kunden
IdCardSeries	ans..3	O	Series of ID card	Serie des Personalausweises
IdCardNumber	ans..20	O	Serial number of ID card	Seriennummer des Personalausweises
IdCardIssuer	ans..128	O	Issuer of ID card	Aussteller des Personalausweises
NatIdentNr	ans..20	O	CNP of the customer	CNP des Kunden
CompanyName	ans..200	O	Name of company	Firmenname
TaxNumber	ans..20	O	VAT Reg. No.	Umsatzsteueridentifikationsnummer
RegisterNumber	ans..20	O	Register of Companies number/commercial register	Handelsregisternummer/Firmenbuch
AccBank	ans..20	O	Bank name of the company	Bankname der Firma
AccNr	ans..20	O	Account number of the company	Kontonummer der Firma
			Delivery address	Lieferadresse
sdFirstName	ans..128	O	First name in the delivery address	Vorname in der Lieferanschrift
sdLastName	ans..128	O	Surname in the delivery address	Nachname in der Lieferanschrift
sdStreet	ans..46	O	Street name in the delivery address	Straßenname in der Lieferanschrift
sdAddressAddition	ans..60	O	Address addition in the delivery address	Adresszusatz der Lieferanschrift
sdCity	ans..40	O	Town/city in the delivery address	Ortsname in der Lieferanschrift
sdZip	ans..8	O	Postcode in the delivery address	Postleitzahl in der Lieferanschrift
sdState	ans..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
sdCountryCode	a2	O	Country code in the delivery address according to ISO 3166	Ländercode in der Lieferadresse gemäß ISO 3166
sdeMail	ans..128	O	Email address in the delivery address	E-Mail-Adresse in der Lieferanschrift
sdPhone	ans..40	O	Phone number in the delivery address	Telefonnummer in der Lieferanschrift

Parameters for payments with PayU CEE GECAD

Key	Format	CND	Description	Beschreibung
Status	a..30	M	OK, FAILED or AUTHORIZE_REQUEST. If 25 seconds after the redirect to CallBack page no notify is received from PayU, the status “AUTHORIZE_REQUEST”, Code “00000000” and Description ”REQUEST” is submitted to the URLSuccess. Please note, the status “AUTHORIZE_REQUEST” will be sent only to URLSuccess and there is no call of URLNotify. Should receive a further final PayU status for this open payment, it will be sent separately via URLNotify. If you don't want to process a separate final status via URLNotify this open payment can be cancelled via calling reverse.aspx and should PayU nevertheless receive a revenue this will automatically be refunded to the customer.	OK, FAILED oder AUTHORIZE_REQUEST. Sollte 25 Sekunden nach der Umleitung auf die CallBack-Seite kein Notify von PayU empfangen worden sein, wird als Status “AUTHORIZE_REQUEST”, als Code “00000000” und als Description ”REQUEST” an die URLSuccess übergeben. Bitte beachten Sie, der Status “AUTHORIZE_REQUEST” wird ausschließlich an die URLSuccess gemeldet, hierzu gibt es keinen URLNotify-Aufruf. Erhält das auf dieses offene Payment einen weiteren finalen PayU Status, wird dieser separat via URLNotify gemeldet. Wenn Sie keinen separaten, finalen Status via URLNotify verarbeiten möchten, kann das offene Payment via Aufruf der reverse.aspx storniert werden und sollte PayU dennoch den Umsatz erhalten, wird dieser automatisch dem Kunden erstattet.

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 URLSuccess and URLFailure with PayU CEE GECAD

The following table gives the results parameters which the transfers to URLNotify:

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
AmountAuth	n..10	M	Actually authorized amount in the smallest currency unit	Tatsächlich autorisierter Betrag in der kleinsten Währungseinheit
Currency	a3	M	Currency, three digits DIN / ISO 4217	Währung, drei Zeichen DIN / ISO 4217
TransactionID	ans..25	O	RefNr from PayU system	RefNr des PayU-Systems
PayType	ans..25	M	Name of used payment method (see above for possible values)	Name der genutzten Zahlungsart (Für mögliche Werte siehe oben)
bdFirstName	ans..128	O	First name of the customer	Vorname des Kunden
bdLastName	ans..128	O	Last name of the customer	Nachname des Kunden
bdStreet	ans..46	O	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdAddressAddition	ans..60	O	Address addition in the billing address	Adresszusatz der Rechnungsadresse
bdCity	ans..40	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdZip	ans..8	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdState	ans..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdCountryCode	a2	OC	Country code in the invoicing address according to ISO 3166. Mandatory if PayType is submitted.	Ländercode der Rechnungsadresse gemäß ISO 3166. Pflicht, wenn PayType angegeben ist.
bdFax	ans..20	O	Customer’s fax number	Faxnummer des Kunden
bdeMail	ans..128	M	Email address of the customer	E-Mail-Adresse des Kunden
bdPhone	ans..40	O	Customer’s phone number	Telefonnummer des Kunden
IdCardSeries	ans..3	O	Series of ID card	Serie des Personalausweises
IdCardNumber	ans..20	O	Serial number of ID card	Seriennummer des Personalausweises
IdCardIssuer	ans..128	O	Issuer of ID card	Aussteller des Personalausweises
NatIdentNr	ans..20	O	CNP of the customer	CNP des Kunden
CompanyName	ans..200	O	Name of company	Firmenname
TaxNumber	ans..20	O	VAT Reg. No.	Umsatzsteueridentifikationsnummer
RegisterNumber	ans..20	O	Register of Companies number/commercial register	Handelsregisternummer/Firmenbuch
AccBank	ans..20	O	Bank name of the company	Bankname der Firma
AccNr	ans..20	O	Account number of the company	Kontonummer der Firma
sdFirstName	ans..128	O	First name in the delivery address	Vorname in der Lieferanschrift
sdLastName	ans..128	O	Surname in the delivery address	Nachname in der Lieferanschrift
sdStreet	ans..46	O	Street name in the delivery address	Straßenname in der Lieferanschrift
sdAddressAddition	ans..60	O	Address addition in the delivery address	Adresszusatz der Lieferanschrift
sdCity	ans..40	O	Town/city in the delivery address	Ortsname in der Lieferanschrift
sdZip	ans..8	O	Postcode in the delivery address	Postleitzahl in der Lieferanschrift
sdState	ans..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
sdCountryCode	a2	O	Country code in the delivery address according to ISO 3166	Ländercode in der Lieferadresse gemäß ISO 3166
sdeMail	ans..128	O	Email address in the delivery address	E-Mail-Adresse in der Lieferanschrift
sdPhone	ans..40	O	Phone number in the delivery address	Telefonnummer in der Lieferanschrift
CustomParameter	ans..	O	If additional parameters are configured in the PayU backend these are returned with the prefix “custom_”; e.g. PayU Parameter = age = custom_age	Wenn im BackEnd von PayU zusätzliche Parameter konfiguriert wurden, werden diese mit dem Zusatz „custom_“ zurückgegeben; z.B. PayU Parameter = age = custom_age
InstallmentNumber	n..2	O	Number of months of the payment by instalments (1-12), default=1	Anzahl Monate der Ratenzahlung (1-12), Standard=1
CardProgram	ans..25	O	Name of the card programme which allows the instalment payment (see table of card programmes)	Name des Kartenprogramms, das die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)

Return parameters for URLNotify with PayU CEE GECAD

Following table gives an overview of supported card programmes for instalment payments. Please note that new programmes can be added and the participating banks can be changed.

Card programme	Issuer
Advantage	T. İŞ BANKASI A.Ş.
AsyaCard	ASYA KATILIM BANKASI A.Ş.
Axess	AKBANK T.A.Ş. CITIBANK A.Ş. ODEA BANK A.Ş.
Bonus	TÜRK EKONOMİ BANKASI A.Ş. ŞEKERBANK T.A.Ş. T.GARANTİ BANKASI A.Ş. ING BANK A.Ş. DENİZBANK A.Ş. TÜRKİYE FİNANS
Cardfinans	FİNANS BANK A.Ş.
Maximum	T.C.ZİRAAT BANKASI A.Ş. T. İŞ BANKASI A.Ş.
Paraf	T.HALK BANKASI A.Ş.
World	T.VAKIFLAR BANKASI T.A.O. YAPI VE KREDİ BANKASI A.Ş. ANADOLUBANK A.Ş. ALBARAKA TÜRK

Supported card programmes for instalment payments

Credit card payment with PayU CEE GECAD via form interface

In order to process a SSL credit card payment with PayU CEE GECAD via a form, please use the following URL:

payssl.aspx

Key	Format	CND	Description	Beschreibung
RefNr	ans..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 TRY, RON, EUR and USD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur TRY, RON, EUR und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
ArticleList(n)	ans..2048	M	Customer’s article list in the form: Articlelist(n)= ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+… Articlelist1 to max. Articlelist10 permissible The ArticleCode hast to be one-to-one because otherwise identical article numbers will be overwritten by PayU and not added. Thereby the total amount of trasaction could be changed by mistake. Example: Articlelist1=article1,123456,100,1,16,GROSS+article2,321654,200,2,16,NET Articlelist2=article3,987654,100,2,16,GROSS+article4,654231,150,1,16,NET The amount must be equal to the sum of the amounts in ArticleList, i.e. in the sample above: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 1 x 150)	Artikelliste des Kunden in der Form: Articlelist(n)= Artikelname,ArtikelCode,Einzelpreis,Anzahl,Umsatzsteuersatz,Typ+Artikelname,ArtikelCode,Einzelpreis, Anzahl,Umsatzsteuersatz,Typ+… Articlelist1 bis max. Articlelist10 zulässig Der ArtikelCode muss eineindeutig sein, da ansonsten identische Artikelnummern seitens PayU überschrieben und nicht addiert werden. Dadurch könnte sich fälschlicherweise der Gesamtbetrag der Transaktion ändern. Beispiel: Articlelist1=artikel1,123456,100,1,16,GROSS+artikel2,321654,200,2,16,NET Articlelist2=artikel3,987654,100,2,16,GROSS+artikel4,654231,150,1,16,NET Der Amount muss mit der Summe der Artikelbeträge übereinstimmen, d.h. im obigen Beispiel: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 150)
ChargeAmount	n..10	O	Shipping costs. Amount in the smallest currency unit (e.g. EUR Cent).	Versandkosten. Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Channel	a2	O	Channel (country) of payment (the default channel will be configured by ): RO = Romania TR = Turkey RU = Russian Federation HU = Hungary UA = Ukraine	Kanal (Land) der auszuführenden Zahlung (der Standardkanal wird vom konfiguriert): RO = Rumänien TR = Türkei RU = Russland HU = Ungarn UA = Ukraine

Key	Format	CND	Description	Beschreibung
			Installments (PayU)	Ratenzahlung (PayU)
InstallmentNumber	n..2	O	Number of months of the payment by instalments (1-12), default=1	Anzahl Monate der Ratenzahlung (1-12), Standard=1
CardProgram	ans..25	O	Name of the card programme which allows the instalment payment (see table of card programmes)	Name der Kartenprogramms, welches die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)
Campaign	a5	O	Defines the campaign to be used for the instalments. Extra=EXTRA_INSTALLMENTS Delay=DELAY_INSTALLMENTS	Legt die zu verwendende Kampagne für Ratenzahlung fest. Extra=EXTRA_INSTALLMENTS Delay=DELAY_INSTALLMENTS
			Loyalty points (PayU)	Loyalty points (PayU)
PointAmount	n..10	O	Amount of the Loyalty points to be used in the smallest currency unit	Anzahl der zu nutzenden Loyalty-Punkte in der kleinsten Währungseinheit
			Billing address (PayU)	Rechnungsadresse (PayU)
bdFirstName	ans..128	M	First name of the customer	Vorname des Kunden
bdLastName	ans..128	M	Last name of the customer	Nachname des Kunden
bdStreet	ans..46	O	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdAddressAddition	ans..60	O	Address addition in the billing address	Adresszusatz der Rechnungsadresse
bdCity	ans..40	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdZip	ans..8	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdState	ans..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdCountryCode	a2	M	Country code in the invoicing address according to ISO 3166	Ländercode der Rechnungsadresse gemäß ISO 3166
bdFax	ans..20	O	Customer’s fax number	Faxnummer des Kunden
bdeMail	ans..128	M	Email address of the customer	E-Mail-Adresse des Kunden
bdPhone	ans..40	O	Customer’s phone number	Telefonnummer des Kunden
			Delivery address	Lieferadresse
sdFirstName	ans..128	O	First name in the delivery address	Vorname in der Lieferanschrift
sdLastName	ans..128	O	Surname in the delivery address	Nachname in der Lieferanschrift
sdStreet	ans..46	O	Street name in the delivery address	Straßenname in der Lieferanschrift
sdAddressAddition	ans..60	O	Address addition in the delivery address	Adresszusatz der Lieferanschrift
sdCity	ans..40	O	Town/city in the delivery address	Ortsname in der Lieferanschrift
sdZip	ans..8	O	Postcode in the delivery address	Postleitzahl in der Lieferanschrift
sdState	ans..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
sdCountryCode	a2	O	Country code in the delivery address according to ISO 3166	Ländercode in der Lieferadresse gemäß ISO 3166
sdeMail	ans..128	O	Email address in the delivery address	E-Mail-Adresse in der Lieferanschrift
sdPhone	ans..40	O	Phone number in the delivery address	Telefonnummer in der Lieferanschrift

Parameters for credit card payments with PayU CEE GECAD

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

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

Layout parameters for forms for credit card payments with PayU CEE GECAD

Key	Format	CND	Description	Beschreibung
Status	a..30	M	OK, FAILED or AUTHORIZE_REQUEST. If 25 seconds after the redirect to CallBack page no notify is received from PayU, the status “AUTHORIZE_REQUEST”, Code “00000000” and Description ”REQUEST” is submitted to the URLSuccess. Please note, the status “AUTHORIZE_REQUEST” will be sent only to URLSuccess and there is no call of URLNotify. Should receive a further final PayU status for this open payment, it will be sent separately via URLNotify. If you don't want to process a separate final status via URLNotify this open payment can be cancelled via calling reverse.aspx and should PayU nevertheless receive a revenue this will automatically be refunded to the customer.	OK, FAILED oder AUTHORIZE_REQUEST. Sollte 25 Sekunden nach der Umleitung auf die CallBack-Seite kein Notify von PayU empfangen worden sein, wird als Status “AUTHORIZE_REQUEST”, als Code “00000000” und als Description ”REQUEST” an die URLSuccess übergeben. Bitte beachten Sie, der Status “AUTHORIZE_REQUEST” wird ausschließlich an die URLSuccess gemeldet, hierzu gibt es keinen URLNotify-Aufruf. Erhält das auf dieses offene Payment einen weiteren finalen PayU Status, wird dieser separat via URLNotify gemeldet. Wenn Sie keinen separaten, finalen Status via URLNotify verarbeiten möchten, kann das offene Payment via Aufruf der reverse.aspx storniert werden und sollte PayU dennoch den Umsatz erhalten, wird dieser automatisch dem Kunden erstattet.

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
AmountAuth	n..10	MC	Only to URLNotify: Actually authorized amount in the smallest currency unit. For installment payments the charges are added automatically to the initial amount.	Nur an URLNotify: Tatsächlich autorisierter Betrag in der kleinsten Währungseinheit. Bei Ratenzahlungen werden automatisch die Gebühren zum ursprünglichen Betrag addiert.
Currency	a3	MC	Only to URLNotify: Currency, three digits DIN / ISO 4217	Nur an URLNotify: Währung, drei Zeichen DIN / ISO 4217
InstallmentNumber	n..2	OC	Only to URLNotify: Number of months of the payment by instalments (1-12), default=1	Nur an URLNotify: Anzahl Monate der Ratenzahlung (1-12), Standard=1
CardProgram	ans..25	OC	Only to URLNotify: Name of the card programme which allows the instalment payment (see table of card programmes)	Nur an URLNotify: Name des Kartenprogramms, welches die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)
PayType	ans..25	MC	Only to URLNotify: Name of used payment method (see above for possible values)	Nur an URLNotify: Name der genutzten Zahlungsart (Für mögliche Werte siehe oben)

Return parameters for URLSuccess, URLFailure and URLNotify with PayU CEE GECAD

Credit card payment via Server-to-Server connection

In order to execute an SSL credit card payment with PayU CEE GECAD via a server-to-server connection, please use the following URL:

direct.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only TRY, RON, EUR and USD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur TRY, RON, EUR und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
CCNr	n..19	M	Credit card number at least 12-digit, numerical without spaces. You can optionally transmit also a pseudo card number (PCN)	Kreditkartennummer mind. 12stellig numerisch ohne Leerzeichen. Optional können Sie auch eine Pseudokartennummer übergeben.
CCCVC	n..4	O	Card verification number: The last 3 digits on the signature strip of the credit card. 4 characters in the case of AMEX.	Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei AMEX 4 Ziffern.
CCExpiry	n6	M	Credit card expiry date (YYYYMM), e.g. 202607	Ablaufdatum der Kreditkarte (JJJJMM), z.B. 202607
CCBrand	a..22	M	Card type: VISA, MasterCard. Please note the spelling!	Kartenmarke: VISA, MasterCard. Bitte beachten Sie die Schreibweise!
CreditCardHolder	ans..60	O	Name of the card holder	Name des Karteninhabers
OrderDesc	ans..768	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
ArticleList(n)	ans..2048	M	Customer’s article list in the form: Articlelist(n)= ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Type+… Articlelist1 to max. Articlelist10 permissible The ArticleCode hast to be one-to-one because otherwise identical article numbers will be overwritten by PayU and not added. Thereby the total amount of trasaction could be changed by mistake. Example: Articlelist1=article1,123456,100,1,16,GROSS+article2,321654,200,2,16,NET Articlelist2=article3,987654,100,2,16,GROSS+article4,654231,150,1,16,NET The amount must be equal to the sum of the amounts in ArticleList, i.e. in the sample above: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 1 x 150)	Artikelliste des Kunden in der Form: Articlelist(n)= Artikelname,ArtikelCode,Einzelpreis,Anzahl,Umsatzsteuersatz,Typ+Artikelname,ArtikelCode,Einzelpreis, Anzahl,Umsatzsteuersatz,Typ+… Articlelist1 bis max. Articlelist10 zulässig Der ArtikelCode muss eineindeutig sein, da ansonsten identische Artikelnummern seitens PayU überschrieben und nicht addiert werden. Dadurch könnte sich fälschlicherweise der Gesamtbetrag der Transaktion ändern. Beispiel: Articlelist1=artikel1,123456,100,1,16,GROSS+artikel2,321654,200,2,16,NET Articlelist2=artikel3,987654,100,2,16,GROSS+artikel4,654231,150,1,16,NET Der Amount muss mit der Summe der Artikelbeträge übereinstimmen, d.h. im obigen Beispiel: Amount=850 (1 x 100 + 2 x 200 + 2 x 100 + 150)
ChargeAmount	n..10	M	Shipping costs. Amount in the smallest currency unit (e.g. EUR Cent).	Versandkosten. Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Channel	a2	O	Channel (country) of payment (the default channel will be configured by ): RO = Romania TR = Turkey RU = Russian Federation HU = Hungary UA = Ukraine	Kanal (Land) der auszuführenden Zahlung (der Standardkanal wird vom konfiguriert): RO = Rumänien TR = Türkei RU = Russland HU = Ungarn UA = Ukraine

Key	Format	CND	Description	Beschreibung
			Installments (PayU)	Ratenzahlung (PayU)
InstallmentNumber	n..2	O	Number of months of the payment by instalments (1-12), default=1	Anzahl Monate der Ratenzahlung (1-12), Standard=1
CardProgram	ans..25	O	Name of the card programme which allows the instalment payment (see table of card programmes)	Name der Kartenprogramms, welches die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)
Campaign	a5	O	Defines the campaign to be used for the instalments. Extra=EXTRA_INSTALLMENTS Delay=DELAY_INSTALLMENTS	Legt die zu verwendende Kampagne für Ratenzahlung fest. Extra=EXTRA_INSTALLMENTS Delay=DELAY_INSTALLMENTS
			Loyalty points (PayU)	Loyalty points (PayU)
PointAmount	n..10	O	Amount of the Loyalty points to be used in the smallest currency unit	Anzahl der zu nutzenden Loyalty-Punkte in der kleinsten Währungseinheit
			Billing address (PayU)	Rechnungsadresse (PayU)
bdFirstName	ans..128	M	First name of the customer	Vorname des Kunden
bdLastName	ans..128	M	Last name of the customer	Nachname des Kunden
bdStreet	ans..46	O	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdAddressAddition	ans..60	O	Address addition in the billing address	Adresszusatz der Rechnungsadresse
bdCity	ans..40	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdZip	ans..8	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdState	ans..50	O	Federal state in the invoicing address	Bundesland der Rechnungsadresse
bdCountryCode	a2	M	Country code in the invoicing address according to ISO 3166	Ländercode der Rechnungsadresse gemäß ISO 3166
bdFax	ans..20	O	Customer’s fax number	Faxnummer des Kunden
bdeMail	ans..128	M	Email address of the customer	E-Mail-Adresse des Kunden
bdPhone	ans..40	O	Customer’s phone number	Telefonnummer des Kunden
			Delivery address	Lieferadresse
sdFirstName	ans..128	O	First name in the delivery address	Vorname in der Lieferanschrift
sdLastName	ans..128	O	Surname in the delivery address	Nachname in der Lieferanschrift
sdStreet	ans..46	O	Street name in the delivery address	Straßenname in der Lieferanschrift
sdAddressAddition	ans..60	O	Address addition in the delivery address	Adresszusatz der Lieferanschrift
sdCity	ans..40	O	Town/city in the delivery address	Ortsname in der Lieferanschrift
sdZip	ans..8	O	Postcode in the delivery address	Postleitzahl in der Lieferanschrift
sdState	ans..50	O	Federal state of the delivery address	Bundesland der Lieferadresse
sdCountryCode	a2	O	Country code in the delivery address according to ISO 3166	Ländercode in der Lieferadresse gemäß ISO 3166
sdeMail	ans..128	O	Email address in the delivery address	E-Mail-Adresse in der Lieferanschrift
sdPhone	ans..40	O	Phone number in the delivery address	Telefonnummer in der Lieferanschrift

Parameters for credit card payments with PayU CEE GECAD 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
CCBrand	a..22	O	In combination with PCNr: Description of the credit card brand including VISA, MasterCard, AMEX, DINERS, Elo, Aura or Hipercard	In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, AMEX, DINERS, Elo, Aura oder Hipercard
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
InstallmentNumber	n..2	O	Number of months of the payment by instalments (1-12), default=1	Anzahl Monate der Ratenzahlung (1-12), Standard=1
CardProgram	ans..25	O	Name of the card programme which allows the instalment payment (see table of card programmes)	Name des Kartenprogramms, welches die Ratenzahlung erlaubt (siehe Tabelle der Kartenprogramme)
PayType	ans..25	M	Name of used payment method (see above for possible values)	Name der genutzten Zahlungsart (Für mögliche Werte siehe oben)

Result parameters for socket connection with PayU CEE GECAD

Capture of a credit card payment with PayU CEE GECAD

Captures are possible via a Server-to-Server connection. To carry out a Capture for a credit card payment with PayU CEE GECAD via a Server-to-Server connection, please use the following URL:

capture.aspx

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	O	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 zuvor mit abgestimmt werden!

Parameters for captures of PayU CEE GECAD via socket connections

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 captures of PayU CEE GECAD via socket connections

Credit with reference

credit.aspx

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

Parameters for credit payments with PayU CEE GECAD 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 payments with PayU CEE GECAD 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 CEEE GECAD 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
Capture	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)
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)

Description of the possible batch versions

The structure for a PayU CEE payment within a Batch file to be submitted is the following:

HEAD,<MerchantID>,<Date>,<Version>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
CC,Credit,<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:

Capture

Credit

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

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,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
CC,Credit,<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: Capture Credit	Der Action-Parameter definiert die Art der Transaktion: Capture (Buchung) Credit (Gutschrift)

Description of result parameters within the record for Batch files