PostFinance Checkout

This article explains how to integrate PostFinance Checkout as an external payment provider in Payrexx to receive payments.

General Information

PostFinance Checkout is an online payment solution from PostFinance that allows you to offer your customers payment options with Visa, Mastercard, as well as Swiss payment methods such as PostFinance Card, PostFinance E-Finance, and TWINT.

Links

• Login to PostFinance Checkout

• Registration with PostFinance Checkout

• PostFinance Checkout Website

• PostFinance Checkout Documentation

Features

Payment types

The following features are available in the Payrexx merchant administration panel:

• ✅ One-time payment

• ✅ Refund

• ❌ Partial refund

• ❌ Recurring payments (Subscription)

• ❌ Tokenization

• ❌ Pre-authorization

Payment methods

• Postfinance Card

• Postfinance E-Finance

• TWINT

• Mastercard

• Visa

Country Availability

PostFinance Checkout is exclusively available to merchants from 🇨🇭 Switzerland.

Instead of activating PostFinance Checkout as an external payment provider, we recommend enabling the PostFinance Pay payment method within Payrexx Pay, which can be done with just one click.

However, if you still wish to use PostFinance Checkout, this guide will explain how to proceed.

Setup

Please follow the instructions below to integrate PostFinance Checkout as an external payment provider in Payrexx.

Configuration of Postfinance Checkout

• Log in to your PostFinance Checkout account.

• Create a new space and name it after your shop.

• Navigate to Payment / Payment methods / E-Commerce and configure the desired payment methods:

Configuring payment methods in PostFinance Checkout

PostFinance does not automatically add Mastercard and Visa. Please add these payment methods manually and label them as "Mastercard" and "Visa".

• Navigate to Settings > Integrations and activate the "Payrexx E-Commerce Tools" extension by clicking the yellow button:

Activating the Payrexx integration in PostFinance Checkout

• Follow the instructions in the setup wizard and generate the three security keys.

• Make sure to securely store these three security keys, as you will need to enter them in Payrexx at a later step.

• Once the setup wizard is complete, the PostFinance Checkout test mode will be ready:

The activated Payrexx integration in PostFinance Checkout

Configuration of Payrexx

Make sure you're logged in to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can register now.

• Navigate to Payment Providers in the main menu of your Payrexx account.

• Click on "Show" under "Credit cards and debit cards".

• Click on "Setup" next to PostFinance Checkout:

Starting the configuration of PostFinance Checkout in Payrexx

• If you do not yet have a corresponding account with PostFinance, click "Yes." If you already have an account, click "No, not now":

Option to create an account with PostFinance

• If you clicked "Yes," you will be redirected to PostFinance, where you can create an account. If you clicked "No," you can make the desired settings in the following window:

Activation of PostFinance Checkout in test mode

Configuration of PostFinance Checkout in Payrexx

1. Mode: Enable the test mode for PostFinance Checkout.

2. Payment methods: Activate the desired payment methods by checking the corresponding boxes.

3. Currencies: Define the currencies you want to accept payments in.

4. Productive account settings: Leave these fields empty for now.

5. Sandbox account settings: Copy the Space ID (four-digit number after the name of the space), the application user ID, and the authentication key from the test mode (sandbox) in PostFinance Checkout into the corresponding fields.

When copying this data, it is possible to accidentally include an extra space. Ensure that this does not happen to avoid any issues.

• Click "Save" to complete the configuration.

The test mode for PostFinance Checkout is now activated. In the following article, you will learn how to test the payment process:

Testing

After completing the tests, you can activate the productive mode for PostFinance Checkout.

Switching from Test Mode to Live Mode

After completing your tests, you can activate the payment solution in productive mode (live mode).

• Log in to your PostFinance Checkout account.

• Navigate to the Contracts section in the menu and finalize a contract for live payments.

Once the productive mode is activated, you will receive a confirmation from PostFinance. This process can take up to 10 business days.

• Repeat the steps described in the Activating PostFinance Checkout in test mode section, with the following adjustments:

  • In the Mode field, select "Live".

  • Copy the Space ID, Application User ID, and Authentication Key for live mode from your PostFinance Checkout account into the Productive Account Settings fields.

The setup of PostFinance Checkout as an external payment provider is now complete.

Payment with PostFinance Checkout from the Customer's Perspective

• In the Payrexx checkout, the customer selects either PostFinance Card or PostFinance E-Finance:

Selection of desired payment method

• The customer is redirected to the PostFinance website, where they choose whether to pay with the PostFinance App or with PostFinance Card:

Executing the payment on the PostFinance website

• The customer follows the instructions and completes the payment.