Qonto

Consume Qonto API

Actions46

Attachment Actions
- Upload Attachment
- Show Attachment
Attachments in a Transaction Actions
Beneficiary Actions
Card Actions
Client Actions
Client Invoice Actions
Credit Note Actions
- Get a List of Credit Notes for an Organization
- Get Details of Credit Note for an Organization
External Transfer Actions
Insurance Contract Actions
Internal Transaction Actions
- Create Internal Transfer
Label Actions
- List Labels
- Show Label
Membership Actions
Organization Actions
- Get Organization and Its Bank_accounts
Request Actions
Statement Actions
- Show Statement
- List Statements
Supplier Invoice Actions
- Get a List of Supplier Invoices for an Organization
- Create Supplier Invoices with Attachments
Team Actions
- List Teams in an Organization
- Create a New Team
Transaction Actions
- List Transactions
- Retrieve a Transaction

External Transfer → Create an External Transfer

AI-generated

Overview

This node operation creates an external transfer using the Qonto API. It is useful for automating bank transfers to external beneficiaries, such as paying suppliers or transferring funds to other accounts. The node requires details like beneficiary ID, debit IBAN, transfer reference, amount, currency, and optionally a note, scheduled date, and attachments. It ensures idempotency by using a unique idempotency key to prevent duplicate transfers.

Use Case Examples

Automate payments to suppliers by creating external transfers with predefined beneficiary and account details.
Schedule future payments by setting a scheduled date for the external transfer.
Attach supporting documents to the transfer for record-keeping and compliance.

Properties

Name	Meaning
Authentication	Method of authentication to use for the API call, either Login and Secret-Key or OAuth2.
Idempotency Key	A unique string (recommended to use a UUID) that identifies the transfer to prevent duplicate transactions by avoiding replaying the same API call.
Beneficiary ID	The identifier of the beneficiary to whom the transfer will be made, typically the IBAN of the account to debit.
Debit IBAN	The IBAN of the account from which the amount will be debited.
Reference	A reference string describing the transfer, up to 140 characters.
Note	An optional note to add additional information about the transfer.
Currency	The currency of the transfer amount, should be EUR.
Scheduled Date	The date when the external transfer is scheduled to be sent, formatted as YYYY-MM-DD.
Amount	The amount of money to transfer in the specified currency.
Attachment IDs	An array of attachments to add to the transfer, specified as binary properties containing the data to be attached.

Output

JSON

external_transfer
- id - The unique identifier of the created external transfer.
- status - The status of the external transfer (e.g., pending, completed).
- amount - The amount of the transfer.
- currency - The currency of the transfer.
- scheduled_date - The scheduled date for the transfer to be sent.
- beneficiary_id - The beneficiary ID associated with the transfer.
- debit_iban - The IBAN of the account debited for the transfer.
- reference - The reference string describing the transfer.
- note - Any additional note attached to the transfer.
- attachment_ids - IDs of attachments added to the transfer.

Dependencies

Qonto API
API authentication credentials (Login and Secret-Key or OAuth2)

Troubleshooting

Ensure the idempotency key is unique for each transfer to avoid duplicate transaction errors.
Verify that the beneficiary ID and debit IBAN are correct and valid to prevent transfer failures.
Check that the currency is set to EUR as required by the API.
If attachments are included, ensure the binary data properties are correctly specified and contain valid data.
Common error messages may include authentication failures, invalid parameters, or duplicate transfer attempts due to idempotency key reuse. Verify credentials and input data accordingly.

QontoInstall