Click to Pay

Click to Pay transactions can be processed via the Saferpay Payment Page, without much effort from you side. Note that Click to Pay is not a classic means of payment, but rather a digital wallet. Your customers will still pay with Visa, Mastercard, or whatever credit card has been saved inside the wallet, thus the actual recorded payment method will correspond to this. However, Saferpay will also return information that this transaction has been performed through Click to Pay. Furthermore, all options and limitations of the used means of payment apply, if not mentioned otherwise in this chapter.

The following chapter will guide you through the steps required in order to activate and use Click to Pay.

Requirements

The handling of Click to Pay 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 by which payments can be carried out and availability of the associated Saferpay TerminalId.

  • Availability of at least one active contract on said terminal, for the given payment method you want to process.

Supported features

Since Click to Pay is not a classical payment method, but a digital wallet, the supported features depend on the payment means, that are used.

Furthermore, the merchant can only accept payment methods, that are activated on the specified terminal Id.

The payment means within the wallet are then processed via the normal processors.

For example: If a card holder selects his Visa card, the card is then processed as such, through Click to Pay as the wallet.

Click to Pay is currently only available for Mastercard. Visa only on request, please get in touch with your contact at our sales for more information.

Other brands are not yet supported.

Activation

Click to Pay is a self-service protocol, meaning, that you have full control over its activation.

To activate Click to Pay, please log into the Saferpay Backoffice and navigate to Settings => Payment Means / Terminals.

Select the terminal from the drop-down, where you want Click to Pay to be activated on and scroll down to Self Service.

Simply check the switch to activate Click to Pay, or the Click to Pay Simulator for the test-environment.

Integration

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

• Click to Pay must be pre-selected using the Wallets parameter (see below).

Direct selection

Unlike other payment Methods, Click to Pay must be pre-selected via the Wallets parameter, with "CLICKTOPAY" being the only value. You also must not use Wallets and PaymentMethods together. Otherwise, Click to Pay will not be displayed.

This also means, that Click to Pay cannot be displayed alongside other payment methods and wallets.

{
    "RequestHeader": {
        "SpecVersion": "[CURRENT SPECVERSION]",
        "CustomerId": "[YOUR CUSTOMERID]",
        "RequestId": "[YOUR REQUESTID]",
        "RetryIndicator": 0,
        "ClientInfo": {
            "ShopInfo": "My Shop",
            "OsInfo": "Windows Server 2016"
        }
    },
    "TerminalId": "[YOUR TERMINAL]",
    "Payment": {
        "Amount": {
            "Value": "12345",
            "CurrencyCode": "EUR"
        },
        "OrderId": 123,
        "Description": "Test Order #123"
    },
    "Wallets": [
        "CLICKTOPAY"
    ],
    "ReturnUrl": {
        "Url": "[YOUR URL]"
    },
}

Testing

Saferpay does offer an extensive Click to Pay simulator. All test-cases are controlled through the simulator-ui. Please refer to the Activation section, to activate the Click to Pay simulator.

Furthermore, please consider the following specifics:

The simulator option actually presents you with two separate testing environments, as also mentioned in the simulator-ui:

The card entry form is directly connected to the Click to Pay sandbox and requires their test cards, as well as a Click to Pay sandbox account to work.

The Saferpay Test-cards will not work with this form. You must use the test cards, that will be provided to you by Click to Pay.

However even these cards may not be able to fully process.

The usage of the simulator cases (see below) is preferred instead.

However the bottom section under Click to Pay Simulator Controls are part of the Saferpay simulator and present you with premade test-cases, for easier testing. This is the preferred method for testing, as they do not require any access to the Click to Pay sandbox.