Table of Contents

About PostFinance

General information about PostFinance

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Name
PageWithExcerpt	Wording

supports various online transfers in different countries via the acquirer PPRO. Merchants benefit from the payment guarantee, the immediate execution by advance payment and the large reachable customer base. On the other hand, customers use the familiar environment of their online banking and thus also gain confidence in the online shop. This lowers the number of cancelled orders and increases the conversion rate.

The PostFinance-Bank’s Yellowpay online transfer operates without a transaction limit, but with a payment guarantee for the merchant and reaches more than 3.5 million potential in Switzerland.

Page properties

Logo

Info

Excerpt
PostFinance is an online banking payment method in Switzerland and is the market leader in Swiss payment transactions with a market share of around 60%. With PostFinance merchants can reach over 3.5 million potential customers.

Type

Payments by Online Bank Transfer

Further information can be found on the webpage of PostFinance (https://www.postfinance.ch/).

Process flow chart

Multiexcerpt

MultiExcerptName	ProcessFlow

draw.io Diagram

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

PostFinance process flow

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

Payment with PostFinance via form interface

To make a payment with PostFinance (E-Finance) online transfer in Switzerland, go to please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

postfinance.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	1623747141404_-1123228300
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	postfinance_request

Table Transformer

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

Key

Format

CND

Description

Beschreibung

RefNr

ans..40

O

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

Note: Please consider response parameter PaymentPurpose.

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

Hinweis: Bitte beachten Sie den Antparameter PaymentPurpose.

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

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	O	Description of goods and prices. Intended purpose on the statement of account	Beschreibung der Waren, Einzelpreise usw., 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 für die Zahlungsseiten für den Kunden bevorzugt werden soll
AccOwner	ansans3..50	M	Name of account holder	Name des Kontoinhabers
Device	a6	O	Device selection: if “Mobile” is submitted the mobile version of PostFinace is called instead of the desktop version	Geräteauswahl: bei Übergabe von „Mobile“ wird statt der Desktop-Version die Mobil-Version von PostFinance aufgerufen
ProductName	a..24	O	Preselection of payment type to be used - yellownet (for eFinance) - PostFinanceCard (for PostFinance card) Notice: If this parameter is not submitted, the customer can select payment type by himself later.	Vorauswahl der zu verwendenden Zahlungsart: - yellownet (für eFinance) - PostFinanceCard (für PostFinance-Karte) Hinweis: Wenn der Parameter nicht übergeben wird, kann der Kunde später die Zahlungsart selbst wählen.

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 PostFinance

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

Multiexcerpt

MultiExcerptName	postfinance_response

Table Transformer

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

Key

Format

CND

Description

Beschreibung

RefNr

ans..40

O

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

Note: Please consider response parameter PaymentPurpose.

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

Hinweis: Bitte beachten Sie den Antparameter Antwortparameter PaymentPurpose.

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 for PostFinance

Transaktionsnummer bei PostFinance

PaymentPurpose

ans..26

M

Unique ID which is generated by PPRO and provided within the own settlement file of PostFinance. This ID should be used on merchant side for reconcilliation of open positions. RefNr can not be used for this purpose with this payment method.

Please note: When using the OrderDesc simulation, the parameter is not returned, when using the PPRO test system, the return is abbreviated without trader names and complete in the live system. Live system example: "9D1G74P John Doe GmbH".

If you use the value PaymentPurpose to debit the payment using the Postfinance EPAY... .xml file, you will only receive the abbreviated version in the TAG=MerchantOrderId with which you can carry out the comparison.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Partner-Name
PageWithExcerpt	Wording

response data:
paymentpurpose=9D1G74P John Doe GmbH

Data from Postfinance file:
<MerchantOrderId>9D1G74P</MerchantOrderId>

Eindeutige ID, welche von PPRO generiert und im eigenen Abrechnungsfile von PostFinance bereitgestellt wird. Diese ID sollte auf Händlerseite zum Abgleich offener Positionen verwendet werden. Die RefNr kann für diesen Zweck bei dieser Zahlungsmethode nicht verwendet werden.

Bitte beachten Sie: Bei Verwendung der OrderDesc-Simulation wird der Parameter nicht zurückgegeben, bei Nutzung des PPRO-Testsystems erfolgt die Rückgabe gekürzt ohne Händlernamen und im Live-System vollständig. Beispiel Live-System: "9D1G74P John Doe GmbH".

Nutzen Sie den Wert PaymentPurpose zum Ausbuchen der Zahlung anhand des Postfinance EPAY... .xml File, erhalten Sie im TAG=MerchantOrderId auch nur die verkürzte Variante, mit welcher Sie den Abgleich ausführen.

Antwortdaten von

Multiexcerpt include

SpaceWithExcerpt	DE
MultiExcerptName	Partner-Name
PageWithExcerpt	DE:Wording

:
paymentpurpose=9D1G74P John Doe GmbH

Daten aus der Postfinance-Datei:
<MerchantOrderId>9D1G74P</MerchantOrderId>

Eindeutige ID, welche von PPRO generiert und im eigenen Abrechnungsfile von PostFinance bereitgestellt wird. Diese ID sollte auf Händlerseite zum Abgleich offener Positionen verwendet werden. Die RefNr kann für diesen Zweck bei dieser Zahlungsmethode nicht verwendet werden.

PaymentGuarantee

a..12

C

FULL: payment guarantee

Notice: This parameter is only returned if the Status=OK.

FULL: Zahlungsgarantie

Hinweis: Dieser Parameter wird nur zurückgegeben, falls der Status=OK ist.

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

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 PostFinance

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.

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	1623749781774_1705504988
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	1623749781777_-976239833
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 PostFinance 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	1623749901832_1913448944
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	credit_response

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	1623749901833_933232196
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

Key

Format

CND

Description

Beschreibung

RefNr

ans..40

O

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

	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 PostFinance via socket connection

Batch processing via the interfacevia the interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Intro
PageWithExcerpt	Reuse API

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 PostFinance 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:

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1623750155275_-1182871624
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	1623750155277_-461664813
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 PostFinance credit within a Batch file to be submitted is the following:

Multiexcerpt

MultiExcerptName	batch_structure
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

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

Version MultiMerchant:
HEAD,<[Master]MerchantID>,<Date>,<2.x>
PostFinance,Action,<[Slave]MID>,<Amount>,<Currency>,<TransID>,Data (depends on Action)
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) in the batch file:

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1623750201565_-462150057
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	1623750201567_597308878
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, PostFinance for PostFinance	HEAD für Header, FOOT für Footer, PostFinance für PostFinance
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..30	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

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>
PostFinance,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> and request parameters are returned unchanged and correspond to the call as specified before):

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1623750567747_2008448079
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	1623750567748_-1411442441
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 PostFinance

General information about PostFinance

Process flow chart

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Payment with PostFinance via form interface

Credit with reference

Batch processing via the interfacevia the interface

Help

Intranet Tools

Page tree

Page History

Versions Compared

Old Version 1

New Version Current

Key

About PostFinance

General information about PostFinance

Process flow chart

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

Payment with PostFinance via form interface

Credit with reference

Batch processing via the interfacevia the interface

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface