How to Create a EUR Bank Transfer
EUR bank transfers send funds to a bank account in a SEPA country through the SEPA_CREDIT_TRANSFER rail.
You can create the transfer in a single request. There is no need to create the beneficiary or the bank account beforehand: when you submit the transfer with the account details and the beneficiary, the API creates the payout destination (the bank account) and its beneficiary for you. If the same account was used before, it is reused instead of duplicated.
There are two ways to create a EUR transfer:
- Option A — New transfer with the bank details and beneficiary in the same request
- Option B — Reuse a previously created payout destination with its
id
Read the Bank Transfers Overview first for authentication, the request format and the transfer lifecycle.
Endpoint
POST /payout/transfer
API Reference: Create a bank transfer
The request is multipart/form-data. The destination field is sent as a JSON-encoded string.
PDF attachments
PDF attachments are required for EUR transfers, for example the invoice that supports the payment.
- Format: PDF only
- Maximum 10 files per transfer
- Maximum 1 MB per file
Add one -F "files=@..." part per file.
Option A — New Destination in the Same Request
Pass the bank details and the beneficiary inside destination. The API validates them against the SEPA rail and creates the destination.
Required fields for this option:
| Field | Description |
|---|---|
currency | EUR |
amount | Amount in EUR |
files | One or more PDF documents |
destination.rail | SEPA_CREDIT_TRANSFER |
destination.country | ISO code of the destination bank country, e.g. DE |
destination.accountIdentifierValue | Full IBAN of the destination account |
destination.institution.swiftBic | SWIFT/BIC code of the bank |
destination.institution.name | Bank name |
destination.beneficiary.name | Beneficiary name or legal entity name |
destination.beneficiary.type | fisico (individual) or juridico (company) |
destination.beneficiary.taxId | Beneficiary tax identification number |
destination.beneficiary.address | Beneficiary address |
destination.beneficiary.country | ISO code of the beneficiary country |
Optional fields: destination.label to find the destination later, destination.institution.address, and destination.beneficiary.email.
The
countrymust be one of the SEPA countries supported by the rail. This includes countries outside the European Union such as the United Kingdom, Switzerland and Norway. Use Get the field requirements for payout destination rails to check the rail's requirements.
Request
curl -X POST "/api/v1/payout/transfer" \
-H "x-api-key: <your_api_key>" \
-H "Authorization: Bearer <token>" \
-F "currency=EUR" \
-F "amount=950.00" \
-F 'destination={"rail":"SEPA_CREDIT_TRANSFER","country":"DE","accountIdentifierValue":"DE89370400440532013000","label":"Acme GmbH - Deutsche Bank","institution":{"swiftBic":"DEUTDEDB","name":"Deutsche Bank"},"beneficiary":{"name":"Acme GmbH","type":"juridico","taxId":"DE123456789","address":"Unter den Linden 1, 10117 Berlin","country":"DE","email":"finance@acme.de"}}' \
-F "files=@invoice.pdf" \
-F "files=@invoice-2.pdf"
If an active destination with the same IBAN already exists but is linked to a different beneficiary, the request is rejected. If it is the same beneficiary, reuse the destination explicitly with its
id(Option B).
Option B — Existing Payout Destination
If a payout destination was created before, by a previous transfer or directly through the destinations API, reuse it by passing its id. No other destination fields are needed.
Find an existing European destination
curl -X GET "/api/v1/payout-destination?currency=EUR" \
-H "x-api-key: <your_api_key>" \
-H "Authorization: Bearer <token>"
This returns a paginated list of the active payout destinations of the authenticated user. Use the optional search parameter to look for a label or bank name, and use the id of the destination you want.
Request
curl -X POST "/api/v1/payout/transfer" \
-H "x-api-key: <your_api_key>" \
-H "Authorization: Bearer <token>" \
-F "currency=EUR" \
-F "amount=950.00" \
-F 'destination={"id":"d6c6c357-343f-4106-8f7d-b678c60ff10a"}' \
-F "files=@invoice.pdf"
Send either
idor the destination fields, never both.
Creating the destination or the beneficiary separately (optional)
If you prefer to build your list of saved bank accounts before sending money, for example to let your users pick one, you can create the pieces on their own:
Then send transfers with destination.id, as in Option B. This is a convenience, not a requirement.
Response (201) — All options
{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"type": "transfer",
"payoutNumber": "002095696342671878",
"status": "pending",
"currency": "EUR",
"amount": "950.00",
"amountInUSD": "1000.00",
"quote": "0.95",
"pdfDocuments": [
"https://files.example.com/invoice.pdf",
"https://files.example.com/invoice-2.pdf"
],
"destination": {
"id": "d6c6c357-343f-4106-8f7d-b678c60ff10a",
"label": "Acme GmbH - Deutsche Bank",
"rail": "SEPA_CREDIT_TRANSFER",
"country": "DE",
"currency": "EUR",
"accountIdentifierScheme": "IBAN",
"accountIdentifierValue": "DE89370400440532013000",
"institution": {
"swiftBic": "DEUTDEDB",
"name": "Deutsche Bank"
},
"beneficiary": {
"name": "Acme GmbH",
"taxId": {
"scheme": "OTHER",
"value": "DE123456789"
}
}
},
"createdAt": "2026-05-14T12:05:00.000Z",
"updatedAt": "2026-05-14T12:05:00.000Z"
}
destination is a snapshot of the destination taken when the transfer was created. Later edits to the destination don't change it.
Balance Impact
| Event | Effect on Balance |
|---|---|
| Transfer created | amountInUSD is immediately deducted from the user's available balance |
| Transfer rejected | Amount is automatically restored to the user's balance |
amountInUSD and quote are calculated by the API from the current EUR exchange rate when the transfer is created.