PostFinance E-COMMERCE Registration and Integration Manual into Payrexx

In the basic PostFinance package (E-Commerce Basic) you get PostFinance card as well as Postfinance e-finance. The compact Postfinance package (Startup) provides you with the useful mix of payment methods. Above Postfinance payment methods you can also provide your customers with the common payment methods such as Visa, Mastercard and American Express. With the complete package called "Professional" you can provide your customers with further worldwide known payment methods such as Paypal, JCB and Diners Club.
  • Apply for a PostFinance e-Payment account.
    Apply for an e-Payment account now.
    (You can also request a contract offer in your Payrexx backend at settings -> payment providers -> PostFinance.
  • Please make sure to activate the following option at PostFinance: 
    • TPD ¦ Dynamic Template 
  • PostFinance will send to you an e-mail with your access data.
    Enter this data into the input boxes using the test mode in your Payrexx back end. Also, select the corresponding e-Payment package and the currencies which should be activated. Click "Save".

Configuration of the PostFinance account

Follow the simple instructions down below to do the configuration of the PostFinance account


Visit the URL with your web browser (as long as your instance is still running in test mode, otherwise use the URL Enter your „PSPID“ and your „Password“, then click on „Submit“. After the login has been successfully completed, navigate to „Configuration / Technical information“.

Data and origin verification

Navigate to „Data and origin verification“ [1]. Value for „URL of the merchant page“ [2] has to be left empty. Replace „NAME“ again with the subdomain.

Enter the value for „SHA-IN pass phrase “ [3] which you have defined in the Payrexx administration in „Home / Settings / Payment providers / PostFinance“ for the field „SHA-IN signature“ [4]. Then click on the button „Save“. 

Global transaction parameters

Navigate to „Global transaction parameters“ [1] and ensure, the „Default operation code“ is set on „Sale“ [2] and in the section „Processing for individual transactions“ the option „Always online (Immediate).” [3] is selected. Then click on the button „Save“. 

Global security parameters

Navigate to „Global security parameters“ [1] and select the options „Each parameter“ [2], „SHA-1“ [3] and „Use the character encoding expected with the initial transaction request“ [4]. 

Choose „Yes“ for „Allow usage of dynamic template“ [1] and enter the value for the field „Trusted website hostname“ [2] which can be seen on the picture. Please note that you have to replace „NAME“ with the subdomain name which you’ve chosen at the registration process. Then click on the button „Save“.

Payment page

Navigate to „Payment page“ [1] and enter the value for „Back button redirection“ [2] which can be seen on the picture. Here you also have to replace „NAME“ with the subdomain of your installation. Then click on the button „Save“.


Navigate to „Transaction feedback“ [1]. Enter the values for the fields „AcceptURL“ [2], „DeclineURL“ [3], „ExceptionURL“ [4] and  „CancelURL“ [5] in the section „HTTP redirection in the browser“ which can be seen on the picture. Replace the word „NAME“ again with your installation’s subdomain. Ensure that the checkboxes [6] and [7] have been checked. (If you are using Payrexx UK, make sure that the checkbox [7] is not checked.)

As next enable under "Dynamic Ecommerce Parameters" COMPLUS & ORDERID, otherwise server-to-server feedback will not work.

Select the options „Always online“ [1] for „Timing of the request“ and „POST“ [4] for the „Request method“ in the section „Direct HTTP server-to-server request“. Enter the value for the fields „Payment’s status“ [2] and [3] which can be seen on the picture. Replace the placeholder „NAME” with your installation’s name.


Enter the value for „SHA-OUT pass phrase“ [1] in the section „All transaction submission modes“ which you have defined in the  Payrexx administration in „Home / Settings / Payment providers / PostFinance“ in the field „SHA-OUT signature “ [3]. Select the option „No request“ [2] for the setting „HTTP request for status changes”. Then click on the button „Save“.

Transaction e-mails

Navigate to „Transaction e-mails“ and enter your email address in the field „E-mails address(es) for transaction-related e-mails“. Then click on the button „Save“.

Activate the PostFinance payment methods in Payrexx back end.

  • Test the payment procedure in the front end.
  • Request PostFinance to activate productive operation. To do so, send an email including your PSPID to PostFinance.
  • After receiving confirmation of the productive operation switch to the "Productive mode" in Payrexx back end and check the log in data in the input boxes below (the data for productive operation will normally be identical to the data for the test account). Click "Save".

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.