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": "PROCESSING"
  }
}
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
required

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