---
title: "Create a SEPA Direct Debit to a billing account"
method: POST
path: "/v1/accounts/{account_id}/transactions/sepa_direct_debit"
tags: ["SEPA Direct Debits"]
---

# Create a SEPA Direct Debit to a billing account

`POST /v1/accounts/{account_id}/transactions/sepa_direct_debit`

Initiates a SEPA Direct Debit transaction from an external account (i.e., your customer account) to your billing account. You must add the `account_id` of your billing account in the request URL.

## Path parameters

- `account_id` string, required

## Request body

- object
  - `reference` string — Optional reference for the transaction. Acts as an idempotency key.
  - `amount` SolarisServerDecoratorsMoney
    - `value` integer — The amount value.
    - `unit` string — The unit of the given value in cents.
    - `currency` string — The currency of the given value. Only EUR is currently supported.
  - `description` string — Optional description for the transaction, which will be visible to the debtor. Limited to 140 characters.
  - `collection_date` string — The date on which to collect the direct debit. The default value is the day after the current day. The latest possible date is 14 calendar days in the future.
  - `mandate` object — Object containing information about the direct debit mandate.
    - `reference` string — Reference of the mandate. Must be unique for the creditor identifier.
    - `creditor_identifier` string — Unique reference that identifies a party collecting payments under the SEPA Direct Debit scheme within and across 32 countries. See the [Deutsche Bundesbank's definition of creditor identifier](https://www.bundesbank.de/en/tasks/payment-systems/services/sepa/creditor-identifier/creditor-identifier-626704) for more information.
    - `scheme` 'B2B' | 'CORE' — The scheme to use for the mandate. Use `CORE` unless instructed otherwise.
    - `sequence_type` 'RECURRING' | 'ONE_OFF' — The sequence type of this mandate (i.e., whether the transaction is one-off or recurring).
    - `signature_date` string — The date when the debtor signed the mandate.
    - `debtor_name` string — The debtor's name.
    - `debtor_iban` string — The debtor's IBAN.
    - `debtor_bic` string — The debtor's BIC.
  - `end_to_end_id` string — SEPA identifier provided by the transaction initiator, which will be routed throughout the whole payment process.

## Response `200`

Successful result of the operation

- SolarisServerDecoratorsSepaDebitTransaction
  - `id` string — Unique ID of the transaction.
  - `status` 'created' | 'accepted' | 'declined' | 'executed' | 'review_needed' | 'canceled' — The status of the SDD transaction.
  - `reference` string — Optional reference for the transaction. Acts as an idempotency key.
  - `amount` SolarisServerDecoratorsMoney
    - `value` integer — The amount value.
    - `unit` string — The unit of the given value in cents.
    - `currency` string — The currency of the given value. Only EUR is currently supported.
  - `description` string — Optional description for the transaction, which will be visible to the debtor. Limited to 140 characters. Please note the [SEPA character restrictions.](https://docs.solarisgroup.com/api-reference/standards/#sepa-characters)
  - `collection_date` string — The date on which to collect the direct debit. The default value is the day after the current day. The latest possible date is 14 calendar days in the future.
  - `mandate` object — Object containing information about the direct debit mandate.
    - `reference` string — Reference of the mandate. Must be unique for the creditor identifier.
    - `creditor_identifier` string — Unique reference that identifies a party collecting payments under the SEPA Direct Debit scheme within and across 32 countries. See the [Deutsche Bundesbank's definition of creditor identifier](https://www.bundesbank.de/en/tasks/payment-systems/services/sepa/creditor-identifier/creditor-identifier-626704) for more information.
    - `scheme` string — The scheme to use for the mandate. Use `CORE` unless instructed otherwise.
    - `sequence_type` string — The sequence type of this mandate (i.e., whether the transaction is one-off or recurring).
    - `signature_date` string, date-time — The date when the debtor signed the mandate.
    - `debtor_name` string — The debtor's name. Please note the [SEPA character restrictions.](https://docs.solarisgroup.com/api-reference/standards/#sepa-characters)
    - `debtor_iban` string — The debtor's IBAN.
    - `debtor_bic` string — The debtor's BIC.
  - `end_to_end_id` string — SEPA identifier provided by the transaction initiator, which will be routed throughout the whole payment process. Please note the [SEPA character restrictions.](https://docs.solarisgroup.com/api-reference/standards/#sepa-characters)

## Other responses

- `400` — Invalid request.
- `403` — You are not authorized to perform this action.
- `404` — The resource could not be found.
- `500` — Internal server error.
- `default` — Unexpected error

---

[API](https://skmtc.net/solarisgroup/apis/sepa-transfers.md) · [All operations](https://skmtc.net/solarisgroup/apis/sepa-transfers/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/sepa-transfers/revisions/f1fef352d976/schema)