Enable Apple Pay for Shoppers

Enable your shoppers to take advantage of their Apple Pay account during checkout. Unsure which alternative payment methods to set up? See all supported alternative payment methods.

Requirements

Domain Verification

Apple requires that your website use HTTPS, with a valid SSL certificate, TLS 1.2 support, and a unique IP with no redirects. Merchants must re-verify their domain with a new certificate when changing domains. Reach out to Bolt to get your domains re-verifed.

Pre-Authorization

A pre-authorizaiton workflow is required to use Apple Pay. This is due to Apple’s requirement of an order token to initiate payment.

Processor Enablement

• Adyen: Reach out to your Adyen representative and state that you would like to enable the Apple Pay payment method and use it with a third party Apple Developer account (Bolt).
• Braintree: Reach out to your Braintree representative and state that you are using Bolt to implement Braintree’s Apple Pay decrypted server side solution. Then, request that Braintree enables Apple Pay for your account without registering a domain (Bolt verifies the domain). This step can only be completed by an internal Braintree representative.

Pre-Existing Apple Pay Setups

To use Apple Pay with Bolt, you may have to contact both your platform and processor representative to disconnect your pre-existing Apple Pay integration.

Workflow

1. Shopper selects Apple Pay and initiates first shipping & tax call; merchant obtains zipcode, country code, state, region, and placeholder phone number.
2. Shopper authorizes the transaction; merchant obtains shopper’s name, email, phone, street address.
3. Bolt validates using a second shipping & tax call.
4. Bolt forwards information to Apple Pay authorization endpoint.

Setup

BigCommerce

The following steps apply only to those using Bolt’s native BigCommerce integration (released December, 2020).

1. Log into BigCommerce.
2. Navigate to Store Setup > Payment Methods > Digital Wallets.
3. Choose Apple Pay.
4. Select Set up.
5. Save.

Magento Commerce

Custom Cart

Consumer Data

Apple Pay provides minimal consumer data until authorization time. Bolt receive’s the following information:

• Shopper’s Phone Number: received during initial shipping API call
• Shopper’s Name, Email, and Address: received during the tax calculation API call

Example Response

{
  "request_source":"applePay",
  "order_token": "<token>",
  "cart": {
    "total_amount": 10000,
    "currency": "USD",
    "items": [
      {
        "reference": "1",
        "name": "item name",
        "total_amount": 10000,
        "unit_price": 10000,
        "tax_amount": 0,
        "quantity": 1,
        "sku": "1"
      }
    ],
    "tax_amount": 0,
    "order_reference": "<ref>",
    "display_id": "<display_id>"
  },
  "shipping_address": {
    "street_address1": "n/a",
    "postal_code": "94103",
    "locality": "San Francisco",
    "region": "California",
    "country_code": "US",
    "country": "United States",
    "name": "n/a",
    "first_name": "n/a",
    "last_name": "n/a"
  }
}

Limitations

• The Apple Pay button must appear below Bolt Checkout due to security restrictions set by Apple.
• Styling customizations are limited to black and white stylings.
• Does not currently support split shipping and tax.

Styling Options

You can change the style of the Apple Pay button by passing in one of the follow classes to the checkout button div:

• Black Button, White Text: with-apple-pay-black
• White Button, Black Text: with-apple-pay-white
• White Button, Black Border: with-apple-pay-white-with-line