PostFinance

Set up PostFinance Account

Step 1: In the PostFinance BackOffice click: Configuration > Technical information > Global transaction parameters. Configure the Global transaction parameters.

The table below provides the description of the required settings.

Settings	Value
Default operation code	Select "Sale".
Processing for individual transactions	Select "Online but switch to offline when the online acquiring system is unavailable".

Step 2: Click: Configuration > Technical information > Global security parameters. Configure the Global security parameters.

The table below provides the description of the required hashing method settings.

Settings	Value
Compose the string to be hashed by concatenating the value of	Select "Each parameter followed by the passphrase. (Please refer to our integration guides for further details)".
Hash algorithm	Select "SHA-512" in order to comply with the highest data security standards.   The same value should be set in Sana Admin (Hash algorithm).
Character encoding	Select "UTF-8".

Step 3: Click: Configuration > Technical information > Payment page.

Configure Back button redirection by specifying the URL of the webpage that should be shown to the customer when he clicks the "back" button on the PostFinance secure payment page.

Step 4: Click: Configuration > Technical information > Data and origin verification.

URL of the merchant page containing the payment form that will call the page: orderstandard.asp

PostFinance checks for the origin of the request the order originates from. The URL should contain the protocol "http" or "https" at the beginning. If you have installed several languages for your web store or you have multiple web stores for your PostFinance account, make sure you have entered all URLs separated by a semicolon.

Examples:
http://www.webshop.com/en-us/checkout/orderoverview;http://www.webshop.com/nl-nl/checkout/orderoverview

http://www.webshop01.com/checkout/orderoverview;http://www.webshop02.com/checkout/orderoverview

The value of the SHA-IN pass phrase parameter should match the value of the SHASIGNIN parameter in Sana Admin.

Step 5: Click: Configuration > Technical information > Transaction feedback.

Configure HTTP redirection in the browser. Select the checkboxes:

• I would like to receive transaction feedback parameters on the redirection URLs.
• I would like PostFinance to display a short text to the customer on the secure payment page if a redirection to my website is detected immediately after the payment process. - This option is not essential for the correct functioning of PostFinance.

Step 6: In case PostFinance cannot connect to Sana for some reason to update the payment status of the order, it can be updated later, if you set up server-to-server communication.

On the Transaction feedback tab, set up the Direct HTTP server-to-server request settings.

Direct HTTP server-to-server request
Timing of the request	Select "Online but switch to deferred request when the online request fail".
URL of the merchant's post-payment page	Enter the following URL with the protocol in both fields. Replace "[DOMAIN]" with your web store domain. https://[DOMAIN]/confirm/payment/PostFinance
Request method	Select "POST".

Step 7: On the Transaction feedback tab, set up the Dynamic e-Commerce parameters.

"NCERROR", "PAYID", "ORDERID" and "STATUS" are default parameters. Select other parameters which you wish to receive as feedback for a transaction.

Step 8: Make sure that the following options are not selected on the Transaction feedback tab.

Step 9: On the Transaction feedback tab, set up the Security for request parameters.

The value of the SHA-OUT pass phrase parameter should match the value of the SHA out deliminator parameter in Sana Admin.

Step 10: On the Transaction feedback tab, set up HTTP request for status changes.

Select "For each offline status change (payment, cancellation, etc.)".

Enter the following URL and replace "[DOMAIN]" with your web store domain.

https://[DOMAIN]/confirm/payment/PostFinance

Step 11: Click: Configuration > Technical information > Transaction e-mails.

In the E-mails to the merchant parameters enter the e-mail address to which the information messages from PostFinance should be sent. Determine what type of messages you want to receive.