Docs
DocsPlattformDeveloperTicket
ENGLISH
ENGLISH
  • Welcome to Payrexx
  • The first steps
    • Overview of Payrexx
    • Account Verification
      • Prohibited Business Models
  • Payments
    • Functionalities
      • Pre-authorization
      • Tokenization
      • Subscriptions
        • Subscriptions managed by Payrexx
        • Subscriptions via tokenization (API)
      • Refunds and Partial Refunds
      • MOTO payments
    • Testing
    • Payment Status
    • Disputes
      • Definition
      • Prevention
        • Fraudulent
        • Credit not processed
        • Duplicate
        • Product not received
        • Product unacceptable
        • Subscription canceled
        • Unrecognized
      • Processing and submitting evidence
        • Fraudulent
        • Credit not processed
        • Duplicate
        • Product not received
        • Product unacceptable
        • Subscription canceled
        • Unrecognized
      • Best Practices
      • FAQ
    • FAQ
  • Payment Services
    • Payrexx Pay and Payrexx Pay Plus
      • Activation and Configuration
      • Function Matrix for Payment Methods
      • Payment methods
        • Alipay
        • American Express
        • Apple Pay
        • Bancontact
        • Centi
        • Click to Pay with Visa
        • Diners Club International
        • Discover Card
        • eps
        • Google Pay
        • iDEAL
        • Klarna
        • Mastercard
        • Pay by Bank
        • PostFinance Pay
        • Przelewy24
        • Purchase on Invoice
        • Reka
        • Samsung Pay
        • SEPA Debit Direct
        • TWINT
          • TWINT "Pay later"
        • Visa
        • WeChat Pay
      • Card Regions and Fees
      • Charging Virtual Credit Cards
    • Payment Provider Feature Matrix
    • Country Availability
    • External Payment Providers
      • Credit Cards and Debit Cards
        • Braintree
        • CCAvenue
        • Clearhaus
        • Datatrans
        • HeyLight
        • Ingenico ePayment
          • Ingenico E-COMMERCE
          • Ingenico ALIAS GATEWAY
        • Mollie
        • Nexi (Concardis)
        • PAYONE
        • PostFinance Checkout
        • Skrill
        • Stripe
        • VIVEUM
        • Worldline (Saferpay)
      • Alternative Payment Methods
        • Amazon Pay
        • Barzahlen/viacash
        • boncard / Lunch-Check
        • Coinbase
        • Giropay
        • Ideal Payment
        • Klarna
        • PayPal
        • Paysafecash
        • PointsPay
        • POWERPAY
        • TWINT
        • WIRpay
        • xMoney
      • Manual Payment Methods
        • Advance Payment
        • Bill
        • Reka-Check
    • Buy Now Pay Later
    • PCI-DSS Compliance
  • Account and administration
    • Dashboard
    • Payments
      • Transactions
      • Subscriptions
      • Pre-Authorization
      • Tokenization
      • Export
    • Payouts
      • Rolling Reserve
    • Customers
    • Reports
    • Tools
      • Pages
        • Products
        • Pages Subscriptions
        • Discount Codes
        • Website Integration
        • Google Merchant Center
      • Paylink
        • Paylink Subscriptions
      • QR Pay
      • Terminal
      • Invoice
      • Donation
        • Donation Subscriptions
        • Website Integration
      • Parameter
    • API and Plugins
    • Webhooks
    • Payment Providers
    • Settings
      • General Settings
        • Multilingual Frontend
        • Google Analytics
        • Facebook Meta Pixel
        • Custom Domain
        • 2-Factor Authentication
      • Company Data
      • Payouts Settings
      • User Administration
      • Look & Feel
      • Notifications
      • Legal
      • Plan and Billing
    • FAQ
  • Integration
    • E-Commerce Systems
      • WooCommerce
      • Shopware 6
      • Shopware 5
      • Magento 2
      • PrestaShop
      • Gambio
      • Shopify
      • MyCommerce
      • Ecwid
      • JTL Shop 5
      • nopCommerce
      • Gravity Forms
      • Sylius
      • CS Cart
      • Odoo
      • saldiaShop
      • FLOW Shopsoftware
    • Content Management Systems (CMS)
      • Cloudrexx
      • Concrete5
      • Drupal
      • Jimdo
      • JoomDonation
      • Modmore
      • Paymattic
      • Weebly
      • WIX
      • Zappter
    • Business Software
      • aforms
      • Cura Fundraising
      • Deinlokal (maaxx)
      • GUVOTO
      • Make
      • Reservation System (Hürlimann Informatik)
      • SelectLine
      • Zapier
    • Other Integrations
  • Point of Sale
    • POS Terminals Overview
    • Ordering a Terminal
    • Tutorials
      • Terminal Basics
      • Operating the Terminal
      • Connecting to the Internet
      • Performing Transactions
      • Managing Transactions
      • Advanced Settings
    • Returning a Terminal
  • Tap to Pay
    • Tap to Pay Overview
    • Setting Up Tap to Pay
    • Processing Payments
    • Transaction Overview
    • Analytics Tools
    • Tap to Pay Settings
  • SUPPORT
    • Payrexx Support Portal
    • Frequently Asked Questions
  • Accessibility
  • Release Notes
    • Release Notes 2025
      • Release 2025.05
      • Release 2025.04
      • Release 2025.02
    • Release Notes 2024
      • Release 2024.11
      • Release 2024.09
      • Release 2024.07
      • Release 2024.05
      • Release 2024.03
      • Release 2024.01
    • Release Notes 2023
      • Release 2023.12
