Create multi transfer request

curl --request POST \
  --url https://thirdparty.qonto.com/v2/requests/multi_transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Qonto-Idempotency-Key: <x-qonto-idempotency-key>' \
  --data '
{
  "request_multi_transfer": {
    "note": "Salary of marketing departmenet. Please approve ASAP.",
    "transfers": [
      {
        "amount": "2000.50",
        "currency": "EUR",
        "credit_iban": "FR7630001007941234567890183",
        "credit_account_name": "URSSAF",
        "credit_account_currency": "EUR",
        "reference": "Invoice 2023-01",
        "attachment_ids": [
          "d840f1cb-6adb-48af-9f89-540dcf5ba741"
        ]
      }
    ],
    "scheduled_date": "2023-03-06",
    "debit_iban": "FR0807277000000000000000911"
  }
}
'

{
  "request_multi_transfer": {
    "id": "bb8f8d1d-5f12-486e-8f8e-90cc2af76038",
    "request_type": "multi_transfer",
    "status": "pending",
    "initiator_id": "6b1872e4-08e4-42ec-9c82-b441ec242a9b",
    "note": "Salary of marketing departmenet. Please approve ASAP",
    "total_transfers_amount": "2000.50",
    "total_transfers_amount_currency": "EUR",
    "total_transfers_count": 1,
    "created_at": "2023-02-16T17:33:38.215Z",
    "transfers": [
      {
        "id": "d840f1cb-6adb-48af-9f89-540dcf5ba741",
        "credit_account_name": "URSSAF",
        "amount": "2000.50",
        "currency": "EUR",
        "reference": "Invoice 2023-01"
      }
    ],
    "approver_id": "<string>",
    "declined_note": "<string>",
    "scheduled_date": "2023-03-06",
    "processed_at": "<string>"
  }
}

POST

requests

multi_transfers

Create multi transfer request

curl --request POST \
  --url https://thirdparty.qonto.com/v2/requests/multi_transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Qonto-Idempotency-Key: <x-qonto-idempotency-key>' \
  --data '
{
  "request_multi_transfer": {
    "note": "Salary of marketing departmenet. Please approve ASAP.",
    "transfers": [
      {
        "amount": "2000.50",
        "currency": "EUR",
        "credit_iban": "FR7630001007941234567890183",
        "credit_account_name": "URSSAF",
        "credit_account_currency": "EUR",
        "reference": "Invoice 2023-01",
        "attachment_ids": [
          "d840f1cb-6adb-48af-9f89-540dcf5ba741"
        ]
      }
    ],
    "scheduled_date": "2023-03-06",
    "debit_iban": "FR0807277000000000000000911"
  }
}
'

{
  "request_multi_transfer": {
    "id": "bb8f8d1d-5f12-486e-8f8e-90cc2af76038",
    "request_type": "multi_transfer",
    "status": "pending",
    "initiator_id": "6b1872e4-08e4-42ec-9c82-b441ec242a9b",
    "note": "Salary of marketing departmenet. Please approve ASAP",
    "total_transfers_amount": "2000.50",
    "total_transfers_amount_currency": "EUR",
    "total_transfers_count": 1,
    "created_at": "2023-02-16T17:33:38.215Z",
    "transfers": [
      {
        "id": "d840f1cb-6adb-48af-9f89-540dcf5ba741",
        "credit_account_name": "URSSAF",
        "amount": "2000.50",
        "currency": "EUR",
        "reference": "Invoice 2023-01"
      }
    ],
    "approver_id": "<string>",
    "declined_note": "<string>",
    "scheduled_date": "2023-03-06",
    "processed_at": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token

string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

X-Qonto-Idempotency-Key

string

required

Learn more in Idempotent Requests.

Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json

request_multi_transfer

object

required

Show child attributes

request_multi_transfer.note

string

required

Description of a nature of request. Helps approver to understand the reason of this request.

Example:

"Salary of marketing departmenet. Please approve ASAP."

request_multi_transfer.transfers

object[]

required

Required array length: 1 - 400 elements

Show child attributes

request_multi_transfer.transfers.amount

string

required

Should be decimal with 2 digits after coma, ex: "1", "1.99", "1.1"

Example:

"2000.50"

request_multi_transfer.transfers.currency

string

required

ISO 4217 formatted. Can be either the currency of the debit_iban or the currency of the beneficiary. Allowed values: EUR

Example:

"EUR"

request_multi_transfer.transfers.credit_iban

string

required

International beneficiary Bank Account Identifier (IBAN) of creditor. Must respect ISO 13616.

Example:

"FR7630001007941234567890183"

request_multi_transfer.transfers.credit_account_name

string

required

Free format for the name of the beneficiary. Limited to 140 chars.

Maximum string length: 140

Example:

"URSSAF"

request_multi_transfer.transfers.credit_account_currency

string

required

ISO 4217 formatted. Can be either the currency of the debit_iban or the currency of the beneficiary. Allowed values: EUR

Example:

"EUR"

request_multi_transfer.transfers.reference

string

required

Reference of a transfer. Limited to 140 chars.

Maximum string length: 140

Example:

"Invoice 2023-01"

request_multi_transfer.transfers.attachment_ids

string[]

Array of UUID that are linked to this transfer. Attachment must be uploaded thanks to a dedicated endpoints before the transfer to be done.

request_multi_transfer.scheduled_date

string<date>

default:Current date or next banking day

If the request is approved, the transfers will be executed on the scheduled_date (YYYY-MM-DD) at midnight (GMT).

Example:

"2023-03-06"

request_multi_transfer.debit_iban

string

International beneficiary Bank Account Identifier (IBAN) of debitor. Must respect ISO 13616.

Example:

"FR0807277000000000000000911"

Response

Returns the request created.

request_multi_transfer

object

required

Show child attributes

request_multi_transfer.id

string

required

Example:

"bb8f8d1d-5f12-486e-8f8e-90cc2af76038"

request_multi_transfer.request_type

string

required

Example:

"multi_transfer"

request_multi_transfer.status

string

required

Example:

"pending"

request_multi_transfer.initiator_id

string

required

ID of the membership that initiated the request.
When the request is initiated through the API, the initiator is the authenticated membership.

Example:

"6b1872e4-08e4-42ec-9c82-b441ec242a9b"

request_multi_transfer.note

string

required

Example:

"Salary of marketing departmenet. Please approve ASAP"

request_multi_transfer.total_transfers_amount

string

required

Example:

"2000.50"

request_multi_transfer.total_transfers_amount_currency

string

required

Example:

"EUR"

request_multi_transfer.total_transfers_count

integer<int32>

required

Example:

1

request_multi_transfer.created_at

string

required

Example:

"2023-02-16T17:33:38.215Z"

request_multi_transfer.transfers

object[]

required

Show child attributes

request_multi_transfer.transfers.id

string

required

Example:

"d840f1cb-6adb-48af-9f89-540dcf5ba741"

request_multi_transfer.transfers.credit_account_name

string

required

Example:

"URSSAF"

request_multi_transfer.transfers.amount

string

required

Example:

"2000.50"

request_multi_transfer.transfers.currency

string

required

Example:

"EUR"

request_multi_transfer.transfers.reference

string

required

Example:

"Invoice 2023-01"

request_multi_transfer.approver_id

string<nullable>

request_multi_transfer.declined_note

string<nullable>

request_multi_transfer.scheduled_date

string<date>

Example:

"2023-03-06"

request_multi_transfer.processed_at

string<nullable>

Create a virtual card request Approve a request

⌘I

Business API

Onboarding API

Create multi transfer request

Authorizations

Headers

Body

Response