Click to Pay

Click to Pay transactions can be processed via the Saferpay Payment Page, without much effort from your 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.

General 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.

Technical requirements

The general integration of Click to Pay can only be done via the Payment Page.

Secure Card Data is currently only supported for Mastercard.

Direct selection

Like other wallets, Click to Pay can be selected via the Wallets parameter, in order to limit the display on the Payment Page. See further information on pre-selection here.

{
    "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]"
    },
}

Best Practices with Direct Selection

Click to Pay is a feature of card payments rather than a payment method. Therefore, indicate that cards are processed with Click to Pay by adding the logo to the available card schemes.

Download the Click to Pay or the Helper Image to style your checkout.

3KB

Helper_image.zip

archive

Open

3KB

ClicktoPay_Icon.zip

archive

Open

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 payments within the wallet are then processed via the normal processors.

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

As of now, Secure Card Data is only supported by Mastercard!

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.

Checking the status

By clicking on the State button on the right side in the activation-section, you can check the status of your Click 2 Pay activation for the available payment methods.

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.