Applepay

Applepay-transactions can be processed via the Saferpay Payment Page, without much effort. Note, that Applepay 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 payment method will correspond to this. However Saferpay will also return information, that this transaction has been performed, through Applepay. Furthermore, due to this nature, all options and limitations of the saved means of payment do apply as stated here, if not mentioned otherwise in this chapter! The following chapter will guide you through the steps required, in order to activate and use Applepay.

Caution: As of now, LiabilityShift for Visa cards over Applepay is denied on authorization, due to an ongoing issue between Apple and Visa.

Requirements

The handling of Applepay payments with Saferpay requires:

  • The corresponding Saferpay eCommerce licence and thus the existence of 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.
  • Applepay is only available via the PaymentPage flow!
  • Applepay is only available with SpecVersion 1.15, or higher.
  • NotifyUrl: The NotifyUrl is mandatory, in order to avoid missing payment successes. See the Payment Page process for further information!
  • Applepay can only be used with Apple devices, like iPhones and iPads. Exception being the test environment, so you may test it on other devices!
  • Furthermore, only Apples own browser, Safari, is supported. Exception being the test environment, so you may test it in other browsers!
  • Applepay does not support Secure Card Data, even though the means of payment may support it! However Recurring Payments can be executed, if supported by the payment mean!

Warning: Applepay does not support the iFrame Integration!

Activation

The activation of Applepay for your Saferpay account, be it live, or on the test-environment, requires next to no effort and can be done in a matter of seconds.

  1. First step is to log into the Saferpay Backoffice, there you have to navigate to the Settings tab and click on Payment Means / Terminals.
    alt text
  2. Next, select the e-commerce, or Secure PayGate terminal, you want to activate Applepay on.
  3. Navigate to the Wallets section, there you will find Applepay.
  4. Click on the Activate Button. alt text
  5. You will be prompted with another window, that asks you to accept the Terms and Conditions from Apple, so you may use Applepay. Mark the checkbox and click Activate. alt text
  6. And you are done! Applepay is now available for you on your Saferpay Terminal. alt text

Direct redirect

If you want to perform a direct redirect to Applepay, you have to use the parameter Wallets within the PaymentPage Initialize request!

Example Request:

{
    "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": [
        "APPLEPAY"
    ],
    "PaymentMethods": [
        "VISA",
        "MASTERCARD"
    ],
    "ReturnUrls": {
        "Success": "[YOUR URL]",
        "Fail": "[YOUR URL]",
        "Abort": "[YOUR URL]"
    },
}

Tip: If you are using "Wallets" alongside "PaymentMethods", you can limit the Brands, your customer may use! However note, that the Payment Page then also will display the given Brands as dedicated Payment Methods, so the customer may pay this way!

Important: If you are using PaymentMethods, you must also submit Wallets, if you want Applepay to be displayed! Also, if you are just submitting one Payment Method, the Payment Page will still directly jump to the card entry form, skipping Applepay!

Back to Top