SEPA Credit Transfers

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.

post/v1/accounts/{account_id}/transactions/sepa_credit_transfer

Path parameters

account_idstring required

Request body

referencestring

Optional reference for the transaction. Will act as an idempotency key.

recipient_namestring

The recipient's name.

recipient_ibanstring required

The recipient's IBAN.

recipient_bicstring

The recipient's BIC.

descriptionstring

Optional description for the transaction, which will be visible to the recipient. Limited to 140 characters.

end_to_end_idstring

SEPA identifier provided by the transaction initiator, which will be routed throughout the whole payment process.

Example request

{
  "reference": "",
  "recipient_name": "Hans Mustermann",
  "recipient_iban": "DE32110101001000000029",
  "recipient_bic": "COBADEFFXXX",
  "amount": {
    "value": 1000,
    "currency": "EUR",
    "unit": "cents"
  },
  "description": "Example transaction",
  "end_to_end_id": ""
}

Response

Successful result of the operation

idstring

Unique ID of the transaction.

status'created' | 'authorization_required' | 'confirmation_required' | 'accepted' | 'declined' | 'executed' | 'review_needed' | 'scheduled' | 'canceled'

Status of the transaction.

referencestring

Optional unique reference. Used as an idempotency key.

descriptionstring

Additional description about the transaction. Please note the SEPA character restrictions.

recipient_ibanstring

The recipient's IBAN.

recipient_namestring

The recipient's name. Please note the SEPA character restrictions.

recipient_bicstring

The recipient's BIC.

end_to_end_idstring

SEPA identifier provided by the transaction initiator, which will be routed throughout the whole payment process. Please note the SEPA character restrictions.

batch_idstring

Unique ID of the batch.

created_atstring date-time

UTC timestamp from when the transaction was created.

Example response

{
  "id": "45bd0881-a79a-4054-9286-f11060d5511f",
  "status": "executed",
  "reference": "8880a72c-2675-482d-8d88-70a02c608592",
  "amount": {
    "value": 1000,
    "unit": "cents",
    "currency": "EUR"
  },
  "recipient_iban": "DE87110101001000057123",
  "recipient_name": "Max Mustermann",
  "recipient_bic": "SOBKDEB2XXX",
  "end_to_end_id": "END2ENDREJ",
  "batch_id": "d6c778822b2d7bd3b778935bcfd0d1d3csc",
  "created_at": "2021-01-01T20:37:50Z"
}