# 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 ](https://docs.saferpay.com/home/master/licensing)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

{% hint style="info" %}
Please [contact Boncard directly](https://boncard.ch/kontakt), in order to get your contract and credentials.
{% endhint %}

### Technical requirements

The general integration of Boncard can only be done via the [Payment Page](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/payment-page) and requires the following things to be noted:

* Spec-Version 1.10, or higher.
  * **Important:** Boncard has been backported to SpecVersions 1.10 - 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.&#x20;

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

### Supported features

| Feature                                                                                                                                                                                                         |    Support   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------: |
| [Capture](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/capture-and-daily-closing)/[Cancel](https://docs.saferpay.com/home/licences-and-interfaces/capture-and-daily-closing#cancel) | <p>❌<br></p> |
| Multipart Captures                                                                                                                                                                                              |       ❌      |
| Secure Card Data                                                                                                                                                                                                |       ❌      |
| [Refunds](https://docs.saferpay.com/home/integration-guide/licences-and-interfaces/transaction-interface/refunds)                                                                                               |       ✅      |
| Recurring Payments                                                                                                                                                                                              |       ❌      |
| 3D Secure                                                                                                                                                                                                       |       ❌      |
| Dynamic Currency Conversion (DCC)                                                                                                                                                                               |       ❌      |
| Mail Phone Order                                                                                                                                                                                                |       ❌      |
| [Testing](#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 giftcard brands.&#x20;

As of now, Saferpay supports the following brands:

* boncard Pay
* Galenicare

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

{% hint style="info" %}
Is a certain brand not listed? [Please contact](https://docs.saferpay.com/home/integration-guide/support) us about the possibility of adding it to the list.
{% endhint %}

## 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](https://docs.saferpay.com/home/interfaces/backoffice/settings#payment-means-terminals)

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

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

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FOXFFxiop87lnxdOwLgJC%2FBoncard_Activation_SelfService.png?alt=media&#x26;token=4e746fed-8c46-4934-bbe1-3e1fc7af7ff3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
On the test-environment, you will see two options, one of which being the Boncard Simulator. For testing, it is recommended to use that option, instead of the normal one.
{% endhint %}

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

5.) Please enter the credentials you have gotten from Boncard into the following window and select the [Boncard brands](#supported-brands) you want to support. Afterwards, click on **`Save`**, to save your configuration.

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FKE3IGblZ3Qx9srjYS5Ht%2FScreenshot_20251111_121825.png?alt=media&#x26;token=900ac8df-c8d9-47c1-abb1-f96bc80fe6df" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For the Saferpay Boncard simulator, you can enter any value. It is just necessary, that the fields are not empty.
{% endhint %}

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

<figure><img src="https://3537448238-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fzpi9teY7Tm2pCZ1Bw8zO%2Fuploads%2FWM1QSb51CupvWAhtD7wZ%2FBoncard_Activation_Activate.png?alt=media&#x26;token=4ff313f6-0b65-4bbc-828b-0e24fe8e3a7f" alt=""><figcaption></figcaption></figure>

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](https://docs.saferpay.com/home/testing-and-go-live#boncard).
