Skip to main content

(Classic) SIX Saferpay for FinDock


This article describes an integration with the v1 of the API. Ongoing development on this version has stopped. Please use our new and improved API v2!

The SIX Saferpay for FinDock extension supports both single and recurring credit card payments and PostFinance PostCard through Saferpay, an online payment solution from SIX Payment Services. TWINT and PostFinance E-finance, mobile payment methods widely used in the Swiss market, are also supported. However, this is for one-time payments only.

Payment MethodOne-timeRecurringRefunds
Credit Cardyesyesyes
PostFinance Cardyesyesyes
PostFinance E-financeyesnoyes

To enable PostFinance PostCard and PostFinance E-finance in your SIX Saferpay environment, you need to create a support ticket with SIX support.


  • FinDock installed and configured
  • A source connector installed and configured
  • A Salesforce Site configured

Install and activate SIX Saferpay for FinDock#

Follow the standard procedure for installing and activating the SIX Saferpay for FinDock payment extension.

Configure SIX Saferpay for FinDock#

Configuring the SIX Saferpay extension requires setting up a test account with the Saferpay Backoffice and a production account with Saferpay myPortal. Some information from your Saferpay settings needs to be copied to the Saferpay for FinDock extension settings, so you will need to have both applications open to complete the configuration.

To configure SIX Saferpay for FinDock:

  1. Add the following permission sets to Site Guest User:
    • Six Saferpay Integration User
    • PaymentHub Integration Base
  2. Got to the Remote Site Settings tab and activate one of the Saferpay endpoints.
    • SaferpayProductionEndpoint: activate this endpoint if you are configuring a production org.
    • SaferpayTestEndpoint: activate this endpoint if you are configuring a sandbox org for testing.
  3. Click the FinDock Setup tab to go back to the home page and then click on the Six-Saferpay-for-FinDock tile under the section Extensions - PSP. SIX Saferpay FinDock settings
  4. For the Push URL, enter the URL of your Salesforce Site, starting with https. * Example:
  5. Register or log in to the Saferpay Backoffice at If you are configuring a production org, you use the Saferpay myPortal:
  6. Take note of your 10-character username. This auto-generated username needs to be added to the Saferpay settings in FinDock.
  7. Click the Settings tab and then click JSON API basic authentication.
  8. When you created your backoffice account, you received an email from Saferpay with an JSON API username and password. If you no longer have this email, click Create new JSON API login to get a new login username and password. SIX Saferpay new JSON API
  9. Copy-paste your JSON API login username and password into the corresponding fields in the SIX Saferpay for FinDock extension settings.
  10. On the Settings tab, click Payment Means / Terminals.
  11. Copy-paste your Customer ID and eCommerce Terminal ID into the corresponding fields in the SIX Saferpay FinDock extension settings. SIX Saferpay payment means
  12. On the SIX Saferpay FinDock settings page, adjust the logging and test options as needed, and the click Save.
    • Log Requests: activate if you want to log all Saferpay connection events.
    • isTest: activate if you are configuring a sandbox org for testing.
  13. Click Schedule Assert Unprocessed Transactions. This processes all installments that are in status ‘Pending’ longer than an hour. For each unprocessed installment, ‘Status’ and ‘Failure Reason’ fields are updated.

Testing with the Payment API#

You can use the following example messages to test if the Saferpay configuration is working as expected.

One-time payment with credit card#

    {       "SuccessURL":"",       "FailureURL":"",       "Payer":{           "Contact":{               "FirstName":"Six-Saferpay-for-Findock",               "LastName":"Single Saferpay",               "Email":""           },           "AccountUpdate":"Enrich",           "ContactUpdate":"Enrich",           "AllowDeduplication":true,           "PrimaryRelation":"Contact"       },       "Payment":{           "Amount": 10.00       },       "PaymentMethod":{           "Name":"CreditCard",           "Processor" :"Six-Saferpay-for-FinDock"       },       "SourceConnector":{           "Name":"PaymentHub"       }    }

Recurring payment with credit card#

    {        "SuccessURL":"",        "FailureURL":"",        "Payer":{            "Contact":{                "FirstName":"Six-Saferpay-for-Findock",                "LastName":"Recurring Saferpay",                "Email":""            },            "Account":{                "Name":"Famylje Douwstra"            },            "AccountUpdate":"Enrich",            "ContactUpdate":"Enrich",            "AllowDeduplication":true,            "PrimaryRelation":"Contact"        },        "Recurring":{            "Amount": 10.15,            "Frequency":"Monthly",            "StartDate":"2019-09-25"        },        "Payment":{            "Amount":10        },         "PaymentMethod":{           "Name":"CreditCard",           "Processor" :"Six-Saferpay-for-FinDock"       },       "SourceConnector":{           "Name":"PaymentHub"       }    }

Single payment with TWINT#

    {       "SuccessURL":"",       "FailureURL":"",       "Payer":{           "Contact":{               "FirstName":"Six-Saferpay-for-Findock",               "LastName":"Single Saferpay",               "Email":""           },           "AccountUpdate":"Enrich",           "ContactUpdate":"Enrich",           "AllowDeduplication":true,           "PrimaryRelation":"Contact"       },       "Payment":{           "Amount": 10.00       },       "PaymentMethod":{           "Name":"TWINT",           "Processor" :"Six-Saferpay-for-FinDock"       },       "SourceConnector":{           "Name":"PaymentHub"       }    }