About PayU CEE Single

General information about payment methods via PayU CEE Single

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 Single is valid only for Poland, Czech and Slovakia. For Hungary, Romania, Russia and Turkey the connection PayU CEE GECAD has to be used. For that a separate manual exist: PayU CEE GECAD.

Logo

Info

PayU is the leading wallet system in Poland. Merchants can offer the comprehensive payment services via the in Eastern Europe and further countries as well and thus reach over 500 million potential customers.

Type

Mixed payment methods

Card Scheme
VISA
MasterCard

Process flow chart

PayU CEE Single process flow

interface

Payment with PayU CEE Single via form interface

In order to process a payment with PayU CEE Single via a form, please use the following URL:

payu.aspx

BLIK OneClick

There are 3 possible scenarios to process a payment using BLIK OneClik.

Scenario 1: Payment using AuthCode

This scenario is possible for all merchants.

To use this option, parameter PayType has to be set to "blik" and parameter AuthCode contains valid authorization code. Please note, regards this functionality the customer/client/browser will not be forwarded to the and your shop system will receive only the status by URLNotify response.

Scenario 2: Payment using AuthCode with token registration

This scenario is possible only for merchants, registered as "trusted merchants" on PayU side.

To use this option, parameter PayType has to be set to "blik" and parameter AuthCode has to contain a valid authorization code.

As the merchant is registered as "trusted merchants" on PayU side, after successfull payment a token will be created and registered on PayU side. Registered token is sent in response in scope of JSON object AllowedPayMethods (field "value" contains the token, for details refer to description of JSON object AllowedPayMethods below). Additionally the token can be received by call PayUPayMethods.aspx.

Scenario 3: Payment using token

This scenario is possible only for merchants, registered as "trusted merchants" on PayU side.

A token, created using Scenario 2, can be used for further payments.

In this scenario payment request should be sent with parameter PayType equals to "blik", parameter TokenExt and parameter AppKey with values returned in parameter AllowedPayMethods. AllowedPayMethods contains token in field "value" and key is returned in field "key".

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Only EUR, PLN and CZK permissible. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur EUR, PLN und CZK zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..35	M	Description of purchased goods, unit prices etc. The first 27 characters appear on the customer account statement.	Beschreibung der gekauften Waren, Einzelpreise usw. Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden.
OrderDesc2	ans..384	O	Quantity and description of the goods purchased, unit prices. Comma-delimited list, no special characters permitted.	Anzahl und Beschreibung gekaufter Waren, Einzelpreise. Kommaseparierte Liste, keine Sonderzeichen zulässig.
ArticleList	ans..1024	M	Article list. These parameters must have the following structure: Product name,unit price,number Several articles can be separated with a +, e.g.: iPhone,700,1+Samsung Galaxy,700,2 The sum of prices from ArticleList and ShippingData must be equal to the parameter Amount. If you need to disable this check (e.g. for processing of gift cards) please contact the and also PayU support.	Artikelliste. Dieser Parameter muss folgenden Aufbau haben: Produktname,Einzelpreis,Anzahl Mehrere Artikel können durch ein + getrennt werden, z.B.: iPhone,700,1+Samsung Galaxy,700,2 Die Summe der Preise aus ArticleList und ShippingData muss mit dem Parameter Amount übereinstimmen. Wenn diese Prüfung deaktiviert werden soll (z.B. für die Verarbeitung von Geschenk-Gutscheinen), so wenden Sie sich bitte an den und an den PayU Support.
PayType	ans..4	O	Payment method to be used. Possible values can be found in the list https://developers.payu.com/en/overview.html#paymethods at Value. E.g., "dpcz" for Twisto CZK.	Zu verwendende Zahlungsart. Mögliche Werte stehen in der Liste https://developers.payu.com/en/overview.html#paymethods unter Value. z.B. "dpcz" für Twisto CZK.
AuthCode	n6	O	For payment method BLIK parameter AuthCode can be transmitted. If it is not transmitted the customer will be redirected to an appropriate page.	Für die Zahlungsart BLIK kann der Parameter AuthCode übergeben werden. Wird dieser nicht übergeben, wird der Kunde auf eine entsprechende Seite weitergeleitet.
TokenExt	ans..64	O	For payment method BLIK parameter TokenExt can be transmitted.	Für die Zahlungsart BLIK kann der Parameter TokenExt übergeben werden.
AppKey	ans..32	O	For payment method BLIK parameter Appkey can be transmitted together with parameter TokenExt. In case a customer has accounts in several banks and uses BLIK in each of the banks, parameter AppKey contains application key for which the TokenExt has to be used.	Für die Zahlungsart BLIK kann der Parameter Appkey zusammen mit dem Parameter TokenExt übergeben werden. Falls ein Kunde Konten bei mehreren Banken hat und BLIK bei jeder dieser Banken verwendet, enthält der Parameter AppKey den Application-Key, für den das TokenExt verwendet werden soll.
Timeout	n..3	O	Time span in seconds within the payment must be executed	Dauer in Sekunden, in der die Zahlung durchgeführt werden muss
Language	a2	O	ISO code for language; currently only en, pl, cs permitted	ISO-Code für Sprache; derzeit nur en, pl, cs zulässig

