--- title: Integrate Apple Pay® description: "This document provides a guide to integrating Apple Pay into your web applications. PaywayWS provides the RESTful\nweb service with which you will interact to implement your Apple Pay interface." --- [Skip to content](https://support.payway.com/knowledge/apple-pay-integration#main-content) English Show submenu for translations ![7100C\_PAY\_PaywayPms\_Logo-bird\_full color](https://support.payway.com/hs-fs/hubfs/7100C_PAY_PaywayPms_Logo-bird_full%20color.png?width=100&height=100&name=7100C_PAY_PaywayPms_Logo-bird_full%20color.png) Open main navigation Close main navigation - English Show submenu for translations - Go to payway.com Go to payway.com Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Help Center](https://support.payway.com/knowledge?hsLang=en) 2. [Integration Guides](https://support.payway.com/knowledge/integration-guides?hsLang=en) 3. [Apple Pay](https://support.payway.com/knowledge/integration-guides?hsLang=en#apple-pay) # Integrate Apple Pay® ## This document provides a guide to integrating Apple Pay into your web applications. PaywayWS provides the RESTful web service with which you will interact to implement your Apple Pay interface. **Introduction** Apple Pay provides a secure, wallet-based payment method for your users. The actual integration is done in a JavaScript that we provide to you and you can customize to your needs. **I. Apple Pay and 3DSecure** To use Apple Pay, a user must register a credit card in the wallet on their Apple device. When this process is complete, the card is registered on a 3DSecure token server and the related account number and OnlinePaymentCryptogram is stored securely on the phone. Note that the account number on the wallet entry is not the same as the credit card account number. The data from the wallet on the Apple device is what Payway® sends to the card processor. The processor then interacts with the token server to acquire the original credit card PAN, and the transaction is processed. **II. Integration Methods** There are two ways to integrate Apple Pay transactions with Payway. **A. Using Payway Apple Pay JavaScript** Our JavaScript contains all the logic necessary to communicate with PaywayWS, decrypt Apple Pay payloads, and process payments. We take care of all the cryptography and certifications with Apple Pay. We provide you with a standard JavaScript which you can then modify to support your own payment sheet that is displayed to the user. **B. PaywayWS Apple Pay Cryptogram Requests** In some cases, our partners choose to implement their own Apple Pay integration. This requires managing of the Apple Pay merchants, processors, certificates, etc. In this mode you will send decrypted Apple Pay payloads directly to PaywayWS for processing. See the PaywayWS document for information on the ApplePayCryptogram account entry type. The remainder of this document describes the steps required to integrate with the Apple Pay JavaScript discussed in the previous section. **III. Integration Steps for Processing Payway Apple Pay** Processing an Apple Pay payment is done in four steps. The first step and the final step are executed from your server and are completed via PaywayWS requests. Step 2 and 3 are handled in the Apple Pay JavaScript. The steps are described in the sections below. Note that the first and last steps are executing from your server to the Payway® server. These steps include data that is not sent to the browser. During an Apple Pay transaction only the transaction token, transaction result code, and any error message is available to the browser. The transaction token is described later in this section. Below is a block diagram of the steps for an Apple Pay transaction. Note the two middle steps on the left side are initiated by the JavaScript that we provide for integration. ![apple pay 1](https://support.payway.com/hs-fs/hubfs/apple%20pay%201.jpg?width=416&name=apple%20pay%201.jpg) **DO NOT EXECUTE STEPS 1 OR 4 FROM A JAVASCRIPT. THESE INVOLVE DATA** **THAT SHOULD NOT BE PASSING THROUGH THE CLIENT BROWSER.**   **A. Step One: Queue Transaction** Before presenting the page with the Apple Pay button, you will send PaywayWS a request to queue a payment. This request will return a paywayTransactionToken that will be sent to the browser and used to complete the payment. The transaction token is like a PaywayWS session token except that it can be used only to interact with the queued transaction. This allows us to send to the browser this transaction token without concern for hijacking a Payway session. The queued payment includes the payment amount, source id, and payment type. Once this step is completed the Apple Pay button can be displayed on your page. See the PaywayWS integration guide and the sample application for more on sending the queue payment request. **B. Step Two: Validate Apple Pay Merchant** When the user presses the Apple Pay button on your page, the Apple Pay payment sheet is displayed and a request is sent to PaywayWS to validate Payway® as a valid Apple Pay provider. The payment sheet is ready to accept payment authorization from the user. **C. Step Three: Authorize Apple Pay Payment** Depending on your customized modifications to the JavaScript, the user may interact with the payment sheet by modifying certain fields. When the user authorizes the payment, the JavaScript will send the encrypted Apple Pay information to PaywayWS for processing. The results are processed by the JavaScript. In the sample code the JavaScript posts the results to a confirmation page. You will need to interpret the results and take appropriate action. Note that the JavaScript sends the transaction token to refer to the payment that was queued in step 1. Only the transaction token is available to the browser and the transaction token can be used only to send the queued transaction and read the results. **D. Step Four: Query Transaction Details** In response to the request to send the queued transaction (sendQueuedTransaction PaywayWS request), PaywayWS returns the result code and any error message. This may be all you need to complete the transaction. Optionally you can query the transaction details by sending a request to PaywayWS, getPaymentDetails. An example of this is in the sample application, the TransactionDetails.jsp page. This will return all fields for the payment and account records, with PAN data masked. At this point you can store and/or present any of this information to the user for receipt purposes or other processing. This interaction is between your server and PaywayWS so none of this information is available to the browser during the transaction. **IV. Managing Payway Transactions** The Payway Apple Pay integration uses the PaywayWS RESTful API to validate Apple Pay merchants and perform Apple Pay transactions. To manage your transactions, you can use PaywayWS requests. These include reading transactions and updating user accounts where needed. Reports and other payment management functionality is provided by the Payway web application. V. Sample Application There is a sample application in the form of .jsp pages and a JavaScript. The following files constitute the sample application. The files are commented on to explain each step and indicate where you can customize the JavaScript for your needs. ![apple pay2](https://support.payway.com/hs-fs/hubfs/apple%20pay2.jpg?width=688&name=apple%20pay2.jpg) **VI. Apple®, Inc. Requirements for Apple Pay** Apple has requirements for the look and feel of the button, placement of the button, and interaction with the payment sheet. Refer to Apple’s web site for integration guides including Apple requirements on presenting the Apple Pay button. [https://developer.apple.com/design/human-interface-guidelines/apple-pay/overview/buttons-and-marks/](https://developer.apple.com/design/human-interface-guidelines/apple-pay/overview/buttons-and-marks/) - [Using Payway Payment Manager](https://support.payway.com/knowledge/using-payway-payment-manager?hsLang=en#main-content) - [User admin](https://support.payway.com/knowledge/using-payway-payment-manager?hsLang=en#user-admin) - [Integration Guides](https://support.payway.com/knowledge/integration-guides?hsLang=en#main-content) - [Apple Pay](https://support.payway.com/knowledge/integration-guides?hsLang=en#apple-pay) - [Google Pay](https://support.payway.com/knowledge/integration-guides?hsLang=en#google-pay) - [Payment Processing 101](https://support.payway.com/knowledge/payment-processing-101?hsLang=en#main-content) - [Payment Gateway](https://support.payway.com/knowledge/payment-processing-101?hsLang=en#payment-gateway) - [Pricing & Fees](https://support.payway.com/knowledge/payment-processing-101?hsLang=en#pricing-fees) - [Payment Types](https://support.payway.com/knowledge/payment-types?hsLang=en#main-content) - [Contactless Payments](https://support.payway.com/knowledge/payment-types?hsLang=en#contactless-payments) - [ACH Payments](https://support.payway.com/knowledge/payment-types?hsLang=en#ach-payments) - [Payment Security](https://support.payway.com/knowledge/payment-security?hsLang=en#main-content) - [P2PE (Point-to-Point Encryption)](https://support.payway.com/knowledge/payment-security?hsLang=en#p2pe-point-to-point-encryption) - [Tokenization](https://support.payway.com/knowledge/payment-security?hsLang=en#tokenization) - [3D Secure](https://support.payway.com/knowledge/payment-security?hsLang=en#3d-secure) - [Merchant Account Services](https://support.payway.com/knowledge/merchant-account-services?hsLang=en) - [Payment Gateway Features](https://support.payway.com/knowledge/payment-gateway-features?hsLang=en) - [Failed Payment Recovery](https://support.payway.com/knowledge/failed-payment-recovery?hsLang=en) [![Chill listening crop-3](https://support.payway.com/hs-fs/hubfs/logo%20for%20email-1.jpg?width=100&height=24&name=logo%20for%20email-1.jpg "Chill listening crop-3")](https://payway.com) Copyright © 2026, Payway