# Create a SEPA Credit Transfer from a billing account

Creates a SEPA Credit Transfer from the billing account specified in the request URL to the account specified in the request body.

Endpoint: POST /v1/accounts/{account_id}/transactions/sepa_credit_transfer
Version: 1.0

## Path parameters:

  - `account_id` (string, required)

## Request fields (application/json):

  - `recipient_iban` (string, required)
    The recipient's IBAN.
    Example: "DE32110101001000000029"

  - `reference` (string)
    Optional reference for the transaction. Will act as an idempotency key.

  - `recipient_name` (string)
    The recipient's name.
    Example: "Hans Mustermann"

  - `recipient_bic` (string)
    The recipient's BIC.
    Example: "COBADEFFXXX"

  - `amount` (object)
    The amount to transfer to the recipient.
    Example: {"value":1000,"currency":"EUR","unit":"cents"}

  - `amount.value` (integer)
    The amount value.
    Example: 1000

  - `amount.unit` (string)
    The unit of the given value in cents.
    Example: "cents"

  - `amount.currency` (string)
    The currency of the given value. Only EUR is currently supported.
    Example: "EUR"

  - `description` (string)
    Optional description for the transaction, which will be visible to the recipient. Limited to 140 characters.
    Example: "Example transaction"

  - `end_to_end_id` (string)
    SEPA identifier provided by the transaction initiator, which will be routed throughout the whole payment process.

## Response 200 fields (application/json):

  - `id` (string)
    Unique ID of the transaction.
    Example: "45bd0881-a79a-4054-9286-f11060d5511f"

  - `status` (string)
    Status of the transaction.
    Enum: "created", "authorization_required", "confirmation_required", "accepted", "declined", "executed", "review_needed", "scheduled", "canceled"

  - `reference` (string)
    Optional unique reference. Used as an idempotency key.
    Example: "8880a72c-2675-482d-8d88-70a02c608592"

  - `amount` (object)
    The amount of the transaction.

  - `amount.value` (integer)
    The amount value.
    Example: 1000

  - `amount.unit` (string)
    The unit of the given value in cents.
    Example: "cents"

  - `amount.currency` (string)
    The currency of the given value. Only EUR is currently supported.
    Example: "EUR"

  - `description` (string)
    Additional description about the transaction. Please note the [SEPA character restrictions.](https://docs.solarisgroup.com/api-reference/standards/#sepa-characters)

  - `recipient_iban` (string)
    The recipient's IBAN.
    Example: "DE87110101001000057123"

  - `recipient_name` (string)
    The recipient's name. Please note the [SEPA character restrictions.](https://docs.solarisgroup.com/api-reference/standards/#sepa-characters)
    Example: "Max Mustermann"

  - `recipient_bic` (string)
    The recipient's BIC.
    Example: "SOBKDEB2XXX"

  - `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)
    Example: "END2ENDREJ"

  - `batch_id` (string)
    Unique ID of the batch.
    Example: "d6c778822b2d7bd3b778935bcfd0d1d3csc"

  - `created_at` (string)
    UTC timestamp from when the transaction was created.
    Example: "2021-01-01T20:37:50Z"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Solaris::Identification' for id 'bbbcccfff388923eb899a5852df6cidt'."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."