Key	Format	CND	Description	Beschreibung
			Purchaser data	Bestellerdaten
FirstName	ans..100	M	First name of the customer	Vorname des Kunden
LastName	ans..100	M	Last name of the customer	Nachname des Kunden
Email	ans..100	M	Email address of the customer	E-Mail-Adresse des Kunden
CustomerID	ans..64	C	Mandatory in case of Blik Scenario 2 (Payment using AuthCode with token registration).	Muss für Blik Szenario 2 (Zahlung mit AuthCode mit Token-Registrierung) gesendet werden.
Phone	ans..100	O	Customer’s phone number	Telefonnummer des Kunden
SocialSecurityNumber	ans..100	O	Social security number	Sozialversicherungsnummer
			Delivery data	Lieferdaten
sdName	ans..100	C	Name. In case of payment type TWISTO (PayType=dpcz) PayU recommends the submission, which can have impacts on the Scoring Result.	Name. PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.
sdStreet	ans..100	C	Street name and street number If Name is transmitted this parameter must be transmitted too. In case of payment type TWISTO (PayType=dpcz) PayU recommends the submission, which can have impacts on the Scoring Result.	Straße und Hausnummer Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden. PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.
sdAddressAddition	ans..100	O	Address c/o	Adresszusatz
sdZIP	ans..10	C	Postcode If Name is transmitted this parameter must be transmitted too. In case of payment type TWISTO (PayType=dpcz) PayU recommends the submission, which can have impacts on the Scoring Result.	Postleitzahl Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden. PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.
sdCity	ans..100	C	Town If Name is transmitted this parameter must be transmitted too. In case of payment type TWISTO (PayType=dpcz) PayU recommends the submission, which can have impacts on the Scoring Result.	Stadt Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden. PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.
sdCountryCode	a..3	C	Country code (2 or 3 digits according to ISO 3166-1 alpha-2, alpha-3) If Name is transmitted this parameter must be transmitted too. In case of payment type TWISTO (PayType=dpcz) PayU recommends the submission, which can have impacts on the Scoring Result.	Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3) Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden. PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann.
sdState	ans..100	O	Federal state	Bundesland
sdEmail	ans..100	O	E-mail address	E-Mail-Adresse
sdPhone	ans..100	O	Telephone number	Telefonnummer
sdPOBox	ans..100	O	PO box	Postfach
ShippingData	ans..256	C	Selection of shipping provider. This parameter must have the following structure: Country,Price (in smallest currency unit),Name Several selection possibilities can be separated with a +. e.g. PL,700,UPS+PL,600,DHL In case of payment type TWISTO (PayType=dpcz) PayU recommends the submission, which can have impacts on the Scoring Result. The sum of prices from ArticleList and ShippingData must be equal to the parameter Amount. If you need to disable this check (e.g. for processing of gift cards) please contact the and also PayU support.	Auswahl des Versanddienstleisters. Der Parameter muss folgenden Aufbau haben: Land,Preis (in der kleinsten Währungseinheit),Name Mehrere Auswahlmöglichkeiten können durch ein + getrennt werden. z.B. PL,700,UPS+PL,600,DHL PayU empfiehlt im Fall der Zahlungsart TWISTO (PayType=dpcz) die Übergabe, welche Auswirkungen auf das Scoring-Ergebnis haben kann. Die Summe der Preise aus ArticleList und ShippingData muss mit dem Parameter Amount übereinstimmen. Wenn diese Prüfung deaktiviert werden soll (z.B. für die Verarbeitung von Geschenk-Gutscheinen), so wenden Sie sich bitte an den und an den PayU Support.
			Invoice data	Rechnungsdaten
