Actions45
- Attachment Actions
- Beneficiary Actions
- Business Account Actions
- Card Actions
- Client Actions
- Client Invoice Actions
- Credit Note Actions
- External Transfer Actions
- Insurance Contract Actions
- Internal Transfer Actions
- Label Actions
- Membership Actions
- Organization Actions
- Quote Actions
- Request Actions
- SEPA Transfer Actions
- Statement Actions
- Supplier Invoice Actions
- Team Actions
- Transaction Actions
Overview
The node interacts with the Qonto API to retrieve multiple external transfer records. It is designed to fetch a list of external transfers based on various filtering criteria and pagination options. This node is useful for financial operations where users need to monitor, audit, or process batches of external transfers from their Qonto account.
Practical examples include:
- Retrieving all pending external transfers for reconciliation.
- Fetching external transfers within a specific date range for reporting.
- Paginating through external transfers when dealing with large datasets.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authentication; currently supports "API Key". |
| Return All | Whether to return all matching results or limit the output to a specified number. |
| Limit | Maximum number of results to return if not returning all (default 100, max 100). |
| Page | Page number to retrieve when limiting results (starts at 1). |
| Filters | Collection of filters to narrow down results: |
| - Status | Filter by transfer status; options: Pending, Processing, Canceled, Declined, Settled. |
| - Beneficiary IDs | Comma-separated list of beneficiary IDs to filter transfers by specific beneficiaries. |
| - Updated From | Minimum update timestamp to filter transfers updated after this date/time. |
| - Updated To | Maximum update timestamp to filter transfers updated before this date/time. |
| - Scheduled Date From | Minimum scheduled date to filter transfers scheduled after this date/time. |
| - Scheduled Date To | Maximum scheduled date to filter transfers scheduled before this date/time. |
Output
The node outputs an array of JSON objects representing external transfer records retrieved from the Qonto API. Each object contains details about an individual external transfer, such as its status, beneficiary information, timestamps, and other relevant metadata.
If binary data were involved (not indicated here), it would typically represent attachments or documents related to transfers, but this node focuses on JSON data output.
Dependencies
- Requires an API key credential for authenticating requests to the Qonto API.
- The node uses the Qonto API endpoints, switching between sandbox and production environments based on configuration.
- No additional external dependencies are indicated beyond the Qonto API access.
Troubleshooting
Common Issues:
- Invalid or missing API key will cause authentication failures.
- Request limits exceeded if too many calls are made in a short time.
- Incorrect filter formats (e.g., malformed dates or beneficiary ID lists) may result in empty responses or errors.
- Pagination parameters out of range (e.g., page < 1 or limit > 100) will be rejected.
Error Messages:
"Unknown resource: externalTransfer": Occurs if the resource parameter is misspelled or unsupported.- API authentication errors: Check that the API key is correctly configured and has necessary permissions.
- Validation errors on filters: Ensure date formats and beneficiary IDs are correct and properly formatted.