API Reference Docs
OnboardingAPI v1ChangelogAPI Status
Start typing to search…

Apple Pay Implementation

Getting Started with Apple Pay

Apple Guidelines

When implementing Apple Pay, you must follow Apple’s official guidelines for both design and technical integration. These guidelines ensure a consistent user experience and compliance with Apple’s requirements for websites and mobile applications.

Please refer to Apple’s documentation when designing the payment flow and implementing Apple Pay on your platform.

Apple Pay Certificate

To process payments with Apple Pay, an Apple Pay certificate is required.

  • Web integration You can use Lemonway’s Apple Pay certificate, which significantly simplifies and speeds up the setup process.

  • Mobile integration (iOS apps) You must use your own Apple Developer account and generate your own Apple Pay certificate. This option involves additional configuration steps and must be managed directly by your team.

The integration approach and certificate requirements depend on whether Apple Pay is implemented on the web or within a mobile application.

Activate Payment with Apple Pay

Apple Pay transactions use the same POST /moneyins/card/webinit endpoint as standard MoneyIn | Card operations. Before you can use this feature, specific setup and activation steps are required. To get started, please contact your Account Manager or reach out to our Support Team.

For information on how it works see: Apple Pay x Lemonway

Payment with a New Card

  1. Call POST /moneyins/card/webinit to receive a MoneyInToken. If you include registerCard=true, you’ll also get back a cardId for future payments.
  2. Redirect your end‑user to the PSP payment page by combining the MoneyInToken with your Lemonway Webkit URL (provided in your onboarding email). For example: https://sandbox-webkit.lemonway.fr/YOUR_COMPANY/dev/
  3. After the end‑user submits payment, they’ll be sent to one of three URLs on your system:
  • returnUrl on success
  • cancelUrl on cancellation
  • errorUrl on error
❗️

Important

Make sure all three URLs are publicly accessible so both the end‑user and Lemonway’s WebKit server can reach them.

❗️

Important

Whenever you see accountId in a path or body parameter, enter your wallet’s ID