---
title: "Register a Cheque"
method: POST
path: "/v2/moneyins/cheque/init"
tags: ["MoneyIns | Cheque"]
---

# Register a Cheque

`POST /v2/moneyins/cheque/init`

The following rules apply:
If you want to pre-enter the cheques in our system, use the POST /moneyins/cheque/init method<br />
The cheque must be made out to Lemonway<br />
On the back of the cheque, please enter a code to facilitate reconciliation. It will be of the following form: XXXXX-YYYYYYYYYY <br /><ul><li>"XXXXX: code identifying you as indicated in your production configuration form </li><li>-: a separation dash:</li><li>YYYYYYYYY : external identifier of your user's payment account </li></ul>
The holder of the cheque must be identical to that of the payment account to be credited <br />

## Headers

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

## Request body

- MoneyInChequeInitInput
  - `transferId` string — Leave Empty
  - `partner` string — Leave empty
  - `chequeType` 15 | 23 — Cheque payment (by default) or Pagaré:<br/>15 = Cheque payment.<br/>23 = Pagaré.<br/>
  - `ChequeNumber` string — The seven-digit number at the bottom left-hand corner of the cheque.
  - `BankIdentifier` string — Zone Interbancaire (ZIB). The twelve-digit number used to identify the cheque holder’s bank.
  - `InternalIdentifier` string — Zone Interne (ZIN). The twelve-digit number used to identify the cheque holder’s account.
  - `RLMC` integer — La Clé de Recomposition de la Ligne Magnétique du Chèque. These 2 numbers help identify a potential counterfeit cheque. (only France)
  - `CheckFnci` boolean — Fichier National des Chèques Irréguliers de la Banque de France. This FNCI check allows to make a verification on the cheque information. (only France) Please contact our support for this feature.
  - `reference` string — Unique ID of the call, generated by your server. This ID can be used as a search field when looking for operation details
  - `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

- MoneyInChequeInitOutput
  - `transaction` 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)