Qonto icon

Qonto

Consume Qonto API

Actions46

Internal Transaction → Create Internal Transfer

AI-generated

Overview

This node operation creates an internal transfer between two bank accounts within the Qonto system. It is useful for automating the process of transferring funds internally, ensuring idempotency to prevent duplicate transfers. For example, a business can use this to move funds between different accounts automatically as part of their financial workflows.

Use Case Examples

  1. Automate internal fund transfers between company accounts.
  2. Ensure safe and unique transfer requests using idempotency keys to avoid duplicate transactions.

Properties

Name Meaning
Authentication Method of authentication to use for the API request, either Login and Secret-Key or OAuth2.
Idempotency Key A unique string (recommended to be a UUID) that identifies the transfer to prevent accidental duplicate API calls.
Debit_iban The IBAN of the account from which the amount will be debited.
Credit_iban The IBAN of the account to which the amount will be credited.
Reference A reference string describing the transfer, up to 140 characters.
Amount The amount of money to transfer in the currency of the bank account.
Currency The currency of the transfer amount, should be EUR.

Output

JSON

  • internal_transfer
    • id - The unique identifier of the created internal transfer.
    • debit_iban - The IBAN from which the amount was debited.
    • credit_iban - The IBAN to which the amount was credited.
    • reference - The reference text describing the transfer.
    • amount - The amount transferred.
    • currency - The currency of the transfer.
    • status - The status of the internal transfer (e.g., pending, completed).

Dependencies

  • Qonto API access with either Login and Secret-Key or OAuth2 authentication credentials.

Troubleshooting

  • Ensure the Idempotency Key is unique for each transfer to avoid duplicate transaction errors.
  • Verify that the debit and credit IBANs are valid and belong to accounts within the organization.
  • Check that the amount is a valid number and the currency is set to EUR as required by the API.
  • Authentication errors may occur if credentials are incorrect or expired; verify and refresh credentials as needed.

Links

Discussion