Apple Pay is a digital wallet and payment service provided by Apple Inc and it provides an easy and secure way to pay in iOS apps, watchOS apps, and websites on Safari. Apple Pay allows your customers with [compatible devices](🔗) to make payments and complete purchase without the need to add to a cart or fill out a form. Payments made using Apple Pay will benefit from full liability shift for supported card schemes including; Visa, MasterCard and AMEX.

When your customer selects Apple Pay, they are presented with a pre-populated Payment Sheet where they can view the order, choose a card and confirm their shipping and contact details. The final step is payment authorisation through Face ID or Touch ID authentication to confirm the purchase. <sub>[1]</sub>

Supported Apple Pay Experiences

As a merchant you can choose to support any of the patterns below. Depending on which of the below patterns your business wishes to support, the setup steps will vary.

  • [Apple Pay in iOS apps](🔗)

  • [Apple Pay on the Web via Safari](🔗)

  • Apple Pay on both iOS apps and on the Web via Safari.

## Apple Pay Setup

To start accepting Apple Pay payments via Web and Mobile Apps please follow the instructions below:

  • **Apple Pay on the Web: ** You don't need to create your own Apple Pay certificate for web integration because you will use Wpay Apple Pay Certificate. Your Wpay account management representative will be able to support you through the integration process.

  • **Apple Pay in App: ** You will need to enable Apple Pay with your own certificates and share your certificates with Wpay to configure against your merchant profile. These certificates will be generated from your Apple Developer Account which can be created by following the instructions here [Before You Enrol - Apple Developer Program](🔗). Please share this with your account management representative who can support you through the integration process.

## Starting a Session with Apple for Apple Pay

**Apple Pay Web:** Wpay `paymentsession` API must first be called from the client side so that Wpay can correctly validate the merchant domain and return an opaque Apple Pay merchant session object. The Apple Pay session object can be used to encrypt payment data. Upon successful call of `Paymentsession` API, you may then present a Payment Sheet to the user to review the purchase and authorise the payment.


  • `Origin` header will be automatically passed on by customer's browser

  • `validationUrl` is validation URLs provided by Apple when you set up your server (see [Requesting An Apple Pay Payment Session](🔗) for more detail)

### Apple Pay Merchant Session Object

A sample of merchant session object can be seen below. You may pass this whole object to the completion method, [completeMerchantValidation](🔗) to enable the user to authorize a transaction.

**Apple Pay in App:** you can validate your merchant domain by calling Apple validation URL directly (see [Requesting An Apple Pay Payment Session](🔗) for more detail). It will return an opaque Apple Pay session object that you can use to encrypt the payment data. Since Wpay already stores your Apple Pay Certificates against your profile in our secure environment, we will be able to decrypt the payment data on our end and [provide you with a payment token] (doc:apple-pay#tokenizing-apple-pay) that you can use to [make payments](🔗) or store in your wallet.

## Tokenizing Apple Pay

To tokenize an Apple Pay instrument using the Wpay platform please follow [Tokenizing Apple Pay](🔗).

## Making an Apple Pay Payment

To make an Apple Pay payment using the Wpay platform please follow [Making a Payment](🔗).

Testing Apple Pay Integration

Testing for Apple Pay on web requires a sandbox account. The steps to create a sandbox accounts and add dummy cards is documented here at [Apple Pay - Sandbox Testing - Apple Developer](🔗). Once your test integration is complete you can test your setup using the [Apple Pay on the Web Demo](🔗) .

## References

  1. [Apple Pay - Marketing Guidelines](🔗)

  2. [Apple Pay Programming Guide](🔗)

  3. [Preparing Merchant Domains for Verification](🔗)

  4. [Register Merchant](🔗)

  5. [Apple Pay Interactive Demo](🔗)

  6. [Registering with Apple Pay and Applying to Use the API](🔗)

  7. [Requesting An Apple Pay Payment Session](🔗)