bdName	ans..100	O	Name	Name
bdStreet	ans..100	C	Street name and street number If Name is transmitted this parameter must be transmitted too	Straße und Hausnummer Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdAddressAddition	ans..100	O	Address c/o	Adresszusatz
bdZIP	ans..10	C	Postcode If Name is transmitted this parameter must be transmitted too	Postleitzahl Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdCity	ans..100	C	Town If Name is transmitted this parameter must be transmitted too	Stadt Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdCountryCode	a..3	C	Country code (2 or 3 digits according to ISO 3166-1 alpha-2, alpha-3) If Name is transmitted this parameter must be transmitted too	Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3) Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdState	ans..100	O	Federal state	Bundesland
bdEmail	ans..100	O	E-mail address	E-Mail-Adresse
bdPhone	ans..100	O	Telephone number	Telefonnummer
bdPOBox	ans..100	O	PO box	Postfach
TaxNumber	n..30	O	National Identification Number (tax number)	National Identification Number (Steuernummer)
InvoiceFlag	n1	O	Defines if tick for invoice dispatch is displayed on the PayU page. 1 = tick is displayed 0 = tick is not displayed	Legt fest, ob der Haken zum Rechnungsversand auf der PayU-Seite angezeigt wird. 1 = Haken wird angezeigt 0 = Haken wird nicht angezeigt

Parameters for payments with PayU CEE Single

Key	Format	CND	Description	Beschreibung
Status	a..30	M	OK, FAILED or AUTHORIZE_REQUEST. If 10 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 10 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

Key

Format

CND

Description

Beschreibung

TransactionID

ans..32

O

ID for identification with PayU

ID zur Identifizierung bei PayU

AmountAuth

n..10

M

Authorized amount in the smallest currency unit (e.g. PLN Grosz)

Autorisierter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AmountCap

n..10

M

Captured amount in the smallest currency unit (e.g. PLN Grosz)

Gebuchter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AmountCred

n..10

M

Credited amount in the smallest currency unit (e.g. PLN Grosz)

Gutgeschriebener Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

AllowedPayMethods

ans..1024

C

Base64-encoded JSON object.

The object contains "blickToken" in the same format, as it was returned by PayU.

Example of the object:

[
    {
        "value": "TOKB_EaVSDM7dXXN1qXXExDdakvfviizKnIys",
        "type": "UID",
        "brandImageUrl": "https://static.payu.com/images/mobile/logos/pbl_blik.png",
        "bankApplicationReferences": [
            {
                "key": "18422",
                "label": "ma...tt@co...om"
            },
             {
                "key": "18407",
                "label": "ma...tt@co...om"
            } 
        ]
    }
]

Base64 JSON object.

Das Objekt enthält „blickToken“ im gleichen Format, wie es von PayU zurückgegeben wurde.

Beispiel:

[
    {
        "value": "TOKB_EaVSDM7dXXN1qXXExDdakvfviizKnIys",
        "type": "UID",
        "brandImageUrl": "https://static.payu.com/images/mobile/logos/pbl_blik.png",
        "bankApplicationReferences": [
            {
                "key": "18422",
                "label": "ma...tt@co...om"
            },
             {
                "key": "18407",
                "label": "ma...tt@co...om"
            } 
        ]
    }
]

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

Allowed Payment Methods

The request returns Blik token associated with the customer in this specific merchant/web shop.

The request can be used to retrieve the token before using it for Blik payment with token (Scenario 3).

PayUPayMethods.aspx

Key

Format

CND

Description

Beschreibung

CustomerID

