Apple Pay Drop-in integration

Add Apple Pay to an existing iOS Drop-in integration.

On this page, you can find additional configuration for adding Apple Pay to your Drop-in integration.

If you are selling digital goods in your native iOS app, use Apple's in-app purchase instead of Apple Pay.

Before you begin

This page assumes you've already built a Drop-in integration.

Set up Apple Pay

Set up your server for secure communication with Apple Pay.
Enable Apple Pay using your own Apple Developer account and certificate.

API reference

You don't need to send additional fields for Apple Pay. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:

/sessions: This is the default with Drop-in v5.0.0 or later.
/payments: If you implemented an additional use case.

If you run into an error, refer to Handle Apple Pay errors.

Drop-in configuration

When you configure Drop-in, you need additional configuration for Apple Pay.

If your integration uses iOS Drop-in v5.0.0 or later, include the following when you configure Drop-in:

Parameter name	Description
`merchantIdentifier`	Your Apple Pay merchant identifier.
`requiredBillingContactFields`	The fields required for the billing contact.
`requiredShippingContactFields`	The fields required for the shipping contact.

//Initialize a Drop-in configuration object.
let dropInConfiguration = DropInComponent.Configuration()
//Set configuration for Apple Pay.
dropInConfiguration.applePay = .init(payment: applePayment,
                               merchantIdentifier: YOUR_APPLE_PAY_MERCHANT_ID,
                               requiredBillingContactFields: ... , //Your required billing contact fields.
                               requiredShippingContactFields = ... ) //Your required shipping contact fields.

If your integration uses Drop-in v4.10.0 or earlier, include following configuration for Apple Pay:

Parameter name	Description
`merchantIdentifier`	Your Apple Pay merchant identifier.
`payment`	The amount, currency, and country code of the payment.
`summaryItems`	The items included in the purchase.

// Import this to use the PKPaymentSummaryItem class
// See documentation https://developer.apple.com/documentation/passkit/pkpaymentsummaryitem
import PassKit
//Submit the payment details here, including the amount, currency, and country code
let payment = Payment(amount: Amount(value: 15000, currencyCode: "EUR"),
                      countryCode: "NL")
// A set of line items that explain recurring payments, additional charges, and discounts.
// See Apple Pay documentation for sample values.
// https://developer.apple.com/documentation/apple_pay_on_the_web/applepaypaymentrequest/1916120-lineitems
let summaryItems = [
                     PKPaymentSummaryItem(label: "Jeans", amount: 98.99, type: .final),
                     PKPaymentSummaryItem(label: "Bag", amount: 55.46, type: .final),
                     PKPaymentSummaryItem(label: "Discount", amount: -4.45, type: .final),
                     PKPaymentSummaryItem(label: "Total", amount: 150, type: .final)
                   ]
// See Apple Pay documentation https://docs.adyen.com/payment-methods/apple-pay/enable-apple-pay#create-merchant-identifier
let merchantIdentifier = "merchant.com.{YOUR_MERCHANT_IDENTIFIER}"
let applePayConfiguration = ApplePayComponent.Configuration(summaryItems: summaryItems,
                                                            merchantIdentifier: merchantIdentifier)

//Assign the Apple Pay configuration object you created to your instance of Drop-in.
dropInConfiguration.applePay = applePayConfiguration

Optional configuration

If your integration uses iOS Drop-in v5.0.0 or later, you can optionally include the following when you configure the Drop-in:

Parameter name	Description
`billingContact`	A prefilled billing address.
`shippingContact`	A prefilled shipping address.
`allowOnboarding`	Set to true to let the shopper add cards to their Apple Pay wallet if they haven't already done so. Otherwise, the shopper can't use Apple Pay. Default: false.
`shippingType`	The type of shipping displayed, for example Pick Up, Ship To, or Deliver To. This is localized. Default: PKShippingTypeShipping = .shipping.
`allowShippingContact`	Set to false to prevent the shopper from changing the shipping contact field before showing the payment form. Default: true.
`shippingMethods`	An array of supported shipping methods.
`applicationData`	Additional information that you provide about the payment request. For example, an order number or cart identifier. This is signed and included in the resulting `PKPaymentToken`.
`supportedCountries`	Only allow payments from cards issued in specific countries. This is a list of ISO 3166 country codes.
`supportsCouponCode`	Set to true to let the shopper enter a coupon code which gets validated. Default: false.
`couponCode`	A coupon code that has already been applied to the payment request.

Recurring payments

To make recurring Apple Pay payments, you first need to create a shopper token and then make subsequent recurring transactions with the token.

Refer to Tokenization for more information and detailed instructions.

Test and go live

Use Apple's test card numbers to test your integration.

For a full list of test cards and instructions how to add these to your test device, see Sandbox testing on Apple's Developer website.

Check the status of an Apple Pay test payment in your Customer Area > Transactions > Payments.

Going live

To process live Apple Pay payments, your API credential needs to have the API Clientside Encryption Payments role. You can check this in your live Customer Area or ask your Admin user to verify.

Make sure you follow Apple's guidelines on:

Designing your Apple Pay integration.

Enable Apple Pay on your Apple Pay Developer account for your live merchant identifier.
Set up your server for secure communication with Apple Pay.