Table of Contents

About Sofort

General information about Sofort

Sofort is a method of bank transfers and is based on online banking. A big advantage is: The customer doesn’t need to register and does not need to create a virtual account, a so called wallet. As the name suggests it is an immediate bank transfer and thus a direct bank transfer. The customer selects Sofort as payment method for their online purchase and is then forwarded to the secure payment form. The bank transfer data is transferred automatically and the customer only has to select his or her bank and enter their login details for online banking. Finally he releases the bank transfer by means of an approval code. All data is send encrypted to the online banking account. The online merchant receives a real-time confirmation of the executed bank transfer. The merchant can execute and dispatch the order immediately delivering goods/services faster. There is no waiting time until the dispatch of the goods like it would be for example in the case of prepayment via bank transfer.

As usual with online banking, the data disclosed in Sofort are encrypted with SSL (Secure Sockets Layer).

Page properties

Logo

Info

Excerpt
The international online bank transfer with PIN/TAN from Sofort GmbH is now available in 8 7 countries. As part of the Klarna Group Sofort offers the integration of payment in the webshop, so that a customer is forwarded to his/her bank and can make the transfer with input of PIN and TAN.

Type

Payments by Online Bank Transfer

Further information can be found on the webpage of Sofort (https://www.sofort.com/ger-DE/verkaeufer/su/e-payment-sofort-ueberweisung).

Process flow chart

Multiexcerpt

MultiExcerptName	ProcessFlow

draw.io Diagram

border	true
diagramName	Sofort_PPRO Partner
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	1109

Process flow for Sofort via PPRO

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

Calling the interface

To carry out an online transfer with Sofort via PPRO, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

sofort.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	1646644557977_1025480373
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	sofort_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1646644557979_542660632
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

isFirstTimeEnter	true
static	true
v	2
name	MerchantID_REST
page	MerchantID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	TransID_REST
page	TransID
type	page

Key

Format

CND

Description

Beschreibung

RefNr

ans..40

O

Merchant’s unique reference number. Only characters a-zA-Z0-9,-_ are allowed.

Eindeutige Referenznummer des Händlers. Nur die Zeichen a-zA-Z0-9,-_ sind erlaubt.

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	RefNr_PPRO_REST
page	refnr
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Amount_REST
page	Amount
type	page

Key

Format

CND

Description

Beschreibung

Currency

A3

M

Three digits DIN / ISO 4217. Only EUR permissible.. Please find an overview here: A1 Currency table EN

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Currency_EUR_REST
page	Currency
type	page

Währung, drei Zeichen DIN / ISO 4217. Nur EUR zulässig. Hier eine Übersicht: A1 Währungstabelle

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MAC_REST
page	MAC
type	page

ans Überweisungsfenster erscheint (nur für DE möglich), PL, PL

Key

REST

Format

CND

Description

Beschreibung

OrderDesc

"order": {"description[0]": "..."}

ans..384

M

Reason for payment on customer-account statement. Notice: Only the first 27 characters appear on the customer-account statement. You can view the full data in

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Backoffice-Name
PageWithExcerpt	Wording

.

Verwendungstext auf dem Kontoauszug des Kunden. Hinweis: Nur die ersten 27 Zeichen erscheinen auf dem Kontoauszug des Kunden. In

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Backoffice-Name
PageWithExcerpt	DE:Wording

können Sie die Daten komplett einsehen.

AccOwner

"payment": {"sofort": {"account": {"accountHolder": "...

"}}}

ans3

AccOwner

..50

M

Name of account holder

Name des Kontoinhabers

IBAN

"payment": {"sofort": {"account": {"number": "..."}}}

an..34

O

IBAN of the user which appears predefined in the transfer window (only possible for DE)

IBAN des Nutzers, die voreingestellt im

Überweisungsfenster erscheint (nur für DE möglich)

BIC

"payment": {"sofort": {"account": {"code": "..."}}}

BIC

an..11

O

BIC of the user which appears predefined in the transfer window

BIC des Nutzers, die voreingestellt im Überweisungsfenster erscheint

AddrCountryCode

"billing": {"addressInfo": {"country": {"A2": "..."}}}

a2

M

Two characters country code according to ISO 3166. Presently DE, AT, BE, NL, ES, CH

, IT permitted.

Ländercode zweistellig gemäß ISO 3166. Derzeit DE, AT, BE, NL, ES, CH

, IT zulässig.

Language

"language": "..."

a2

O

Language: de - German, en – English, fr- French, nl - Dutch, pl - Polish

Sprache: de - deutsch, en – Englisch, fr- Französisch, nl - Niederländisch, pl - Polnisch

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	URLSuccess_REST
page	URLSuccess
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	URLFailure_REST
page	URLFailure
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Response_REST
page	Response
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	URLNotify_REST
page	URLNotify
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	UserData_REST
page	UserData
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	ReqId-ans..32_REST
page	ReqId
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2	static	true
name	SellingPoint_REST
page	SellingPoint
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Service_REST
page	Service
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Channel_REST
page	Channel
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Plain_REST
page	Plain
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Custom_REST
page	Custom
type	page

Parameters for Sofort via PPROvia PPRO

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	RestResponse_IntroURL
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	ResponseKvpResponse_IntroURL
PageWithExcerpt	Reuse API

Table Filter

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

Multiexcerpt

MultiExcerptName	sofort_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1646645639027_207264933
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
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

Key

Format

CND

Description

Beschreibung

RefNr

ans..40

O

Merchant’s unique reference number. Only characters a-zA-Z0-9,-_ are allowed.

Table Excerpt Include

static	true
name	RefNr_PPRO
page	refnr
type	page

Eindeutige Referenznummer des Händlers. Nur die Zeichen a-zA-Z0-9,-_ sind erlaubt.

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

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	Eindeutige Transaktionsnummer bei PPRO
AccOwner	asans3..50	O	Name of account holder	Name des Kontoinhabers
AccBank	ans..50	O	Name of the account holder’s bank	Bezeichnung der Bank des Kontoinhabers
IBAN	an..34	O	International Bank Account Number	International Bank Account Number
BIC	an..11	O	Bank Identifier Code	Bank Identifier Code

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Result parameters for URLNotify, URLSuccess and URLFailure in case of Sofort via PPRO

Credit with Sofort

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.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Credit_Intro
PageWithExcerpt	Reuse API

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

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	1646646323098_-1956940867
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	1646646323100_1493634476
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

isFirstTimeEnter	true
static	true
v	2
name	MerchantID_REST
page	MerchantID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID_Credit_REST
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	TransID_REST
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Amount_REST
page	Amount
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2	static	true
name	Currency_REST
page	Currency
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	MAC_REST
page	MAC
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	ReqId-ans..32_REST
page	ReqId
type	page

Parameters for credits via socket connections

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	1646646430732_-1032560927
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	1646646430734_-1869471774
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

isFirstTimeEnter	true
static	true
v	2
name	MID_REST
page	mid
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	PayID_REST
page	PayID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	XID_REST
page	XID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	TransID_REST
page	TransID
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Status_OK_FAILED_REST
page	Status
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Description_REST
page	Description
type	page

Table Excerpt Include

isFirstTimeEnter	true
static	true
v	2
name	Code_REST
page	Code
type	page

Response parameters for credits with Sofort via socket connections

Batch processing via the interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Intro
PageWithExcerpt	Reuse API

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 a refund for Sofort 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 an their specialities:

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1646646620516_66283260
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	1646646620517_-411227014
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 Sofort within a Batch file to be submitted is the following:

Multiexcerpt

MultiExcerptName	batch_structure
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
SOFORT,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

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

Table Filter

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

Multiexcerpt

MultiExcerptName	batch_request

Eindeutige Referenznummer des Händlers. Nur die Zeichen a-zA-Z0-9,-_ sind erlaubt.

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1646646722839_1029742081
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, SOFORT for Sofort	HEAD für Header, FOOT für Footer, SOFORT für Sofort
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

Key

Format

CND

Description

Beschreibung

RefNr

ans..40

O

Merchant’s unique reference number. Only characters a-zA-Z0-9,-_ are allowed.

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> 
SOFORT,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Response_Intro
PageWithExcerpt	Reuse API

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> correspond to the call as specified above):

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1646647003411_-791936228
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	1646647003412_-496818837
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

Page tree

Versions Compared

Old Version 1

New Version Current

Key

About Sofort

General information about Sofort

Process flow chart

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Calling the interface

Credit with Sofort

Batch processing via the interface

Batch processing via the interface

Help

Intranet Tools

Page tree

Page History

Versions Compared

Old Version 1

New Version Current

Key

About Sofort

General information about Sofort

Process flow chart

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

Calling the interface

Credit with Sofort

Batch processing via the interface

Batch processing via the interface

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface