# 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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.saferpay.com/home/integration-guide/payment-methods/boncard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
