Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space ENWORK and version Documentation
Table of Contents


About PostFinance

General information about PostFinance

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Name
PageWithExcerptWording
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.

TypePayments by Online Bank Transfer


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

 

Process flow chart

Multiexcerpt
MultiExcerptNameProcessFlow

draw.io Diagram
bordertrue
diagramNamePostFinance_CT
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth1109

PostFinance process flow


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNamePlatform-Kurz
PageWithExcerptWording
interface

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameDefinition
PageWithExcerptDefinition 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
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
postfinance.aspx


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623747141404_-1123228300
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamepostfinance_request
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1623747141407_34704776
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

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
statictrue
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

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
statictrue
nameURLSuccess
pageURLSuccess
typepage

Table Excerpt Include
statictrue
nameURLFailure
pageURLFailure
typepage

Table Excerpt Include
statictrue
nameResponse
pageResponse
typepage

Table Excerpt Include
statictrue
nameURLNotify
pageURLNotify
typepage

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Table Excerpt Include
statictrue
nameReqId-ans..32
pageReqId
typepage

Table Excerpt Include
statictrue
nameSellingPoint
pageSellingPoint
typepage

Table Excerpt Include
statictrue
nameService
pageService
typepage

Table Excerpt Include
statictrue
nameChannel
pageChannel
typepage

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
AccOwnerans..50MName of account holderName des Kontoinhabers
Devicea6ODevice selection: if “Mobile” is submitted the mobile version of PostFinace is called instead of the desktop versionGeräteauswahl: bei Übergabe von „Mobile“ wird statt der Desktop-Version die Mobil-Version von PostFinance aufgerufen
ProductNamea..24O

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
statictrue
namePlain
pagePlain
typepage

Table Excerpt Include
statictrue
nameCustom
pageCustom
typepage

Parameters for payments with PostFinance


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_IntroURL
PageWithExcerptReuse API

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623747813665_312723625
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamepostfinance_response
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1623747813666_265801068
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMID
pagemid
typepage

Table Excerpt Include
statictrue
namePayID
pagePayID
typepage

Table Excerpt Include
statictrue
nameXID
pageXID
typepage

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

Table Excerpt Include
statictrue
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

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 Antwortparameter PaymentPurpose.

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
nameUserData
pageUserData
typepage

Key

Format

CND

Description

Beschreibung

TID

ans..40

O

Transaction reference for PostFinance

Transaktionsnummer bei PostFinance
PaymentPurposeans..26M

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
SpaceWithExcerptEN
MultiExcerptNamePartner-Name
PageWithExcerptWording
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
SpaceWithExcerptDE
MultiExcerptNamePartner-Name
PageWithExcerptDE:Wording
:
paymentpurpose=9D1G74P John Doe GmbH
 
Daten aus der Postfinance-Datei:
<MerchantOrderId>9D1G74P</MerchantOrderId>

PaymentGuaranteea..12C

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
statictrue
nameErrorText_PPRO
pageErrorText
typepage

Key

Format

CND

Description

Beschreibung

TransactionID

an..20

O

Unique transaction number from PPRO

Eindeutige Transaktionsnummer bei PPRO

Table Excerpt Include
statictrue
namePlain
pagePlain
typepage

Table Excerpt Include
statictrue
nameCustom
pageCustom
typepage

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. To carry out a credit

with

a

reference

transaction, please use the following URL:

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptName

BaseURL

Credit_Intro
PageWithExcerptReuse API

credit.aspx

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBaseURL
PageWithExcerptWording
Wording


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameRequest_Intro
PageWithExcerptReuse API

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623749781774_1705504988
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamecredit_request
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1623749781777_-976239833
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMerchantID
pageMerchantID
typepage

Table Excerpt Include
statictrue
namePayID_Credit
pagePayID
typepage

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

Table Excerpt Include
statictrue
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Table Excerpt Include
statictrue
nameMAC
pageMAC
typepage

Table Excerpt Include
statictrue
nameReqId-ans..32
pageReqId
typepage

Parameters for credit payments with PostFinance via socket connection


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameResponse_Intro
PageWithExcerptReuse API

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623749901832_1913448944
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamecredit_response
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1623749901833_933232196
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * FROM T*

Table Excerpt Include
statictrue
nameMID
pagemid
typepage

Table Excerpt Include
statictrue
namePayID
pagePayID
typepage

Table Excerpt Include
statictrue
nameXID
pageXID
typepage

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

Table Excerpt Include
statictrue
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
statictrue
nameDescription
pageDescription
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

Table Excerpt Include
statictrue
nameRefNr_PPRO
pagerefnr
typepage

Table Excerpt Include
statictrue
nameErrorText_PPRO
pageErrorText
typepage

Response parameters for credit payments with PostFinance 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.

Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBatch_Intro
PageWithExcerptReuse API

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 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
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623750155275_-1182871624
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamebatch_versions
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1623750155277_-461664813
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * 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
MultiExcerptNamebatch_structure
shouldDisplayInlineCommentsInIncludesfalse
Code Block
languagexml
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
MultiExcerptNamebatch_mastermid
shouldDisplayInlineCommentsInIncludesfalse
Code Block
languagexml
HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBatch_Request_Intro
PageWithExcerptReuse API
The following table describes the individual fields and values used within the data set (record) in the batch file:

Table Filter
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623750201565_-462150057
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamebatch_request
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1623750201567_597308878
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * 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
nameAmount
pageAmount
typepage

Table Excerpt Include
statictrue
nameCurrency
pageCurrency
typepage

Table Excerpt Include
statictrue
nameTransID
pageTransID
typepage

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
statictrue
namePayID_Batch
pagePayID
typepage

Description of fields within the record for Batch files

 

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

Multiexcerpt
MultiExcerptNamebatch_structure_response
shouldDisplayInlineCommentsInIncludesfalse
Code Block
languagexml
HEAD,<MerchantID>,<Date>,<Version>
PostFinance,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>


Multiexcerpt include
SpaceWithExcerptEN
MultiExcerptNameBatch_Response_Intro
PageWithExcerptReuse 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
defaultBeschreibung
isFirstTimeEnterfalse
hideColumnstrue
sparkNameSparkline
hidePanetrue
datepatterndd M yy
id1623750567747_2008448079
worklog365|5|8|y w d h m|y w d h m
isORAND
separatorPoint (.)
order0
Multiexcerpt
MultiExcerptNamebatch_response
Table Transformer
dateFormatdd M yy
export-wordfalse
show-sourcefalse
export-csvfalse
id1623750567748_-1411442441
transposefalse
worklog365|5|8|y w d h m|y w d h m
separator.
export-pdffalse
sqlSELECT * 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
statictrue
namePayID_Batch
pagePayID
typepage

Table Excerpt Include
statictrue
nameStatus_OK_FAILED
pageStatus
typepage

Table Excerpt Include
statictrue
nameCode
pageCode
typepage

Description of result parameters within the record for Batch files