External Transfers
Show an external transfer
OAuth scope: organization.read
Get a single external transfer.
Attributes details
Initiator ID
ID of the membership that initiated the external transfer. <br>When the external transfer is initiated through the API, the initiator is the authenticated membership.
Debit
- debit_iban: Can be any of the organization's bank accounts. IBAN formatted ISO 13616.
- debit_amount: The amount that will be debited from your Qonto account.
- debit_amount_cents: The amount that will be debited from you Qonto account in an integer format.
- debit_currency: Must be EUR. ISO 4217 formatted.
Credit
- credit_amount: The amount that the beneficiary will receive.
- credit_amount_cents: The amount that the beneficiary will receive in an integer format.
- credit_currency: Equals debit currency if issued in the SEPA network (only supported currencies). ISO 4217 format. Allowed value for international transfers: AUD, CAD, CHF, CNY, CZK, DKK, GBP, HKD, HRK, HUF, ILS, JPY, NOK, NZD, PLN, RON, SEK, USD
FX rate
- rate_applied: Foreign exchange rate applied to your transaction, formatted with 4 digits after comma. Ex: 1,1082
Timestamps
Each external transfer contains three timestamps:
- created_at, UTC, the time at which the external transfer was first recorded.
- processed_at, UTC, when the external transfer has been started to be processed by Qonto.
- completed_at, UTC, when the external transfer is in its final state, either settled or declined.
- scheduled_date, YYYY-MM-DD, indicates when the external transfer was scheduled to be sent by Qonto.
Status
status can contain the following values
- pending: External transfer is created and has not been processed yet. If transfer is not processed within next minute, it means either execution date may not been reached yet or we are running some compliance checks on this transfer.
- processing: External transfer processing means account balance is debited and a transaction has been created. Processing status can last up to multiple hours until transfer is sent in the network to the beneficiary.
- canceled: When the external transfer is canceled by a user in the interface. This is a permanent status.
- declined: When the external transfer is declined by the screening service, fraud service or, once sent on the network, for many various reasons which are listed in those guidelines. This is a permanent status.
- settled: When the external transfer is sent to the network, transfer is settled. This is a permanent status.
get/v2/external_transfers/{id}
Path parameters
idstring required
Headers
X-Qonto-Staging-Tokenstring
Required only for Sandbox API requests; to get one, please submit the following form: https://getqonto.atlassian.net/servicedesk/customer/portal/5/group/47/create/143.
Response
returns an external transfer
Example response
{
"external_transfer": {
"debit_amount": "12.55",
"debit_amount_cents": "1255",
"debit_currency": "EUR",
"payment_purpose": "goods",
"declined_reason": "beneficiary_bic_invalid",
"status": "pending",
"scheduled_date": "2021-07-12",
"created_at": "2021-01-27T22:05:07.000Z",
"completed_at": "2021-01-27T22:05:07.000Z",
"processed_at": "2021-01-27T22:05:07.000Z"
}
}