Powered by GitBook
LogoLogo

Product

  • Payments
  • E-Commerce Tools
  • Pricing
  • Feedback

Company

  • About Us
  • Careers
  • Blog
  • Newsletter

Support

  • Contact
  • Statuspage
  • Downloads

Developer

  • Documentation
  • API Reference
  • Integrations & Plugins

© Payrexx. All rigths reserved.

On this page
  • General Information
  • Links
  • Features
  • Payment types
  • Payment methods
  • Country Availability
  • Setup
  • Configuration of Postfinance Checkout
  • Configuration of Payrexx
  • Switching from Test Mode to Live Mode
  • Payment with PostFinance Checkout from the Customer's Perspective

Was this helpful?

  1. Payment Services
  2. External Payment Providers
  3. Credit Cards and Debit Cards

PostFinance Checkout

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

Last updated 14 days ago

Was this helpful?

Instead of activating PostFinance Checkout as an external payment provider, we recommend enabling the 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.

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

  • to PostFinance Checkout

  • with PostFinance Checkout

  • PostFinance Checkout

  • PostFinance Checkout

Features

Payment types

  • ✅ One-time payment

  • ✅ Refund

  • ❌ Partial refund

  • ❌ Recurring payments (Subscription)

  • ❌ Tokenization

  • ❌ Pre-authorization

Payment methods

Country Availability

Setup

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:

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:

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

Configuration of Payrexx

  • 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

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

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

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

  4. 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:

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.

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

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

  • The customer follows the instructions and completes the payment.

Postfinance Card

Postfinance E-Finance

TWINT

Mastercard

Visa

PostFinance Checkout is exclusively available to merchants from Switzerland.

Make sure you to Payrexx before you start.

Mode: Enable the for PostFinance Checkout.

Repeat the steps described in the section, with the following adjustments:

🇨🇭
PostFinance Pay
Login
Registration
Website
Documentation
log in
test mode
Testing
Activating PostFinance Checkout in test mode
Configuring payment methods in PostFinance Checkout
Activating the Payrexx integration in PostFinance Checkout
The activated Payrexx integration in PostFinance Checkout
Starting the configuration of PostFinance Checkout in Payrexx
Option to create an account with PostFinance
Configuration of PostFinance Checkout in Payrexx
Selection of desired payment method
Executing the payment on the PostFinance website