PostFinance Checkout

Owned by HostBill
Last updated: Feb 11, 2022

Overview

PostFinance is one of Switzerland's leading financial institutions. HostBill supports PostFinance Checkout payment gateway for collecting payments out of the box.

Activating the module

In order to activate the module login to your HostBill admin panel, go toSettings → Modules → Payment Modules, choose PostFinance Checkout gateway and click Activate.

Module configuration

Once the payment gateway is activated you need to configure it. 
Please see external articles on how to setup:

Then proceed to filling in all other configuration fields:

  1. Space ID
  2. User ID
  3. Secret Key
  4. Limit to selected currencies - when enabled, the gateway will only appear to selected currencies

All required information can be obtained once you login to your PostFinance Direct Link merchant panel.

  1. Go to the PostFinance → Account → Application Users page (https://checkout.postfinance.ch/account/select?target=/user/application/list)
    1. Create a new App user.
    2. Generate new key for this user.
    3. Copy User ID and Authentication Key and provide this details to the PostFinance Checkout module configuration in the HostBill app.
    4. Save PostFinance Checkout module changes. 
    5.  
  2. Go to the PostFinance → Space (https://checkout.postfinance.ch/space/select)
    1. Copy the Space ID and provide this to the PostFinance Checkout module configuration in the HostBill app.
    2. Save PostFinance Checkout module changes.   
  3. Copy the Callback URL on the PostFinance Checkout module configuration page.
  4. Go to the PostFinance → Space → Webhooks → URL page (https://checkout.postfinance.ch/space/select?target=/webhook/url/list)
    1. Create new Webhook URL with the next details:
      1. Name - any name
      2. URL - copied Callback URL from the PostFinance Checkout module's configuration.  
  5. Go to the PostFinance → Space → Webhooks → Listener page (https://checkout.postfinance.ch/space/select?target=/webhook/listener/list)
    1. Create new Webhook Listener with the next details:
      1. Entity - "Transaction"
      2. Listener Details Name - any name
      3. Notification URL - created Webhook URL in the previous step
      4. Entity State - select all available options
      5. Entity Notify every change - not checked. 
  6. Check if the PostFinance Checkout module is working properly.


FAQ

Question: I've enabled the module but it does not display in my client portal.
Answer: This module does not support the currency you attempt to display it in, please use background currency conversion.