ans..64

M

Identifier of the customer in merchant's system/web shop.

Must be the same as in token registration request (Blik Scenario 2).

ID des Kunden im System des Händlers

Muss dasselbe sein wie in der Zahlung mit AuthCode mit Token-Registrierung reuest (Blik Szenario 2).

Email

ans..100

M

Email address of the customer

Must be the same as in token registration request (Blik Scenario 2).

E-Mail-Adresse des Kunden

Muss dasselbe sein wie in der Zahlung mit AuthCode mit Token-Registrierung reuest (Blik Szenario 2).

Parameters for Allowed Payment Methods request.

Key

Format

CND

Description

Beschreibung

AllowedPayMethods

ans..1024

C

Base64-encoded JSON object.

The object contains "blickToken" in the same format, as it was returned by PayU.

Example of the object:

[
    {
        "value": "TOKB_EaVSDM7dXXN1qXXExDdakvfviizKnIys",
        "type": "UID",
        "brandImageUrl": "https://static.payu.com/images/mobile/logos/pbl_blik.png",
        "bankApplicationReferences": [
            {
                "key": "18422",
                "label": "ma...tt@co...om"
            },
             {
                "key": "18407",
                "label": "ma...tt@co...om"
            } 
        ]
    }
]

Base64 JSON object.

Das Objekt enthält „blickToken“ im gleichen Format, wie es von PayU zurückgegeben wurde.

Beispiel:

[
    {
        "value": "TOKB_EaVSDM7dXXN1qXXExDdakvfviizKnIys",
        "type": "UID",
        "brandImageUrl": "https://static.payu.com/images/mobile/logos/pbl_blik.png",
        "bankApplicationReferences": [
            {
                "key": "18422",
                "label": "ma...tt@co...om"
            },
             {
                "key": "18407",
                "label": "ma...tt@co...om"
            } 
        ]
    }
]

Parameters for Allowed Payment Methods response.

Credit card payment with PayU CEE Single via form interface

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

payssl.aspx

Key	Format	CND	Description	Beschreibung
refnr	ns..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 vorher mit abgestimmt werden!

Key	Format	CND	Description	Beschreibung
RTF	a1	O	„I“ for initializing recurrent payments	„I“ zur Initialisierung von wiederkehrenden Zahlungen
OrderDesc	ans..35	M	Description of purchased goods, unit prices etc. The first 27 characters appear on the customer account statement.	Beschreibung der gekauften Waren, Einzelpreise usw. Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden.
OrderDesc2	ans..384	O	Quantity and description of the goods purchased, unit prices. Comma-delimited list, no special characters permitted.	Anzahl und Beschreibung gekaufter Waren, Einzelpreise. Kommaseparierte Liste, keine Sonderzeichen zulässig.

Key	Format	CND	Description	Beschreibung
			Purchaser data	Bestellerdaten
FirstName	ans..100	M	First name of the customer	Vorname des Kunden
LastName	ans..100	M	Last name of the customer	Nachname des Kunden
Email	ans..100	M	Email address of the customer	E-Mail-Adresse des Kunden
Phone	ans..100	O	Customer’s phone number	Telefonnummer des Kunden
SocialSecurityNumber	ans..100	O	Social security number	Sozialversicherungsnummer
			Delivery data	Lieferdaten
sdName	ans..100	O	Name	Name
sdStreet	ans..100	C	Street name and street number If Name is transmitted this parameter must be transmitted too.	Straße und Hausnummer Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.
sdAddressAddition	ans..100	O	Address c/o	Adresszusatz
sdZIP	ans..10	C	Postcode If Name is transmitted this parameter must be transmitted too.	Postleitzahl Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.
sdCity	ans..100	C	Town If Name is transmitted this parameter must be transmitted too.	Stadt Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.
sdCountryCode	a..3	C	Country code (2 or 3 digits according to ISO 3166-1 alpha-2, alpha-3) If Name is transmitted this parameter must be transmitted too.	Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3) Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.
sdState	ans..100	O	Federal state	Bundesland
sdEmail	ans..100	O	E-mail address	E-Mail-Adresse
sdPhone	ans..100	O	Telephone number	Telefonnummer
sdPOBox	ans..100	O	PO box	Postfach
			Invoice data	Rechnungsdaten
