Accept Apple Pay

MintCash supports Apple Pay wherever the underlying provider does. How you integrate depends on the Payment Provider abilities. This guide walks through what it requires of you, the integration path, and what to consider during testing.

Before you start

Complete the setup of your Apple Pay developer account first — Apple Merchant ID and merchant identity certificate. In case you work with a Payment Provider that have it set up for you, you just need to collect those IDs for us. Then, provide the credentials to your account manager and that's it. All the configuration will happen on MintCash side, and because the Apple Pay button renders on our Hosted Payment Page, domain verification is handled on our domain.

Integration

Once your account manager configures your account, the Apple Pay button is rendered on the Hosted Payment Page by default (default or customized HPP). Every payment or subscription you create via the API will display the option to proceed with Apple Pay through our platform. Decryption can happen on the provider's side or ours, depending on the provider's capabilities. The integration you write is the same either way.

1. You create the payment; we respond with the redirectUrl.
2. The payment page displays the available payment methods, including Apple Pay.
3. Apple Pay authenticates the customer and returns the encrypted payment data, which we pass to the provider.
4. If the issuer requires extra verification (3DS or OTP), the customer completes it in place on the page.
5. We send the webhook to your callbackUrl with the final state.

What to test

Run each flow you plan to ship before going live:

• Happy path — an Apple Pay authorization that lands on payment.succeeded.
• 3DS challenge — confirm the challenge renders and finalizes successfully.
• Webhook delivery — confirm your endpoint receives the final event.