---
title: "Register a SDD Mandate"
method: POST
path: "/v2/moneyins/sdd/mandate"
tags: ["MoneyIns | Direct Debits"]
---

# Register a SDD Mandate

`POST /v2/moneyins/sdd/mandate`

## Request

- Base URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest`
- URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest/v2/moneyins/sdd/mandate`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

This method allows you to pre-register a mandate.<br /><ul><li>If you register a mandate with electronic signature, the mandate will be pending. You need to use the [Generate an Electronic Signature of a Document](https://documentation.lemonway.com/reference/accounts_documentssigninitpost) call to sign the mandate. The status will change accordingly.</li><li>If you register a mandate with opt-in signature, the mandate will be automatically validated. Please refer to the Support Team for this option.</li></ul>

## Headers

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

## Request body

- RegisterSddMandateInput
  - `wallet` string, required: Payment Account ID
  - `holder` string, required: Debtor Name
  - `bic` string, required: BIC Code (SWIFT)
  - `iban` string, required: IBAN
  - `isB2B` boolean: Indicates if the mandate is a SEPA business to business direct debit
  - `isRecurring` boolean, required: 1. If true, mandate is for recurring payments 2. If false, mandate is for one payment only
  - `street` string: Client Number and Street Mandatory if you plan to electronically sign the mandate
  - `postCode` string: Client Postal Code/ZIP Mandatory if you plan to electronically sign the mandate
  - `city` string: Client City Mandatory if you plan to electronically sign the mandate
  - `country` string: Client Country Mandatory if you plan to electronically sign the mandate.
  - `mandateLanguage` string: Language of the automatically generated mandate(for electronic signature). Currently, the available languages are: fr, en, de, es, it. If you need another, please contact us. "fr" is used by default if no language is requested.
  - `rum` string: Unique Mandate Reference Number (UMR)
  - `signerFirstName` string: Signer's First Name Required when `SignerLastName` is provided.
  - `signerLastName` string: Signer's Last Name. Required when `SignerFirstName` is provided.
  - `signerEmail` string: Signer's Email (optional).

## Response `200`

OK

- RegisterSddMandateOutput
  - `SSDMandate` SddMandate
    - `id` integer: Mandate ID
    - `status` 0 | 5 | 6 | 8 | 9: Mandate Status<br/>0 = Pending validation.<br/>5 = Validated, First SDD to be done.<br/>6 = Enabled.<br/>8 = Disabled.<br/>9 = Rejected.<br/>
    - `IBAN` string: IBAN associated to the mandate
    - `BIC` string: SWIFT code associated to the mandate
    - `holder` string: IBAN Holder
    - `UniqueMandateReference` string: Unique mandate reference
  - `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.dev/lemonway/apis/lemonway-directkit-api-2-0.md) - [All operations](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/revisions/82551a0a77b8?raw)