About PostFinance

General information about PostFinance

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.

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

Process flow chart

PostFinance process flow

interface

Payment with PostFinance via form interface

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

Parameters for payments with PostFinance

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:

Parameters for credit payments with PostFinance via socket connection

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.

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:

Description of the possible batch versions

The structure for a PostFinance credit within a Batch file to be submitted is the following:

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:

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

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

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

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

Description of result parameters within the record for Batch files