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

Key	Format		CND	Description	Beschreibung
TID	ans..40		O	Transaction reference at Przelewy24	Transaktionsreferenz bei Przelewy24

Key	Format		CND	Description	Beschreibung
TransactionID	an..20		O	Unique transaction number with PPRO	Eindeutige Transaktionsnummer bei PPRO

Return parameters for URLSuccess, URLFailure and URLNotify with Przelewy24

Credit with reference

Credits (refunds) are possible via a Server-to-Server connection. For a Credit with reference to a capture the amount of the Credit is limited to the amount of the previous capture.

To carry out a credit with a reference transaction, please use the following URL:

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

Basic information about using Batch files and about their structure can be found in the Batch Manager manual. Within batch processing not alle functions are available which are usually available for the online 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

The following table describes the individual fields and values used within the data set (record) in the batch file:

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>

The following table describes the response parameters which the Batch Manager saves in the Record area for each transaction (standard parameters not explained here, such as <TransID> or <RefNR> and request parameters are returned unchanged and correspond to the call as specified before):

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