Apple Pay
Apple Pay offers a frictionless payment experience in Safari based browsers on iOS and macOS. Apple Pay can be activated in the Optimize Administration and only requires a card acquiring agreement supporting Apple Pay.
Frisbii Payments Checkout determines if Apple Pay is supported for the browser and OS used, and presents Apple Pay as a payment method if no payment_methods
argument has been given when creating the session, or applepay has been defined in the list of payment methods.
Notice
Apply Pay does not allow to be run within an iframe, thus Apple Pay is only supported in a window mode.
To determine on the own site if Apple Pay is supported, the following SDK method can be used.
<script src="https://checkout.reepay.com/checkout.js"></script>
<script>
const isAvailable = Reepay.isApplePayAvailable();
// e.g. hide/show Apple Pay option
</script>
Liability shift
Apple Pay supports liability shift for American Express, Discover, JCB, Mastercard, and Visa cards issued in Europe. For non-European Visa cards, there is no liability shift for Apple Pay.
Liability shift means that the financial risk in case of fraud is put on the card acquirer or cardholder, instead of the merchant.
Apple Pay recurring
Apple Pay can also be used as a recurring payment method if enabled in the Configuration → Payment Methods section. A saved payment method can be obtained either by a recurring session or a charge session with the recurring flag set recurring=true
.
To control the data shown by Apple Pay the following parameters can be given in the optional session_data
object.
Parameter | Description |
---|---|
applepay_recurring_payment_start_date | Recurring payment start date in format yyyy-MM-dd to be displayed to the user. |
applepay_recurring_payment_end_date | Recurring payment start date in format yyyy-MM-dd to be displayed to the user. |
applepay_recurring_payment_interval_unit | Recurring payment interval unit to be displayed to the user. One of the following values: year, month, or day. |
applepay_recurring_payment_interval_count | Recurring payment interval count to be displayed to the user. |
applepay_recurring_label | Label to be displayed to the customer. Maximum 64 characters. |
applepay_recurring_amount | Fixed recurring amount. |
applepay_recurring_trial_label * | Label to be displayed to the customer on the trial line. Maximum 64 characters. |
applepay_recurring_trial_amount * | Trial recurring amount |
*- Only available for Version 2 agreements. See the notice below.
Checkout customization
Notice
Full customization is currently experimental and only available for Version 2 agreements. Contact support if you want an early adoption of this feature.
When populating the above session_data
fields for recurring payments or subscription sessions, the user will be presented with a screen similar to the one below. See legend below to customize your customer's experience.

ApplePay checkout screen
- Setting
text_on_statement
when creating the session will populate fields [1] and [9]. In case it's missing, the display name set on the agreement will be used. applepay_recurring_trial_label
will populate [2]. Defaults toTrial
.applepay_recurring_trial_amount
will populate [3]. Defaults to0.00
, which causes ApplePay to showFree
.- If both
applepay_recurring_trial_label
andapplepay_recurring_trial_amount
are missing, the trial line will be populated using information from the subscription plan. If missing, no trial will be shown. applepay_recurring_label
will populate [5]. Defaults toRecurring
.applepay_recurring_payment_start_date
will populate [4] (effectively acting as a trial end date) and [6]. If missing, the start date will be the next period on the subscription.applepay_recurring_amount
will populate [7]. Defaults to the subscription or subscription's plan amount, orFree
in case of a recurring session.applepay_recurring_payment_interval_unit
andapplepay_recurring_payment_interval_count
will populate the first half of [8]. Note that these fields are shared with the trial duration label [4]. Defaults to 1 month.applepay_recurring_payment_end_date
will populate the second part of [8]. Defaults to the subscription's end date.- The amount of the charge will populate [10]. In case there is no associated charge, this will show
0.00
.
Updated about 6 hours ago