Apple Pay Integration

Owned by Developer Support (Unlicensed)
Last updated: Aug 07, 2023 by Tom Knuth
3 min read

Apple Pay provides an easy and secure way to make payments in your iOS apps, watchOS apps, and on websites in Safari. And now, Apple Pay can also be used in Business Chat and in iMessage extensions. By using Face ID, Touch ID, or double-clicking Apple Watch, users can quickly and securely provide their payment, shipping, and contact information to check out. Customers love the simplicity of Apple Pay, and you’ll love the increased conversion rates and new user adoption that come with it.

 

There are 2 options for transacting with Apple Pay

Option 1: External Payment

  1. To integrate Apple Pay, you must do all the Apple javascript with the button for your lander. You can find instructions on how to do this by visiting Apple Pay Integration

  2. Once you have configured the Apple Pay Button on your lander, you will then send in Import Order with paySource='APPLEPAY'. It will automatically go to QA unless you also send in the skipQA parameter.

  3. If you want to record Apple Pay declines in the CRM, you would immediately follow the Import Order call with the Order QA API call and action='DECLINE'

  4. Feel free to reference our API documentation for more information regarding our Order QA and Import Order procedures

Option 2: Limited Gateway Support

  1. This option allows the transaction to occur within Konnektive.

  2. Please follow the steps in the Apple Pay Integration  or in the Apple Pay Demo to integrate a web application with the Apple Pay API.

  3. Configure the Apple Pay Button on your lander.

  4. The ApplePaySession onpaymentauthorized function triggered through Button usage will return a token with the event.payment.token parameter.  Send this token to Import Order with paySource='APPLEPAY' and applePayToken= the JSON encoded token.

    1. applePayToken should be a JSON encoded string. Apple documentation is here, and the structure should be similar to this:

    2. {

      "data":"...",

      "signature":"...",

      "version":"..",

      "header":{

      "applicationData":"...",

      "ephemeralPublicKey":"...",

      "wrappedKey":"...",

      "publicKeyHash":"...",

      "transactionId":"..."

      }

      }

  5. The token will be sent to your gateway to complete the transaction

The same steps can be repeated and the token sent on Import Upsale to process an upsell with Apple Pay.

Check with your gateway to confirm if rebills and one-click upsells are supported on Apple Pay

 

Gateway integrations that support Apple Pay tokens are identified on the Gateway Integrations page with the Apple Pay icon.

Braintree requires use of the Braintree JavaScript SDK on your lander. The applePayToken parameter sent in the Import Order API call should be the token returned by Braintree's ApplePay tokenize function.

 

 

Apple Pay Integration

Apple Pay Demo

Import Order

Order QA