PostFinance Checkout

In this article, you will learn how to add PostFinance Checkout as an external payment provider to your Payrexx account.

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 wish to use PostFinance Checkout, this page will guide you through the process.

General

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.

Features

Payment types

✅ 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.

Setup

Configuration of Postfinance Checkout

Request an Offer

Find Postfinance Checkout in your Payrexx dashboard in the list of payment providers. You can easily request an offer by hitting the Setup button.

Settings

Set up a specific "Space" for the Space-Name. We recommend using the name of your shop.

In the PF Checkout account, under space > configuration > payment method, you find the available payment methods. Activate all payment methods in the payment step:

Postfinance does not automatically add payment methods for Visa and Mastercard.

Please add them manually. The titles must be Mastercard and Visa.

Activate “Payrexx E-commerce Tool” in the “Integration” Step

Create User

Then generate the three security keys with "Create user" and enter them in the Payrexx shop in accordance with the instructions in the next step.

Follow the instructions in the set-up assistant. Once you have done this, PostFinance Checkout is ready for a free test using payment screen simulators.

Configuration of Payrexx

Make sure you log in to Payrexx before you start.

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:

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

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

Mode: Enable the test mode for PostFinance Checkout.
Payment methods: Activate the desired payment methods by checking the corresponding boxes.
Currencies: Define the currencies you want to accept payments in.
Productive account settings: Leave these fields empty for now.
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.

Activation of PostFinance Checkout in productive mode

Log in to your PostFinance account.
Navigate to Payment Contracts in the menu and click on "Sign now" to sign the contract for productive payments.

Within a maximum of 10 working days, you will receive a notification from PostFinance that the productive mode is ready.

Now, repeat the steps described under Activation of PostFinance Checkout in test mode, but with the following changes:
- Select "Productive" in the Mode field.
- Copy the Space ID (four-digit number after the name of the space), the application user ID, and the authentication key from the productive mode in PostFinance Checkout into the corresponding fields under "Productive account settings".
Click the green "Save" button.