Apple Pay®
Apple Pay® is a digital wallet application that Apple customers can use to store payment card details and to pay for goods and services using their Apple devices. When you add Apple Pay to your integration, your merchants can accept Apple Pay as a payment method for online transactions. When a customer uses Apple Pay to make a payment, your integration communicates with the Apple JS API and the Payroc gateway to make the sale.How it works
Start an Apple Pay session
- Cardholder chooses to pay with Apple Pay, for example, they select the Apple Pay button on the merchant's web page.
- Your integration requests the validation URL from Apple.
- Apple returns the validation URL to your integration.
- Your integration sends a request to our Apple Pay sessions endpoint. The request must include the unique domainId and validation URL.
- We start an Apple Pay session and get the merchant session object from Apple.
- We return the merchant session object to your integration.
Run a sale
- Cardholder confirms the payment method they want to use.
- Your integration sends a request to Apple that includes details about the transaction and the merchant session object.
- Apple returns the cardholder's encrypted payment details to your integration.
- Your integration sends a request to our Payments endpoint. The request must include the cardholder's encrypted payment details in hexadecimal format.
- Our gateway returns a successful payment response to your integration.
Your integration journey
To set up Apple Pay for a merchant, complete the following actions: Step 1. Add Apple Pay to your integration- Integrate with the Apple Pay JS API - Use the Apple Pay JS API to validate the merchant's domain and to receive a cardholder's encrypted payment details.
- Integrate with the Payroc API - Use our gateway to start a merchant session with Apple and to run a sale with the encrypted payment details you received from Apple.
- Domain verification file - Add the domain verification file to the merchant's domain.
- Self-Care Portal - Use the Self-Care Portal to set up Apple Pay for a merchant, and to get their unique domain ID that you send to Apple.