Table of Contents

About Przelewy24

General information about Przelewy24

Page properties

Logo

Info

Excerpt
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

Multiexcerpt

MultiExcerptName	ProcessFlow

draw.io Diagram

border	true
diagramName	Processflow_Przelewy24_CT
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	1108

Przelewy24 process flow

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

Payment with Przelewy24 via
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
form interface

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

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

p24.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1654606817060_424983127
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	przelewy24_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1654606817062_-510961468
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	RefNr_PPRO
page	refnr
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

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

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

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.

Table Excerpt Include

static	true
name	URLSuccess
page	URLSuccess
type	page

Table Excerpt Include

static	true
name	URLFailure
page	URLFailure
type	page

Table Excerpt Include

static	true
name	Response
page	Response
type	page

Table Excerpt Include

static	true
name	URLNotify
page	URLNotify
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Table Excerpt Include

static	true
name	SellingPoint
page	SellingPoint
type	page

Table Excerpt Include

static	true
name	Service
page	Service
type	page

Table Excerpt Include

static	true
name	Channel
page	Channel
type	page

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

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

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:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

p24.aspx

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1710766229651_220106653
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	przelewy24_direct_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1710766229654_-194260671
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

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"

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

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.

Table Excerpt Include

static	true
name	URLSuccess
page	URLSuccess
type	page

Table Excerpt Include

static	true
name	URLFailure
page	URLFailure
type	page

Table Excerpt Include

static	true
name	Response
page	Response
type	page

Table Excerpt Include

static	true
name	URLNotify
page	URLNotify
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

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

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Parameters for payments with Przelewy24 via Direct Integration

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_IntroURL
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1654607323508_-506233330
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	przelewy24_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1654607323510_874823885
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	RefNr_PPRO
page	refnr
type	page

Table Excerpt Include

static	true
name	Status_OK_AUTHORIZE_REQUEST
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

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

Table Excerpt Include

static	true
name	PaymentPurpose
page	PaymentPurpose
type	page

Table Excerpt Include

static	true
name	PaymentGuarantee
page	PaymentGuarantee
type	page

Table Excerpt Include

static	true
name	ErrorText_PPRO
page	ErrorText
type	page

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

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Return parameters for URLSuccess, URLFailure and URLNotify with Przelewy24

Credit with reference

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Credit_Intro
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

credit.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1654607916204_1324538317
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	credit_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1654607916206_1003632735
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID_Credit
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Parameters for credit payments with Przelewy24 via socket connection

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1654607993076_1421204635
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	credit_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1654607993079_-265609546
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	RefNr_PPRO
page	refnr
type	page

Table Excerpt Include

static	true
name	ErrorText_PPRO
page	ErrorText
type	page

Response parameters for credit payments with Przelewy24 via socket connection

Batch processing via the interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Intro
PageWithExcerpt	Reuse API

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:

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1654601843091_676050983
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_versions

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1654601843093_1302006955
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

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:

Multiexcerpt

MultiExcerptName	batch_structure
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
Przelewy24,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

Multiexcerpt

MultiExcerptName	batch_MasterMid
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1654601955543_622946914
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1654601955545_550119446
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

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)

Table Excerpt Include

name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	RefNr_PPRO
page	refnr
type	page

Table Excerpt Include

static	true
name	PayID_Batch
page	PayID
type	page

Description of fields within the record for Batch files

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

Multiexcerpt

MultiExcerptName	batch_structure_response
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
Przelewy24,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Response_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1654602099381_108437646
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1654602099383_-209722765
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

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)

Table Excerpt Include

static	true
name	PayID_Batch
page	PayID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Description of result parameters within the record for Batch files

Space shortcuts

Page tree

Versions Compared

Old Version 376

New Version 377

Key

About Przelewy24

General information about Przelewy24

Process flow chart

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Payment with Przelewy24 via
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
form interface

Przelewy24 via Direct Integration method (P24 Direct)

Credit with reference

Batch processing via the interface

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 376

New Version 377

Key

About Przelewy24

General information about Przelewy24

Process flow chart

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

Payment with Przelewy24 via Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording form interface

Przelewy24 via Direct Integration method (P24 Direct)

Credit with reference

Batch processing via the interface

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Payment with Przelewy24 via
Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
form interface