SIX Saferpay

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 payment methods, widely used in the Swiss market, are also supported. However, thye are for one-time payments only.

Multi-merchantMulti-currency
nono
Payment MethodOne-timeRecurringRefunds
Credit Cardyesyesyes
E-Financeyesnoyes
PostCardyesyesyes
TWINTyesnoyes
note

To enable E-Finance, PostCard or TWINT methods in your SIX Saferpay test environment, you may need to contact SIX support.

Pre-requisites

  • FinDock is installed and configured.
  • A source connector is installed and configured.
  • FinDock WebHub is connected and Notification Gateway 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. 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.
  2. 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
  3. For the Notificaiton URL, this value is automaticlaly filled by the Notification Gateway.
  4. Register or log in to the Saferpay Backoffice at https://test.saferpay.com/BO/. If you are configuring a production org, use the Saferpay myPortal: https://myportal.six-payment-services.com/merchantportal/
  5. Take note of your 10-character username. This auto-generated username needs to be added to the Saferpay settings in FinDock.
  6. Click the Settings tab and then click JSON API basic authentication.
  7. 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
  8. Copy-paste your JSON API login username and password into the corresponding fields in the SIX Saferpay for FinDock extension settings.
  9. On the Settings tab, click Payment Means / Terminals.
  10. Copy-paste your Customer ID and eCommerce Terminal ID into the corresponding fields in the SIX Saferpay FinDock extension settings.
    SIX Saferpay payment means
  11. 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.

Payment API messages

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

One-time payment with credit card

{
"SuccessURL": "https://www.example.com/success",
"FailureURL": "https://www.example.com/error",
"Payer": {
"Contact": {
"SalesforceFields": {
"FirstName": "Eric",
"LastName": "Johnson",
"Email": "eric@johnson.com"
}
}
},
"OneTime": {
"Amount": "30"
},
"PaymentMethod": {
"Name": "Creditcard",
"Processor": "Six-saferpay-for-findock"
},
"Settings": {
"SourceConnector": "PaymentHub"
}
}

Recurring payment with PostFinance card

{
"SuccessURL": "https://www.example.com/success",
"FailureURL": "https://www.example.com/error",
"Payer": {
"Contact": {
"SalesforceFields": {
"FirstName": "Eric",
"LastName": "Johnson",
"Email": "eric@johnson.com"
}
}
},
"Recurring": {
"Amount": "25",
"Frequency": "Monthly",
"StartDate": "2020-11-01"
},
"PaymentMethod": {
"Name": "PF PostCard",
"Processor": "Six-saferpay-for-findock"
},
"Settings": {
"SourceConnector": "PaymentHub"
}
}

One-time payment with PostFinance E-finance

{
"SuccessURL": "https://www.example.com/success",
"FailureURL": "https://www.example.com/error",
"Payer": {
"Contact": {
"SalesforceFields": {
"FirstName": "Eric",
"LastName": "Johnson",
"Email": "eric@johnson.com"
}
}
},
"OneTime": {
"Amount": "30"
},
"PaymentMethod": {
"Name": "PF e-finance",
"Processor": "Six-saferpay-for-findock"
},
"Settings": {
"SourceConnector": "PaymentHub"
}
}