---
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`

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 — Payment Account ID
  - `holder` string — IBAN Holder
  - `bic` string — BIC Code (SWIFT)
  - `iban` string — IBAN
  - `isB2B` boolean — Indicates if the mandate is a SEPA business to business direct debit
  - `isRecurring` boolean — 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)

## 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.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)