Exit
Pay a recipient outside SEPA with EUR funds (beta, provisional, sandbox only)
ProvisionalExit is not a settled product. The fields and rules on this page are a draft and may change before the feature is available.
Beta — sandbox onlyCross-border exit is a beta feature available only in the sandbox environment. Payments are simulated: no real funds are moved and no international bank is contacted.
The feature is not enabled by default. To request access, contact us.
What it is and when to use it
Exit lets you pay, from euros held at Devengo, a recipient whose bank account is outside the SEPA area.
Use Exit when money held in euros in Europe has to reach a bank account outside SEPA, for example in the United Arab Emirates or Brazil. A typical case is a company in Spain paying an invoice to a supplier abroad.
| Party | Role |
|---|---|
| Sender | The person or company that orders the payment. |
| You | Devengo's customer. You fund the payment from your Devengo account. |
| Devengo | Debits your account and delivers the funds to the recipient's bank outside SEPA. |
| Recipient | The person or company receiving the funds outside SEPA. |
As with Entry, you and the sender can be different parties. Each payment always carries the details of the person who really orders it.
How it works
- You send Devengo the instruction: the EUR amount, the recipient's account outside SEPA and who orders the payment.
- Devengo debits the amount from your Devengo account and delivers the funds to the recipient's bank.
- You are notified as the payment progresses. A
confirmedpayment means delivery to the recipient's bank is complete.
In the sandbox, step 2 is simulated: no real funds move and no international bank is contacted.
Statuses, webhooks and how to read a payment match Entry. These payments do not appear in GET /v1/payments. Use direction to tell entry and exit apart.
What you need to provide
| Information | What it is | Required |
|---|---|---|
amount | The amount to pay, always in euros. | Yes |
recipient and destination | Name and IBAN of the recipient, in a country outside SEPA. | Yes |
description | Text that accompanies the payment. | Yes |
sender | Name, city and country, and the account of who orders the payment. | Yes |
The sender's address has two fields, city and country. Both are required. The example uses account_number as id_scheme. iban is also accepted.
Unlike Entry, Exit does not ask for a UETR or for the sender's bank BIC. In this preview, destination must be an IBAN of a country outside SEPA. SEPA IBANs are not accepted. Support for other destination formats is planned for a later version.
Example
In practice, step 1 is a single API call. company_reference is optional. This request shows the information it carries:
{
"account_id": "acc_8AnWmtBGh0ZeBzjM3nYqRS",
"company_reference": "123",
"description": "Invoice 2026-118",
"recipient": "Jane Doe",
"destination": { "type": "iban", "iban": "AE080260001015555555551" },
"amount": { "cents": 10000, "currency": "EUR" },
"sender": {
"name": "Example Customer Ltd",
"address": { "city": "Madrid", "country": "es" },
"account": { "id_scheme": "account_number", "id": "ACCOUNT-9981", "issuer": "ACMEPAY" }
}
}In plain words: pay 100.00 EUR from your Devengo account to Jane Doe's account in the United Arab Emirates, for invoice 2026-118, on behalf of Example Customer Ltd in Madrid. The full request is in Create cross-border exit payment.
Scope and getting access
This preview lets you try the full Exit flow in the sandbox, paying in euros to IBANs outside SEPA. The endpoint is available from API version 202611.
In production the endpoint returns 404. Without the product, it returns 403 with code product_not_active.
The destination IBAN decides the simulated result. Exit does not use the Spanish test IBANs. The reserved values are listed in Sandbox → Test Data. Any other valid non-SEPA IBAN results in confirmed.
Not included yet:
- Use in production.
- Currency conversion: payments are always in euros.
- Paying saved counterparties (
counterparty_id) or using Verification of Payee (vop_id). - A return after confirmation (
reversed), payment previews, payment receipts and automatic retries.
To request sandbox access, contact us. To deliver into SEPA a payment that started outside it, see Entry.
Updated about 12 hours ago