bdName	ans..100	O	Name	Name
bdStreet	ans..100	C	Street name and street number If Name is transmitted this parameter must be transmitted too	Straße und Hausnummer Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdAddressAddition	ans..100	O	Address c/o	Adresszusatz
bdZIP	ans..10	C	Postcode If Name is transmitted this parameter must be transmitted too	Postleitzahl Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdCity	ans..100	C	Town If Name is transmitted this parameter must be transmitted too	Stadt Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdCountryCode	a..3	C	Country code (2 or 3 digits according to ISO 3166-1 alpha-2, alpha-3) If Name is transmitted this parameter must be transmitted too	Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3) Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdState	ans..100	O	Federal state	Bundesland
bdEmail	ans..100	O	E-mail address	E-Mail-Adresse
bdPhone	ans..100	O	Telephone number	Telefonnummer
bdPOBox	ans..100	O	PO box	Postfach
TaxNumber	n..30	O	National Identification Number (tax number)	National Identification Number (Steuernummer)

Parameters for credit card payments with PayU CEE Single

Key

Format

CND

Description

Beschreibung

Language

a2

O

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, <es> 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, <es> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese

Ohne Angabe ist die Sprache Deutsch.

CCSelect

a..16

M

Determines preselected card type in the form: VISA, AMEX, JCB, DINERS, MasterCard, Cartes Bancaires, Bancontact, Maestro, Dankort, Hipercard, CBN, Airplus, ComfortCard, Discover, Elo, Auro, CUP

Bestimmt die vorausgewählte Kartenmarke im Formular: VISA, AMEX, JCB, DINERS, MasterCard, Cartes Bancaires, Bancontact, Maestro, Dankort, Hipercard, CBN, Airplus, ComfortCard, Discover, Elo, Auro, CUP

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

Key	Format	CND	Description	Beschreibung
Status	a..30	M	OK, FAILED or AUTHORIZE_REQUEST. If 10 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 10 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

Key	Format	CND	Description	Beschreibung
CCBrand	a..22	O	In combination with PCNr: Name of credit card brand like Visa, MasterCard etc.	In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard etc.
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
MaskedCCNr	an..19	OC	Masked card number 6X4	Maskierte Kartennummer 6X4
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

Key	Format	CND	Description	Beschreibung
TransactionID	ans..32	O	ID for identification with PayU	ID zur Identifizierung bei PayU
AmountAuth	n..10	M	Authorized amount in the smallest currency unit (e.g. PLN Grosz)	Autorisierter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)
AmountCap	n..10	M	Captured amount in the smallest currency unit (e.g. PLN Grosz)	Gebuchter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)
AmountCred	n..10	M	Credited amount in the smallest currency unit (e.g. PLN Grosz)	Gutgeschriebener Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

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

Credit card payment with PayU CEE Single via Server-to-Server connection

In order to process a recurring credit card payment with PayU CEE Single via a Server-to-Server connection, please use the following URL:

direct.aspx

Key	Format	CND	Description	Beschreibung
RTF	a1	O	„I“ for initializing recurrent payments	„I“ zur Initialisierung von wiederkehrenden Zahlungen
OrderDesc	ans..35	M	Description of purchased goods, unit prices etc. The first 27 characters appear on the customer account statement.	Beschreibung der gekauften Waren, Einzelpreise usw. Die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden.
CCNr	n..19	M	Credit card number	Kreditkartennummer
CCExpiry	n6	M	Credit card expiry date (YYYYMM), e.g. 202307	Ablaufdatum der Kreditkarte (YYYYMM), z.B. 202307
CCBrand	a..2	M	Card brand: only VISA, MasterCard. Please note the spelling!	Kartenmarke: nur VISA, MasterCard. Bitte beachten Sie die Schreibweise!
TokenExt	an..64	M	Token for referencing the credit card data at PayU	Der Token, um die Kreditkartendaten bei PayU zu referenzieren
			Purchaser data	Bestellerdaten
