Reference
Need help?

Apple Pay using Remote JSON API

Merchant can use their own Apple Developer Account to integrate Apple Pay. This includes verifying their domain, creating a Merchant ID specific to Apple Pay, and acquiring the required certificates.

Merchants with an Apple ID can handle Apple Wallet transactions independently and send the Apple-generated data to Telr for processing.

Apple developer account configuration process

  1. Merchants will verify their domain name in their Apple Developer account, where Apple Pay will be utilized..

  2. Create a Merchant ID (e.g. merchant.com.Telr.applepay) in the Apple developer account.

  3. Obtain payment processing certificate from the Apple Developer account.

  4. Obtain session certificate from the Apple developer account.

  5. Share the apple pay token processing certificate (#3) (file with extension .cer) and key (file with extension .p12), along with any required password, with Telr to update at Telr's side.

File generation process

If ApplePay needs to be added as a payment option on your website or application, then you must provide us (Telr) your certificate and password for uploading into our system.

You must provide the following files:

  1. Key: File with extension ".p12"
  2. Certificate: File with extension ".cer"

Apple merchant certificate creation process

  1. Generate a Private Key for the Certificate Signing Request (CSR). Please use elliptic curve cryptography (ECC) with a 256 character key length (prime256v1).  

openssl ecparam -out private.key -name prime256v1 -genkey

  1. Create CSR (Certificate Signing Request) by using your Private Key
openssl req -new -sha256 -key private.key -nodes -out request.csr

  1. Then upload CSR to Apple Developer Portal. Upload the 'request.csr" file on the Apple Developer portal to associate with the Merchant Identifier. This will generate an apple_pay.cer file.

  1. Create a .pem File from .cer
openssl x509 -inform DER -outform PEM -in apple_pay.cer -out temp.pem

  1. Generate a .p12 Key with Private Key and .pem File
openssl pkcs12 -export -out key.p12 -inkey private.key -in temp.pem

  1. Convert Files to .pem:
openssl x509 -inform DER -outform PEM -in apple_pay.cer -out certPem.pem

openssl pkcs12 -in key.p12 -out privatePem.pem -nocerts -nodes

Processing ApplePay In Web or in iOS App

  1. You must include the following parameters to create a Payment Request
  • Currency code
  • Country code
  • Amount
  • Supported Networks
  • Merchant Capabilities.
  1. Create an ApplePay session through the payment request to initiate an Apple Pay session.
  2. Merchant ID must be validated for the Apple Pay session.
  3. Merchant must complete the payment method selection operation.
  4. Receive the payment authorization token. After a successful authorization, merchant will receive a token with the payment data.