Skip to main content

Apple Pay

Apple Pay is available via the following JustiFi checkout options:

Apple Pay is not available in the Tokenize Payment Method web component or via API.

Prerequisites​

  • Use any compatible device, a comprehensive list can be found here
  • Your application must be served over HTTPS.
  • Ability to host a file under /.well-known/ in the domain(s) the checkout will be hosted.
  • Use one of the JustiFi Checkout options (Hosted Checkout, Unified Fintech Checkout or Modular Checkout web component)

Enabling Apple Pay for your account​

To process Apple Pay payments via JustiFi's checkout your platform needs to be registered with Apple. The following steps describe the registration process.

Host Apple Merchant Validation​

Apple requires that each domain you will use to process Apple Pay payments from hosts a specific file (linked below) under the path /.well-known/apple-developer-merchantid-domain-association.
Ensure you have access to host the file under all provided domains.
Note: The FQDN (Fully Qualified Domain Name) is required, wildcard domains are not supported.

Apple Pay merchant validation file

Provide Platform Domain Names​

Once you have added the Apple Pay merchant validation file on youe platform provide your domain(s) to JustiFi for registration.

Merchant Registration​

JustiFi will initiate the registration with Apple for the provided domains.
After Apple validates the files and confirms the registration JustiFi will enable your platform for Apple Pay.
If Apple is not able to reach and validate the files the registration will fail.

Adding new domains​

If you add the Apple Pay payment options to new domains on your platform at a later point you will need to register these new domains with Apple folling the steps described above. Already registered domains are not impacted by this change.

Processing Apple Pay Payments​

Once your platform is successfully registered with Apple you are ready to process Apple Pay payments. If you use Hosted Checkout or the Unified Fintech Checkout web component the Apple Pay button will automatically appear in the checkout form.
To add Apple Pay to the Modular Checkout web component include the Apple Pay sub component in the Modular Checkout as the example below shows. For more details refer to the Modular Checkout docs

<justifi-modular-checkout
  auth-token="your-auth-token"
  checkout-id="your-checkout-id"
>
  <justifi-apple-pay />
</justifi-modular-checkout>

JustiFi will create a payment method record (ID starting with pm_) for each transaction processed via Apple Pay. Note: JustiFi payment methods created via Apple Pay are one time use only. They cannot be used for later payments or recurring payments.

Testing your Apple Pay Integration​

When you use Apple Pay in JustiFi's test environment the Apple Pay checkout process will simulate a live Apple Pay payment with a live Apple Pay payment method. Instead of charging the live payment method used for the test transaction JustiFi will replace it with a test payment method (account number 4111***1111) and simulate the payment transaction.
JustiFi will NOT charge or save the real credit card for these test transactions.

Provision Test account​

To set up your Apple Pay test environment follow these steps:

  1. Host the Apple Pay merchant validation file on your test domain(s)
  2. Provide the test domain(s) to JustiFi
  3. Provide a JustiFi test account ID you want to use to test Apple Pay Note: The test domain needs to be publicly available so Apple Pay can verify the validation file

Checkout via Apple Pay​

The easiest and fastest way to see Apple Pay in action is via the JustiFi dashboard:

  • On desktop use the Safari browser to log in to the JustiFi dashboard (https://app.justifi.ai)
  • Go to the "Developers" section and enable "Test Mode"
  • From the "Payments" section select "Checkouts"
  • Create a checkout via the "Create Checkout" button and provide the account ID of the Apple Pay enabled sub account
  • Open the newly created checkout and click on the "Hosted Checkout URL". This will open the JustiFi Hosted Checkout form with the Apple Pay button visible
  • Using Apple Pay will prompt the use of a real Apple Pay wallet on an iPhone
  • Accepting the payment will simulate a successful payment but will not charge the real Apple Pay card.

To provide Apple Pay on your platorm via embedded JustiFi Checkout web components follow this integration guide:
Checkout via web component

See Also​

  • Google Pay™ - Learn about Google Pay™ integration with JustiFi