Payment with a New Card

Call POST /moneyins/card/webinit to receive a MoneyInToken.
- If you include registerCard=true, you’ll also get back a cardId for future payments.
Redirect your end‑user to the Lemonway 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/
```
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
Make sure all three URLs are publicly accessible so both the end‑user and Lemonway’s WebKit server can reach them.

Payment with a Registered Card (Web)
Before you can use a registered card, you must:

Have already made at least one transaction with registerCard=true to obtain and save a cardId.
(Optional but recommended) Call the GetCard method to confirm the card is registered.

To process a payment with that saved cardId:

Call POST /moneyins/card/webinit (referred to as “MoneyInWebInit”) and include the cardId in the request body.
Follow steps 2 and 3 from the “Payment with a New Card” flow above to redirect the user and handle return, cancel, or error URLs.

Subscription Payments
Prerequisite: you must have already registered a card via POST /moneyins/card/webinit.

To set up recurring payments:

Ensure recurringAvgAmount is greater than totalAmount; otherwise you’ll receive error 368 (recurringAvgAmount must be greater than the transaction amount).
The initial subscription transaction can be for a predetermined or undetermined period.

Once the card is registered, call:

POST /moneyins/card/{cardId}/rebill

to begin setting up the subscription or delivery‑based payments.

Important: For the smoothest experience, configure each recurring payment to use the same amount.

Deferred Payments
If you need a deferred web payment:

Include captureDelayedDays (between 1 and 6) in your POST /moneyins/card/webinit request to hold funds.
Before the delay period expires (within 6 days), call:
```
PUT /moneyins/{transactionId}/validate
```
to capture the funds. Once successful, the transaction status will change to “Success.”

Note: Deferred payments are available on Mercanet v2.

🆕 Activate Payment with Apple Pay

Reach out to your Account Manager or contact our Support Team to get started today!

See: Apple Pay x Lemonway

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