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",
  "bank_account_id": "0196edb0-9b6e-7554-9864-d111285a0a42",
  "quote_id": "0196edb0-9b6e-7554-9864-d111285a0a43",
  "target_account_id": "123456",
  "attachment_ids": [
    "0196edb0-9b6e-7554-9864-d111285a0a40"
  ],
  "details": {
    "reference": "Payment for invoice #123"
  },
  "source_amount": {
    "currency": "EUR",
    "value": "100.00"
  },
  "target_amount": {
    "currency": "EUR",
    "value": "100.00"
  }
}'
{
  "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-Staging-Token
string

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

​
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.

Body

application/json

Response

200
application/json

Returns the created international transfer.

The response is of type object.