Skip to main content
POST
/
v2
/
international
/
transfers
Create an international transfer
curl --request POST \
  --url https://thirdparty.qonto.com/v2/international/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Qonto-Idempotency-Key: <x-qonto-idempotency-key>' \
  --data '
{
  "beneficiary_id": "0196edb0-9b6e-7554-9864-d111285a0a44",
  "quote_id": "0196edb0-9b6e-7554-9864-d111285a0a43",
  "target_account_id": "123456",
  "details": {
    "reference": "Payment for invoice #123"
  },
  "source_amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "target_amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "bank_account_id": "0196edb0-9b6e-7554-9864-d111285a0a42",
  "attachment_ids": [
    "0196edb0-9b6e-7554-9864-d111285a0a40"
  ]
}
'
{
  "transfer": {
    "id": "0d6273cf-e4d0-469a-a3c8-d2196143470c",
    "beneficiary_id": "0196edb0-9b6e-7554-9864-d111285a0a44",
    "bank_account_id": "0196edb0-9b6e-7554-9864-d111285a0a42",
    "source_amount": {
      "currency": "EUR",
      "value": "100.00"
    },
    "target_amount": {
      "currency": "USD",
      "value": "110.00"
    },
    "status": "TRANSACTION_STATUS_PROCESSING"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.qonto.com/llms.txt

Use this file to discover all available pages before exploring further.

The details object for this endpoint is the same as the one used in the List Transfer requirements endpoint.
Quotes are only valid for a limited time, so it’s recommended to proceed with the transfer promptly after obtaining one. If the quote expires, the transfer will be created with a new generated quote; please note that the exchange rate and fees may differ.

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-2fa-Preference
enum<string>
default:paired-device

Learn more in Strong Customer Authentication.

Available options:
paired-device,
passkey,
mock,
sms-otp
​
X-Qonto-Idempotency-Key
string<uuid>
required

This endpoint requires an UUID as idempotency key. Learn more in Idempotent Requests.

Example:

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

​
X-Qonto-Sca-Session-Token
string

Learn more in Strong Customer Authentication.

​
X-Qonto-MFA
string

Learn more in the SMS OTP Flow.

​
X-Qonto-Staging-Token
string

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

Body

application/json
​
beneficiary_id
string<uuid>
required

The beneficiary unique identifier

Example:

"0196edb0-9b6e-7554-9864-d111285a0a44"

​
quote_id
string<uuid>
required

The quote unique identifier

Example:

"0196edb0-9b6e-7554-9864-d111285a0a43"

​
target_account_id
string
required

The target account unique identifier. Retrieved after the beneficiary is created or updated

Example:

"123456"

​
details
object
required

Transfer detail contains all the information needed to create a transfer. The data is dynamic and should be retrieved through the transfer requirements endpoint.

Example:
{ "reference": "Payment for invoice #123" }
​
source_amount
object
required
​
target_amount
object
required
​
bank_account_id
string<uuid>

The bank account unique identifier

Example:

"0196edb0-9b6e-7554-9864-d111285a0a42"

​
attachment_ids
string<uuid>[]

List of attachment IDs associated with the transaction

Example:
["0196edb0-9b6e-7554-9864-d111285a0a40"]

Response

Returns the created international transfer.

​
transfer
object