Boncard

Boncard payments can be processed with Saferpay without much effort. This chapter describes what needs to be considered in this regard.

General requirements

The handling of Boncard payments with Saferpay requires:

• A corresponding license and thus a valid identification with a username and password for the Saferpay system.

• Availability of at least one active Saferpay terminal via which payment can be carried out and availability of the associated Saferpay TerminalId.

• A valid contract with Boncard.

  • A corresponding Boncard TerminalId, UserId and Password.

Please contact Boncard directly in order to get your contract and credentials.

Technical requirements

The general integration of Boncard can only be done via the Payment Page and requires the following things to be noted:

• SpecVersion 1.10 or higher.

  • Important: Boncard has been backported to SpecVersions 1.10 to 1.47. When implementing Boncard for Spec-Versions lower than 1.48, please make sure that your implementation is capable of processing the new values returned by the Saferpay API, e.g. PaymentMethods now returning BONCARD as a value, which was previously not specified.

Furthermore, for other flows (refunds etc.), please also refer to the table below.

Supported features

Feature	Support
Capture/Cancel	❌
Multipart Captures	❌
Secure Card Data	❌
Refunds	✅
Recurring Payments	❌
3D Secure	❌
Dynamic Currency Conversion (DCC)	❌
Mail Phone Order	❌
Testing	✅
Omni-Channel	❌

Supported Brands

One special aspect of Boncard is its division into multiple sub-brands. While most payment methods have one way to pay, Boncard is split into multiple gift card brands.

As of now, Saferpay supports the following brands:

• boncard Pay

• Galenicare

Saferpay will process all of these brands under the Boncard umbrella.

Is a certain brand not listed? Please contact us about the possibility of adding it to the list.

Activation

Once you have received your Boncard contract and credentials, you have to enter these details inside the Saferpay Backoffice. Please follow the following steps for Boncard activation:

1.) Navigate to Settings > Payment Means / Terminals

2.) Select the desired terminal from the dropdown where you want to activate Boncard.

3.) Scroll down to Self Service until you see Boncard.

On the test environment, you will see two options, one of which is the Boncard Simulator. For testing, it is recommended to use that option instead of the normal one.

4.) Click on the Configure button to the right.

5.) Please enter the credentials you have received from Boncard into the following window and select the Boncard brands you want to support. Afterwards, click on Save to save your configuration.

For the Saferpay Boncard simulator, you can enter any value. It is just necessary that the fields are not empty.

6.) Lastly, you must turn on Boncard by flipping the following switch and confirm the activation:

7.) All done. Boncard is now activated on your account.

Testing

After activating the Boncard simulator, you'll have access to our Boncard test cards, which you'll find here.