Gutschein OeV

Gutschein OeV, or simply OeV, is a dedicated sub-brand of Boncard and offers the same featureset, but a dedicated activation and depiction. While processed via the Boncard network, it is handled as its own payment method.

This chapter describes what needs to be considered in this regard.

General requirements

The handling of Gutschein OeV 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 for OeV.

  • 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 Gutschein OeV can only be done via the Payment Page and requires the following things to be noted:

• Spec-Version 1.10, or higher.

  • Important: Gutschein OeV has been backported to SpecVersions 1.10 - 1.47. When implementing Gutschein OeV 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. PaymentMethod now returning OEV 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	❌

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 OeV activation:

1.) Navigate to Settings > Payment Means / Terminals

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

3.) Scroll down to Self Service, until you see OeV.

On the test-environment, you will see two options, one of which being the OeV 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 gotten from Boncard into the following window and afterwards, click on Save, to save your configuration.

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

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

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

Testing

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