---
title: "Initiate Monthly Recurring Payments"
method: POST
path: "/v2/moneyins/card/{cardid}/subscription"
tags: ["MoneyIns | Cards"]
---

# Initiate Monthly Recurring Payments

`POST /v2/moneyins/card/{cardid}/subscription`

Use the following steps to ensure a recurring payment can be setup:  
1. Initiate a first transaction  
   If you are using the **PSP Payment** Page, you need to have initiated a Web Payment using `POST /moneyins/card/webinit` with **registerCard=true**.     
   If you are using the **Direct Mode** (PCI-DSS authorization required), you need to have registered a card using `POST /moneyins/card/register`.  
    
2. You then need to initiate `POST /moneyins/card/{cardid}/subscription` specifying 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.  
3. We will create scheduled transactions in the Lemonway Dashboard (status 14)   
4. On each payment execution date, Lemonway will debit the card and change the pending transaction status to success, and then notify you.

## Path parameters

- `cardid` integer, required

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Request body

- MoneyInSubscriptionInitInput
  - `subscriptionId` string — Subscription ID
  - `Count` integer — Number of operations to be performed on this subscription
  - `accountId` string, required — Payment Account ID to Credit
  - `totalAmount` integer, required — Amount to Debit Amounts are given as integer numbers in cents
  - `commissionAmount` integer — Your Fee Amounts are given as integer numbers in cents
  - `comment` string — Comment Regarding the Transaction
  - `autoCommission` boolean — If true: 1. [amountCom] will be ignored and will be replaced with Lemonway's fee 2. You will not receive any fee

## Response `200`

OK

- MoneyInSubscriptionInitOutput
  - `transactions` TransactionsTransactionIn
    - `value` TransactionIn[]
      - `receiverAccountId` string — Credited Account
      - `creditAmount` integer — Credited Amount Amounts represented in integer (cents)
      - `scheduledDate` string
      - `scheduledNumber` string
      - `maskedLabel` string
      - `PSP` PSP
        - `message` string — Get the Error Message from PSP
      - `card` Card
        - `id` integer
        - `is3DS` boolean — Card with 3-DS authentication
        - `country` string — Card issuing country
        - `authorizationNumber` string — Authorization number
        - `maskedNumber` string — Masked card number
        - `expiration` string — Expiration date (if available)
        - `type` string — Card type (example: Visa or Mastercard)
        - `isRegistered` boolean — Card is registered
        - `holderName` string — Card's holder name
      - `bankStatus` string
      - `refundAmount` number, double
      - `bankReference` string — Bank reference
      - `ChequeSendingAddress_CorporateName` string — A specified postal address for the cheque
      - `ChequeSendingAddress_Street` string — Cheque sending address street name
      - `ChequeSendingAddress_City` string — Cheque sending address city name
      - `ChequeSendingAddress_PostCode` string — Cheque sending address post code
      - `threeDS` ThreeDs
        - `threeDSModeRequested` string — 3DS Exemption Request Possible value: NO_PREFERENCE: The issuing Bank can choose to activate or not 3DS v2.
        - `threeDSResult` string — 3DS Authentication Result Possible values: - CHALLENGE: 3DS v2 was activated and the card owner was asked to be strongly authenticated. - FRICTIONLESS: 3DS v2 was not activated. - NONE: We could not get the SCA result.
      - `buyNowPayLaterInfo` BnplInfo
        - `paymentPlanId` integer — Payment Plan ID
        - `type` string — Payment plan type.
        - `secondInstallmentPaymentDate` string — Second installment payment date. Format: yyyy-MM-dd
        - `deferredPaymentDate` string — Deferred payment date. Format: yyyy-MM-dd
      - `id` integer — Transaction ID
      - `method` integer — Payment Method 0 Card 1 Bank transfer (MoneyIn) 3 Bank transfer (MoneyOut) 4 P2P 13 iDEAL 14 SEPA DirectDebit 15 Cheque 19 Multibanco 21 MBWAY 30 BNPL 35 PayPal --- **Important:** The following services have been discontinued. 16 Neosurf 17 Sofort 18 PFS Physical Card 20 Payshop 22 Polish Instant Transfer 23 Pagare 24 MobilePay 25 Paytrail 26 WeChat 27 P24 28 MoneyIn by TPE 29 Trustly
      - `methodDetails` 0 | 1 — Payment Method Details 0 Standard 1 Pay By Bank<br/>0 = STANDARD.<br/>1 = PAY_BY_BANK.<br/>
      - `date` integer — Transaction initialization date, UTC Unix timestamp
      - `commissionAmount` integer — Your fee Amounts are given as integer numbers in cents
      - `comment` string — Comment
      - `status` integer — **For the following endpoints uses the below status code** /v2/accounts/{accountId}/transactions /v2/moneyins /v2/moneyins/card/direct /v2/moneyins/card/{cardid}/rebill /v2/moneyins/card/{cardid}/subscription /v2/moneyins/{transactionid}/validate /v2/moneyins/sdd/init /v2/moneyins/sdd /v2/moneyins/{transactionid}/cancel /v2/refund/{transactionid} /v2/refundcreate/{transactionId} 0: Success 3: Lemonway Error 4: Pending 6: PSP error 7: Cancelled 16: Validation pending **For the following endpoints uses the below status code** /v2/disputes /v2/moneyins/bankwire /v2/moneyins/card/direct/3dinit /v2/moneyouts /v2/p2p /v2/p2p/{transactionid?} 0: Waiting for finalization 3: Success 4: Lemonway Error
      - `executionDate` integer — Transaction execution date
      - `lemonWayCommission` LemonWayCommission
        - `idp2p` string
        - `amount` integer — Amounts are represented as integer in cents (Euro) Represented as an integer in cents (Euro)
      - `reference` string — Unique ID generated by your server
      - `remainingAmount` integer
      - `substatus` string — Is Payment token consumed?
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string — Get the Error Message from PSP

## Other responses

- `401` — Unauthorized
- `500` — InternalServerError

---

[API](https://skmtc.net/lemonway/apis/account-onboarding-management-api.md) · [All operations](https://skmtc.net/lemonway/apis/account-onboarding-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemonway/account-onboarding-management-api/revisions/73309fe68e2d/schema)