FirstName	ans..100	M	First name of the customer	Vorname des Kunden
LastName	ans..100	M	Last name of the customer	Nachname des Kunden
Email	ans..100	M	Email address of the customer	E-Mail-Adresse des Kunden
Phone	ans..100	O	Customer’s phone number	Telefonnummer des Kunden
SocialSecurityNumber	ans..100	O	Social security number	Sozialversicherungsnummer
			Delivery data	Lieferdaten
sdName	ans..100	O	Name	Name
sdStreet	ans..100	C	Street name and street number If Name is transmitted this parameter must be transmitted too.	Straße und Hausnummer Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.
sdAddressAddition	ans..100	O	Address c/o	Adresszusatz
sdZIP	ans..10	C	Postcode If Name is transmitted this parameter must be transmitted too.	Postleitzahl Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.
sdCity	ans..100	C	Town If Name is transmitted this parameter must be transmitted too.	Stadt Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.
sdCountryCode	a..3	C	Country code (2 or 3 digits according to ISO 3166-1 alpha-2, alpha-3) If Name is transmitted this parameter must be transmitted too.	Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3) Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden.
sdState	ans..100	O	Federal state	Bundesland
sdEmail	ans..100	O	E-mail address	E-Mail-Adresse
sdPhone	ans..100	O	Telephone number	Telefonnummer
sdPOBox	ans..100	O	PO box	Postfach
			Invoice data	Rechnungsdaten
bdName	ans..100	O	Name	Name
bdStreet	ans..100	C	Street name and street number If Name is transmitted this parameter must be transmitted too	Straße und Hausnummer Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdAddressAddition	ans..100	O	Address c/o	Adresszusatz
bdZIP	ans..10	C	Postcode If Name is transmitted this parameter must be transmitted too	Postleitzahl Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdCity	ans..100	C	Town If Name is transmitted this parameter must be transmitted too	Stadt Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdCountryCode	a..3	C	Country code (2 or 3 digits according to ISO 3166-1 alpha-2, alpha-3) If Name is transmitted this parameter must be transmitted too	Ländercode (zwei- oder dreistellig gemäß ISO 3166-1 alpha-2, alpha3) Wenn Name übergeben wird, muss auch dieser Parameter übergeben werden
bdState	ans..100	O	Federal state	Bundesland
bdEmail	ans..100	O	E-mail address	E-Mail-Adresse
bdPhone	ans..100	O	Telephone number	Telefonnummer
bdPOBox	ans..100	O	PO box	Postfach
TaxNumber	n..30	O	National Identification Number (tax number)	National Identification Number (Steuernummer)

Parameters for credit card payments with PayU CEE Single 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

Key	Format	CND	Description	Beschreibung
TransactionID	ans..32	O	ID for identification with PayU	ID zur Identifizierung bei PayU
AmountAuth	n..10	M	Authorized amount in the smallest currency unit (e.g. PLN Grosz)	Autorisierter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)
AmountCap	n..10	M	Captured amount in the smallest currency unit (e.g. PLN Grosz)	Gebuchter Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)
AmountCred	n..10	M	Credited amount in the smallest currency unit (e.g. PLN Grosz)	Gutgeschriebener Betrag in der kleinsten Währungseinheit (z.B. PLN Grosz)

Result parameters for socket connection for PayU CEE Single

Capture of a payment with PayU CEE Single

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

capture.aspx

Parameters for captures of PayU CEE Single 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 Single 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 Single 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 Single via socket connection

Reversal

Reversals are possible via a Server-to-Server connection. To carry out a reversal, please use the following URL:

reverse.aspx

Notice: Reverse.aspx does not only reverse authorisations, but any LAST TRANSACTION STAGE!! If the last transaction was a capture, Reverse.aspx initiates the reverse, e.g. a credit. Therefore, the utmost caution is urged. Use is at your own risk. We recommend checking the transaction status with Inquire.aspx before using Reverse.aspx.

Parameters for reversals of payments with PayU CEE Single

Response parameters for reversals of payments with PayU CEE Single

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 CEE Single 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 payment within a Batch file to be submitted is the following:

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

HEAD für Header, FOOT für Footer, PayU für PayU

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>
PayU,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
PayU,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