Use the following steps to ensure a recurring payment can be setup:
-
Initiate a first transaction
If you are using the PSP Payment Page, you need to have initiated a Web Payment usingPOST /moneyins/card/webinitwith registerCard=true.
If you are using the Direct Mode (PCI-DSS authorization required), you need to have registered a card usingPOST /moneyins/card/register. -
You then need to initiate
POST /moneyins/card/{cardid}/subscriptionspecifying the Card Id returned from the first transaction, and the Subscription Id (a unique reference you indicate for this subscription).You will also need to precise the number of Recurring Payments you want us to initiate in count. The TotalAmount corresponds to the amount of each recurring payment. By default, the payment will be processed 15th of the month. -
We will create scheduled transactions in the Lemonway Dashboard (status 14)
-
On each payment execution date, Lemonway will debit the card and change the pending transaction status to success, and then notify you.
How to setup a recurring payment:
-
Initiate your first transaction
-
PSP‑Payment Page flow: call
POST /moneyins/card/webinitwith
registerCard=trueto register the card as part of the checkout. -
Direct‑Mode flow (PCI‑DSS required): call
POST /moneyins/card/registerto register the customer’s card directly.
-
-
Create the subscription
CallPOST /moneyins/card/{cardId}/subscriptionwhere:
{cardId}is the ID you received in step 1.- You include a
subscriptionId(your own unique reference for this subscription). - Set
countto the total number of payments you want to schedule. - Set
totalAmountto the amount charged each time.
By default, payments will run on the 15th of each month.
-
Dashboard scheduling
Lemonway automatically creates scheduled transactions (in status 14) in your Dashboard for each installment. -
Execution & notification
On each payment date:- Lemonway debits the card, changes the transaction status from “pending” to “success,”
- then sends you a notification of the completed payment.