Setup

Prerequisites

In order to implement to Apple Pay into your app using Elavon Pay SDK, you will need Xcode 6.1 and iOS8.1. The device you are developining on must not be rooted or jailbroken. You will need a Mac computer to build the sample app and your application.

Finally, in order to develop an application, you’ll need an Apple Developer account as well as a Converge account.

Registering for Apple Developer

  1. Navigate to https://developer.apple.com/
  2. Select Member Center
  3. Either login if you have an Apple ID or create a new Apple ID. Ensure your account is a developer account. If it isn’t, you will be required to register it as a developer, which usually requires a licensing fee.

Gaining Access to Converge Environment

Converge requires credentials to access the platform and perform transactions. It also requires that developers have credentials in order to create their own payment platforms.

To get credentials, you must contact Elavon at the Software Technical Support email - techsupp@elavon.com. You can also call for these credentials at 1-800-377-3962 then pressing Option 2 followed by Option 2.

You will have to provide the following details:

  • Company Name
  • Primary Contact Name
  • Primary Contact Phone
  • Primary email address

Once your request is processed, Elavon will send you demo credentials.

Target URLs

With Apple Pay, you will need to go to the following URLs to manage and acquire the Certificate Signing Request (CSR).

Install Xcode

  1. Navigate to the Mac App Store and search “Xcode” - https://itunes.apple.com/us/app/xcode/id497799835?ls=1&mt=12

  2. Once the app is installed, open Xcode and select preferences. We will need to add your Apple Developer account. On the account’s page, select the plus (+) icon to add a new account.

  3. After selecting the plus symbol (+), select Add Apple ID.

  4. Enter in your Apple Developer credentials and add the account.

You are now ready to download the CSR from Converge. Please log into your Converge account.

Download CSR from Converge

Apple requires provisioning files and certificates in order to start developing an Apple Pay solution. This process is a bit complicated, but first, we need to log into Converge and receive a CSR file that we will import into Apple Developer Center. This imported file will generate Apple Pay certified CSR.

  1. Log into Converge.

  2. Navigate to Management

  3. Select Terminals

  4. Select Apple Pay Setup

  5. Download the CSR in step 1 of this tab. You now have your Apple Pay CSR from Converge. You must have a Merchant ID instead of Apple Developer. If you do not, please create a Merchant ID with this guide. If you already have a Merchant ID but don’t have an application, then you must create an application inside of Apple Developer. If you have a Merchant ID and an application, you can go straight to uploading the CSR into Apple Pay.

Creating a Merchant ID

If you haven’t created your Merchant ID yet inside of Apple Developer Center, please follow the following steps.

  1. Log into Apple Developer Center and select “Identifiers.”

  2. From the side bar, select “Merchant IDs.”

  3. In the Merchant IDs section of Apple Developer, select the plus (+) icon on the top right next to search. This will create a new Merchant ID.

  4. You will register a Merchant ID. Enter your Description for your Merchant ID and create the unique Identifier, noting it will require a prefix of “merchant.” Select “Continue.”

  5. You will get a confirmation page, showing what oyu just created. Select “Register” to create the Merchant ID.

  6. You are now ready to import the CSR, but first, you need to create an application inside of Apple Developer Center. Please continue to the section on uploading the CSR to the Apple Developer Center if you already have an app.

Creating an Apple Mobile Application

  1. If you have not created an app yet, please select the plus (+) icon from the App ID section of the Developer Center.

  2. Fill out all the information as desired for your application. Be sure to include the following options to allow for ApplePay integration.

  3. Select Submit to create the App with Apple.

  4. You are now ready to upload your CSR Certificate.

Generating an Apple Pay Cert File

Now, we have the CSR that we needed from Converge. We will upload this file to Apple Developer’s portal to generate a new one.

  1. Go to your Apple Developer Account. Select the Certificates, Identifiers, & Profiles selection to add the CSR.

  2. Select Certificates under iOS Apps.

  3. From the main Certificate page, select the plus (+) icon to create a new certificate. Make sure to select Apple Pay Certificate. Select Continue.

  4. Confirm your Merchant ID and select Continue twice, once to confirm the MerchantID and once to accept the terms of uploading, Now, select “Choose File…” under the Upload CSR file section. Select the Apple Pay.CSR that you downloaded from Converge. Select Generate to create the Apple Pay certificate.

  5. This button will generate a new Apple Pay certificate and begin downloading it. Return to Converge, particularly the Apple Pay Setup page.

  6. Choose File to find your applecert file.

  7. Select the Certificate, and it will upload. Once it is done, you will get a confirmation message.

  8. Your Converge instance is now connected to Apple Pay.