Step 1 - Integrate to Apple Pay and eProtect

Document created by gjsissons on Jul 20, 2016Last modified by lkilligrew on Aug 9, 2016
Version 9Show Document
  • View in full screen mode

Your first step is to create your iOS app and integrate to Apple Pay using their PassKit Framework. Apple Pay generates a PKPayment token when an iOS application requests payment data, as illustrated below:




  1. When the consumer selects the Apple Pay option on your iOS app, your app uses the Apple PassKit Framework to request payment data from Apple Pay.
  2. After the consumer approves the Payment Sheet (using Touch ID), Apple receives a call from your app and creates a PKPayment Token using your public key. The PKPayment Token includes a network (card brand) payment token and a cryptogram.
  3. Apple Pay returns the Apple PKPayment Token to your app. The PKPayment Token is used to obtain a Registration ID from eProtect.


For more information on the Apple Pay PKPayment Token, please refer to: 

For more information about using Apple Pay with eProtect, please see Vantiv eCommerce Apple Pay Solution


Integration Steps

  1. Vantiv will provide you with a Certificate Signing Request (CSR), which you must submit to Apple. Apple will return the certificate, containing your public/private encryption keys, to you. Provide this information to your Implementations Consultant.
    • Apple uses the public key to create the PKPayment Token.
    • Vantiv stores the decryption of your POST request in eProtect.
  2. Your consultant will create a test account in the Vantiv eCommerce sandbox, referred to as the "pre-live environment". The CSR will be uploaded to your test account, which finalizes your configuration.
  3. Create an iOS app using the Apple Pay Passkit Framework. Refer to
  4. Integrate to the eProtect Mobile API: Please refer to the Vantiv Enterprise eProtect Integration Guide, Section 2.3: Integrating Mobile API into your Mobile Application for details on integrating to the eProtect Mobile API.


    Previous: Overview of OmniChannel for Integrated Payments

    Next: Step 2 - Choose OmniToken Format


    Return to In-App for MercuryPay home page