About Paysafe Pay Later

General information about Paysafe Pay Later

Logo

Info

With the products Purchase on invoice and Hire purchase merchants get tailored solutions for the region D-A-CH. Paysafe Pay Later especially features a fast and guaranteed payout as well as a comprehensive support for the B2B and B2C business.

Type

Payments by Invoice and Installments

Further information can be found on the website of Paysafe Pay Later (https://www.paysafe.com).

Process flow chart

Paysafe Pay Later process flow

interface

Paysafe Pay Later Invoice payment and Instalment payment

Paysafe Pay Later offers payment by instalment, on account or direct debit options. Different requests, which are controlled via the EventToken parameter, are necessary to completely finalise an authorisation.

Instalment payment:

Instalment calculation (Calculation)
Acceptance check before transaction (PreCheck)
Authorization of the amount at transaction with disclosure of instalment term (PreAuthorization)

Purchase on account & direct debit:

Acceptance check before transaction (PreCheck)
Authorization of the amount at transaction (PreAuthorization)

There are further requests after authorisation which are carried out via the same URL:

Re-authorization in order to change the amount before posting/dispatch. Not possible with payment by instalment. (ReAuthorization)
Credit notification. Only possible after posting/dispatch. (RefundAnnouncements)
Data completion only after subsequent disclosure of IDs. (AddData)

Creating/updating Paysafe Pay Later payments

In order to initialize a Paysafe Pay Later payment via server-to-server communication, please use the following URL:

payolution.aspx

Key	Format	CND	Description	Beschreibung
Amount	n..10	M	Amount in the smallest currency unit (e.g. EUR Cent). Please contact the , if you want to capture amounts <100 (smallest currency unit). Notice: Please note the allowed minimum and maximum amounts. Within the Test-environment these are for purchase on invoice (B2C & B2B): min. 50,00 and max. 5.000,00 EUR/CHF and for purchase on installments min. 150,00 and max. 5000,00 EUR/CHF. Within the Live-environment apply the amounts contractually agreed with Pay Later. These can be values between 1,00 EUR/CHF and 1.000.000,00 EUR/CHF.	Betrag in der kleinsten Währungseinheit (z.B. EUR Cent). Bitte wenden Sie sich an den , wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten. Hinweis: Beachten Sie bitte die zulässigen Minimum- und Maximumbeträge. In der Test-Umgebung betragen diese für Rechnungskauf (B2C & B2B): min. 50,00 und max. 5.000,00 EUR/CHF und für Ratenkauf min. 150,00 und max. 5000,00 EUR/CHF. In der Live-Umgebung gelten die vertraglich mit Pay Later vereinbarten Beträge. Das können Werte zwischen 1,00 EUR/CHF bis 1.000.000,00 EUR/CHF sein.

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of the purchased goods	Beschreibung der gekauften Waren

Key	Format	CND	Description	Beschreibung
EventToken	a2	M	Token for the call of a specific request. <CL> for Calculation <PC> for PreCheck <PA> for PreAuthorization <PZ> for ReAutorization (not with instalment payment) <RA> for RefundAnnouncement (only after capture/shipment) <AD> for AddData	Token für den Aufruf eines bestimmten Requests: <CL> für Calculation <PC> für PreCheck <PA> für PreAuthorization <PZ> für ReAutorization (nicht bei Ratenkauf) <RA> für RefundAnnouncement (erst nach Buchung/Versand) <AD> für AddData
PayID	an32	C	ID assigned by for the payment, e.g. for referencing of batch files. Obligatory for EventToken <PC> (only for instalment payment), <PA>, <PZ>, <RA>, <AD>.	Vom vergebene ID für die Zahlung, z.B. zur Referenzierung von Batch-Dateien. Pflicht bei EventToken <PC> (nur bei Ratenkauf), <PA>, <PZ>, <RA>, <AD>.
PayType	ans..15	C	Payment method Mandatory for: installment, if EventToken <CL>: INSTALLMENT purchase on invoice, if EventToken <PC>: INVOICE direct debit, if EventToken <PC>: DIRECTDEBIT	Zahlungsmethode Pflicht bei: Ratenkauf, wenn EventToken <CL>: INSTALLMENT Rechnungskauf, wenn EventToken <PC>: INVOICE Lastschrift, wenn EventToken <PC>: DIRECTDEBIT
CompanyOrPerson	a1	O	<P> person (standard) or <F> company. Only <P> possible for PayType <INSTALLMENT>.	<P> Person (Standard) oder <F> Firma. Bei PayType <INSTALLMENT> ist nur <P> möglich.
Reason	a..64	O	Legible reason for the transaction	Lesbarer Grund für die Transaktion
InstallmentNumber	n..2	C	Number of monthly instalments. Mandatory for EventToken <PA> and PayType <INSTALLMENT>	Anzahl Monate der Ratenzahlung. Pflicht bei EventToken <PA> und PayType <INSTALLMENT>
TaxAmount	n..10	O	VAT. Amount in the smallest currency unit (e.g. EUR Cent)	Umsatzsteuer. Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
FirstName	ans..30	C	First name. Obligatory for EventToken <PC>	Vorname. Pflicht bei EventToken <PC>
LastName	ans..30	C	Last name. Obligatory for EventToken <PC>	Nachname. Pflicht bei EventToken <PC>
BirthDate	ans10	C	Date of birth in the format YYYY-MM-DD Obligatory for CompanyOrPerson <P>	Geburtsdatum im Format JJJJ-MM-TT. Pflicht bei CompanyOrPerson <P>
Gender	a1	OC	Gender: <F> for female, <M> for male. The gender may not be forwarded for CompanyOrPerson <F>.	Geschlecht: <F> für weiblich, <M> für männlich. Bei CompanyOrPerson <F> darf Gender nicht übergeben werden.
Title	ans..20	O	Title, e.g. Dr. or Prof.	Titel, z.B. Dr. oder Prof.
AddrCountryCode	a2	OC	Country code for the invoicing address, 2 characters according to ISO 3166. Obligatory for EventToken <PC>. Optional for EventToken <CL>.	Ländercode der Rechnungsadresse zweistellig gemäß ISO 3166. Pflicht bei EventToken <PC>. Optional bei EventToken <CL>.
AddrCity	ans..40	C	Town/city. Obligatory for EventToken <PC>.	Ortsname. Pflicht bei EventToken <PC>.
AddrZip	ans..10	C	Postcode. Obligatory for EventToken <PC>.	Postleitzahl. Pflicht bei EventToken <PC>.
AddrStreet	ans..100	C	Street name and house number. Obligatory for EventToken <PC>.	Straßenname und Hausnummer. Pflicht bei EventToken <PC>.
AddrState	ans..40	O	Federal state	Bundesland
Email	ans..100	C	Email address of the customer. Obligatory for EventToken <PC>.	E-Mail-Adresse des Kunden. Pflicht bei EventToken <PC>.
IPAddr	ans..15	C	IP address. Obligatory for EventToken <PC>.	IP-Adresse. Pflicht bei EventToken <PC>.
Language	a2	O	Customer’s language, e.g. <de> for German	Sprache des Kunden, z.B. <de> für Deutsch
Phone	ans..20	C	Telephone number. Obligatory for AddrCountryCode <nl>.	Telefonnummer. Pflicht bei AddrCountryCode <nl>.
MobileNo	ans..20	O	Mobile telephone number	Mobiltelefonnummer
BrowserSessionID	ans..128	C	Unique SessonID: mandatory when using the Paysafe Pay Later Fraud Prevention Tool (JavaScript-Code-Snippet), if EventToken <PC> or <PA>.	Eindeutige SessionID: Pflicht bei Verwendung des Paysafe Pay Later Fraud Prevention Tools (JavaScript-Code-Snippet), wenn EventToken <PC> oder <PA>.
			Delivery data	Lieferdaten
sdFirstName	ans..30	O	First name in the delivery address	Vorname in der Lieferadresse
sdLastName	ans..30	O	Last name in the delivery address	Nachname in der Lieferadresse
sdCompany	ans..100	O	Company name in the delivery address	Firmenname in der Lieferadresse
sdCountryCode	a2	C	Country code for the delivery address, 2 characters according to ISO 3166. Obligatory if sdFirstName or sdCompany is transmitted.	Ländercode der Lieferadresse zweistellig gemäß ISO 3166. Pflicht, wenn sdFirstName oder sdCompany übermittelt wird.
sdStreet	ans..100	C	Number and street of the delivery address. Obligatory if sdFirstName or sdCompany is transmitted.	Straßenname und Hausnummer der Lieferadresse. Pflicht, wenn sdFirstName oder sdCompany übermittelt wird.
sdZIP	ans..10	C	Postcode of the delivery address. Obligatory if sdFirstName or sdCompany is transmitted.	Postleitzahl der Lieferadresse. Pflicht, wenn sdFirstName oder sdCompany übermittelt wird.
sdCity	ans..40	C	Town/city of the delivery address. Obligatory if sdFirstName or sdCompany is transmitted.	Ort der Lieferadresse. Pflicht, wenn sdFirstName oder sdCompany übermittelt wird.
sdState	ans..40	O	Federal state of the delivery address	Bundesland der Lieferadresse
			Company data	Firmendaten
CompanyName	ans..100	C	Company name. Obligatory for CompanyOrPerson <F>.	Firmenname. Pflicht bei CompanyOrPerson <F>.
VatID	ans..25	O	VAT ID	Umsatzsteuer-ID
RegisterNumber	ans..20	O	Register of Companies number/commercial register	Handelsregisternummer/Firmenbuch
CompanyID	ans..30	O	Other register number except VAT ID or Register of Companies number/Commercial Register	andere Registernummer als Umsatzsteuer-ID oder Handelsregisternummer/Firmenbuch
CountryCode	a2	C	Country code for the bank account, 2 characters according to ISO 3166. Obligatory for PayType <INSTALLMENT> or <DIRECTDEBIT> and EventToken <PA>.	Ländercode des Bankkontos zweistellig gemäß ISO 3166. Pflicht bei PayType <INSTALLMENT> oder <DIRECTDEBIT> und EventToken <PA>.
HolderName	ans..100	C	Name of account holder. Obligatory for PayType <INSTALLMENT> or <DIRECTDEBIT> and EventToken <PA>.	Name des Kontoinhabers. Pflicht bei PayType <INSTALLMENT> oder <DIRECTDEBIT> und EventToken <PA>.
IBAN	ans..34	C	International Bank Account Number. Obligatory for PayType <INSTALLMENT> or <DIRECTDEBIT>, EventToken <PA> and CountryCode <de> or CountryCode <at>.	International Bank Account Number. Pflicht bei PayType <INSTALLMENT> oder <DIRECTDEBIT>, EventToken <PA> und CountryCode <de> oder CountryCode <at>.
BIC	ans..11	O	Bank Identifier Code	Bank Identifier Code
CustomerGroup	ans..12	O	Description of the customer group	Beschreibung der Kundengruppe
CustomerID	ans..30	O	Customer number at the merchant	Kundennummer beim Händler
NumberPaidPurchases	n..4	O	Number of successful purchases	Anzahl erfolgreicher Käufe
CustomerScore	n..4	O	Internal score value at merchant	Interner Score-Wert beim Händler
ShopURL	ans..128	O	URL of the web shop	URL des Webshops
DateOfRegistration	n8	O	Registration date of customer in format YYYYMMDD	Registrierungsdatum des Kunden im Format JJJJMMTT
TrackingID	ans..50	O	Tracking ID of merchant system	Tracking-ID vom Händlersystem
ParcelTrackingID	ans..50	O	Parcel tracking number for returns	Sendungsverfolgungsnummer für die Retoure
ParcelService	ans..12	O	Logistics company	Logistik-Firma
OrderID	ans..32	O	Order number	Bestellnummer
ArticleList	ans..1024	O	Description and price of the goods purchased Example: <Description>;<Net price>;<VAT>+… <;>separates fields within an article <+> separates several article data records Data type (size): Description = alphanumeric (100) NetPrice = numerical (12) VAT = numeric (12)	Beschreibung und Preis der gekauften Waren Beispiel: <Beschreibung>;<Nettopreis>;<Umsatzsteuer>+… <;> trennt Felder innerhalb eines Artikels <+> trennt mehrere Artikeldatensätze Datentyp (Größe): Beschreibung = alphanumerisch (100) Nettopreis = numerisch (12) Umsatzsteuer = numerisch (12)
ShopID	ans..64	O	ID of the shop: ID issued by Paysafe Pay Later	ID des Shops: eine von Paysafe Pay Later vergebene ID
ShopName	ans..128	O	Shop-URL without www. or http. - e.g. „myShop.com“	Shop-URL ohne www. oder http. - z.B. „meinShop.de“
LegalName	ans..128	OC	Obligatory if ShopID is transmitted: Shop company name including legal form, e.g. “MyShop GmbH” or “MyShop AG“ If ShopID is not transmitted the parameter will be ignored.	Pflicht, wenn ShopID übergeben wurde: Firmenname des Shops inklusive Rechtsform, z.B. „meinShop GmbH“ oder „meinShop AG“ Wenn keine ShopID übergeben wurde, wird der Parameter nicht beachtet.
GoodsCategory	a..20	OC	Obligatory if ShopID is transmitted: Type of product Tangible goods: TANGIBLE_GOODS Services: SERVICE_PROVIDER If ShopID is not transmitted the parameter will be ignored.	Pflicht, wenn ShopID übergeben wurde: Art des Produktes Physikalische Güter: TANGIBLE_GOODS Dienstleistungen: SERVICE_PROVIDER Wenn keine ShopID übergeben wurde, wird der Parameter nicht beachtet.

Parameters for Paysafe Pay Later payments

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Paysafe Pay Later, if agreed with	Fehlercode von Paysafe Pay Later, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from Paysafe Pay Later, if agreed with	Fehlertext von Paysafe Pay Later, wenn mit abgesprochen
Reference	ans..32	M	Internal Paysafe Pay Later ID for the transaction	Interne Paysafe Pay Later ID für die Transaktion
PaymentPurpose	ans..32	O	Purpose of payment from Paysafe Pay Later, which must be stated by the customer upon transfer	Zahlungszweck von Paysafe Pay Later, der vom Kunden bei der Überweisung angegeben werden muss
PaymentDetails	ans..1024	O	Payment details Example: <OriginalAmount>;<TotalAmount>;<MinimumInstalment>;<TermHirePurchase>;<InterestRate>;<EffIntRate>;<PaymentReason>;<Currency>;<CreditInfoUrl>;<PaymentAmount1>;<PaymentDate1>;<PaymentAmountN>;<PaymentDateN>+… <;>separates fields within an article <+> separates several article data records Data type (size): Original amount = alphanumeric (16) Total amount = alphanumeric (16) Minimum instalment amount = alphanumeric (16) Duration of hire purchase =numeric (2) Interest rate = alphanumeric (6) eff. interest rate = alphanumeric (6) Payment reason = alphanumeric (128) Currency = text (3): CreditInfoURL = alphanumeric (256) Payment amount = alphanumeric (16) Payment date = alphanumeric (10)	Zahlungsdetails Beispiel: <Originalbetrag>;<Gesamtbetrag>;<MinimumRatenbetrag>;<Ratendauer>;<Zinssatz>;<effZinssatz>;<Zahlungsgrund>;<Währung>;<CreditInfoUrl>;<Zahlungsbetrag1>;<Zahlungsdatum1>;<ZahlungsbetragN>;<ZahlungsdatumN>+… <;> trennt Felder innerhalb eines Artikels <+> trennt mehrere Artikeldatensätze Datentyp (Größe): Originalbetrag = alphanumerisch (16) Gesamtbetrag = alphanumerisch (16) MinimumRatenbetrag = alphanumerisch (16) Ratendauer = numerisch (2) Zinssatz = alphanumerisch (6) effZinssatz = alphanumerisch (6) Zahlungsgrund = alphanumerisch (128) Währung = Text (3) CreditInfoUrl = alphanumerisch (256) Zahlungsbetrag = alphanumerisch (16) Zahlungsdatum = alphanumerisch (10)
UrlTerms	ans..1024	O	URL to the general terms and conditions of business	URL zu den Geschäftsbedingungen
ConsentUrl	ans..1024	O	URL to data protection regulations	URL zu den Datenschutzbestimmungen

Result parameters for Paysafe Pay Later payments

Capturing a Paysafe Pay Later payment

In order to capture a Paysafe Pay Later payment via a server-to-server communication, please use the following URL:

capture.aspx

Notice: A capture or partial capture is only possible for invoice payment. For instalment payment the capture is made automatically (Autocapture), so that a capture is not possible anymore.

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

Key	Format	CND	Description	Beschreibung
TaxAmount	n..10	O	VAT. Amount in the smallest currency unit (e.g. EUR Cent)	Umsatzsteuer. Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Reason	a..64	O	Legible reason for the transaction	Lesbarer Grund für die Transaktion
CustomerID	ans..30	O	Customer number at the merchant	Kundennummer beim Händler
TrackingID	ans..50	O	Tracking ID of merchant system	Tracking-ID vom Händlersystem
ParcelTrackingID	ans..50	O	Parcel tracking number for returns	Sendungsverfolgungsnummer für die Retoure
ParcelService	ans..12	O	Logistics company	Logistik-Firma
OrderID	ans..32	O	Order number	Bestellnummer

Parameters for capturing a Paysafe Pay Later payment

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Paysafe Pay Later, if agreed with	Fehlercode von Paysafe Pay Later, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from Paysafe Pay Later, if agreed with	Fehlertext von Paysafe Pay Later, wenn mit abgesprochen
Reference	ans..32	M	Internal Paysafe Pay Later ID for the transaction	Interne Paysafe Pay Later ID für die Transaktion

Response parameters for capturing a Paysafe Pay Later payment

Cancelling a Paysafe Pay Later authorization

In order to cancel a Paysafe Pay Later authorization via a server-to-server communication, please use the following URL:

reverse.aspx

Notice: A cancellation is only possible for invoice payment. For instalment payment the capture is made automatically (Autocapture), so that a cancellation is not possible anymore.

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

Parameters for cancelling a Paysafe Pay Later payment

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Paysafe Pay Later, if agreed with	Fehlercode von Paysafe Pay Later, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from Paysafe Pay Later, if agreed with	Fehlertext von Paysafe Pay Later, wenn mit abgesprochen
Reference	ans..32	M	Internal Paysafe Pay Later ID for the transaction	Interne Paysafe Pay Later ID für die Transaktion

Response parameters for cancelling a Paysafe Pay Later payment

Crediting Paysafe Pay Later payments

In order to credit a Paysafe Pay Later payment via a server-to-server communication, please use the following URL:

credit.aspx

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

Key	Format	CND	Description	Beschreibung
TaxAmount	n..10	O	VAT. Amount in the smallest currency unit (e.g. EUR Cent).	Umsatzsteuer. Betrag in der kleinsten Währungseinheit (z.B. EUR Cent).
Reason	a..64	O	Legible reason for the transaction	Lesbarer Grund für die Transaktion

Parameters for crediting a Paysafe Pay Later payment

Key	Format	CND	Description	Beschreibung
CodeExt	ans..10	O	Error code from Paysafe Pay Later, if agreed with	Fehlercode von Paysafe Pay Later, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from Paysafe Pay Later, if agreed with	Fehlertext von Paysafe Pay Later, wenn mit abgesprochen
Reference	ans..32	M	Internal Paysafe Pay Later ID for the transaction	Interne Paysafe Pay Later ID für die Transaktion

Response parameters for crediting a Paysafe Pay Later payment

Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing a Paysafe Pay Later capture or credit 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)
Reverse	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 capture or credit within a Batch file to be submitted is the following:

HEAD,<MerchantID>,<Date>,<Version>
Payolution,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
Payolution,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, Payolution for the transactions	HEAD für Header, FOOT für Footer, Payolution für die Transaktionen
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 the following way:

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