About Przelewy24

General information about Przelewy24

Logo

Info

Przelewy24 is an online banking method for Poland. It uses online bank authentication for account postings in real-time. Przelewy24 is supported by 18 large banks and reaches 95 % of the polish customers in online banking. The system has no transaction limit and directs customers via its online banking environment directly to the payment processing.

Type

Payments by Online Bank Transfer

Process flow chart

Przelewy24 process flow

interface

Payment with Przelewy24 via form interface

To make a payment with Przelewy24 online transfer in Poland, please use the following URL:

p24.aspx

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

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of goods and prices. Intended purpose on the statement of account.	Beschreibung der Waren und Preise. Verwendungszweck auf dem Kontoauszug.

Key	Format	CND	Description	Beschreibung
Language	a2	O	2-letter language code (e.g. de) that should be preferred when presenting payment pages to the consumer	2-stelliger Sprachcode (z. B. de), der bei der Darstellung von Zahlungsseiten für den Kunden bevorzugt werden sollte
AccOwner	ans3..50	M	Name of account holder	Name des Kontoinhabers
Email	ans..100	M	E-Mail address of account holder	E-Mail-Adresse des Kontoinhabers

Parameters for payments with Przelewy24 (via PPRO)

Przelewy24 via Direct Integration method (P24 Direct)

To make a payment with Przelewy24 online transfer via direct integration in Poland, please use the following URL:

p24.aspx

Key	Format	CND	Description	Beschreibung
RefNr	ans..20	O	Merchant’s unique reference number	Eindeutige Referenznummer des Händlers
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Default value: "PLN"	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Standardwert: "PLN"

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of goods and prices. Intended purpose on the statement of account.	Beschreibung der Waren und Preise. Verwendungszweck auf dem Kontoauszug.

Key	Format	CND	Description	Beschreibung
Language	a2	O	2-letter language code (e.g. de) that should be preferred when presenting payment pages to the consumer. Default value: "pl".	2-stelliger Sprachcode (z. B. de), der bei der Darstellung von Zahlungsseiten für den Kunden bevorzugt werden sollte. Standardwert: "pl".
bdFirstName	ans3..20	O	Customer's first name	Vorname des Kunden
bdLastName	an..20	O	Customer's surname	Nachname des Kunden
bdStreet	ans..80	O	Customer's address	Adresse desKunden
bdZip	n..10	O	Customer's postal code	Postleitzahl des Kunden
bdCity	ans..50	O	Customer's city	Ort des Kunden
bdCountryCode	a2	M	Country code of the customer, 2 characters according to ISO 3166. Default value: "PL"	Ländercode des Kunden, 2 Zeichen gemäß ISO 3166. Standardwert: „PL“
bdPhone	ans..12	O	Customer's telephone in the following format: 481321132123	Telefonnummer des Kunden im folgenden Format: 481321132123
bdeMail	ans..50	M	E-Mail address of account holder	E-Mail-Adresse des Kontoinhabers
PayType	a..10	O	Payment method. List of payment methods available through direct API. Available values: blik	Zahlungsmethode. Liste der über die direkte API verfübaren Zahlungsmethoden. Verfügbare Werte: blik
AuthCode	n..10	OC	Required in case of BLIK one time payment. 6-digit, one-time BLIK code generated in the app. If provided then PayType = blik* otherwise request will be rejected.	Erforderlich bei BLIK-Einmalzahlung. 6-stelliger, einmaliger BLIK-Code, der in der App generiert wird. Wenn angegeben, ist PayType = blik*, andernfalls wird die Anfrage abgelehnt.
TermsAndConditions	an..10	OC	Required in case "PayType" parameter is provided with the request Default: false Acceptance of Przelewy24 regulations: false – display consent on p24 website (default), true – consent granted, do not display. In case the „true” parameter is sent, the consent – worded as follows – must be displayed on the Partner’s website: „I hereby state that I have read the regulations and information obligation of ”Przelewy24”. Under words regulations and information obligation there must be hyperlinks redirecting to websites with these documents. The checkbox must not be ticked by default.	Erforderlich, wenn bei der Anfrage der Parameter "PayType" angegeben ist Standardwert: false Akzeptanz der Przelewy24-Bestimmungen: false – Zustimmung auf der p24-Website anzeigen (Standard), true – Zustimmung erteilt, nicht anzeigen. Falls der Parameter „true” übergeben wird, muss die Zustimmung – mitfolgendem Wortlaut – auf der Webseite des Partners angezeigt werden: „Hiermit erkläre ich, dass ich die Bestimmungen und Informationspflichten von ”Przelewy24” gelesen habe. Bei den Wörtern Bestimmungen und Informationspflichten müssen Hyperlinks vorhanden sein, die zu den Webseiten mit diesen Dokumenten weiterleiten. Das Kontrollkästchen darf standardmäßig nicht aktiviert sein.
ChargeAmount	ans..10	O	Delivery cost	Lieferkosten
ShippingMethod	n..1	O	Type of shipment: Possible values: 0 – courier 1 – delivery point 2 – parcel locker 3 – package in a shop	Lieferart: Mögliche Werte: 0 – Kourier 1 – Lieferpunkt 2 – Paketschließfach 3 – Paket in einem Geschäft
sdStreet	ans..80	O	Shipment address: street and number	Lieferadresse: Straße und Hausnummer
sdZip	n..10	O	Shipment zip code	Postleitzahl der Lieferadresse
sdCity	ans..50	O	Shipment city	Ort der Lieferadresse
sdCountryCode	a2	O	Country code of the shipment address, 2 characters according to ISO 3166	Ländercode der Lieferadresse, 2 Zeichen gemäß ISO 3166
Articlelist	String	O	Article list, base64 encoded value	Artikelliste, Base64-codierter Wert
items	array	M	Array of items, e.g.: {"items": [{items1 ...}{item2...}]}	Array von Artikeln, z. B.: {"items": [{items1 ...}{item2...}]}
items.id	ans..30	M	Product number	Produktnummer
items.description	ans..30	M	Product description	Produktbeschreibung
items.quantity	ans..30	M	Product quantity	Produktmenge
items.amount	n..10	M	Product price	Produktpreis
items.name	n..10	M	Product name	Produktname

Parameters for payments with Przelewy24 via Direct Integration

Key	Format		CND	Description	Beschreibung
TID	ans..40		O	Transaction reference at Przelewy24	Transaktionsreferenz bei Przelewy24
paymentMethod	ans..40		O	The payment method that was chosen to complete the payment by the customer.	TBD

Key	Format		CND	Description	Beschreibung
TransactionID	an..20		O	Unique transaction number from PPRO or P24 direct method.	Eindeutige Transaktionsnummer bei PPRO

Return parameters for URLSuccess, URLFailure and URLNotify with Przelewy24

Credit with reference

credit.aspx

Parameters for credit payments with Przelewy24 via socket connection

Response parameters for credit payments with Przelewy24 via socket connection

Batch processing via the interface

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

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

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

Description of the possible batch versions

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

HEAD,<MerchantID>,<Date>,<Version>
Przelewy24,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, Przelewy24 for Przelewy24	HEAD für Header, FOOT für Footer, Przelewy24 für Przelewy24
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Description of fields within the record for Batch files

The record area within the response file for Batch transactions looks the following way:

HEAD,<MerchantID>,<Date>,<Version>
Przelewy24,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: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Description of result parameters within the record for Batch files