1. SEPA Withdrawals
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Balances & History
      • Get Balances
      • Get Balance History
    • Crypto Deposits
      • Get Crypto Deposit Details
      • Add Travel Rule
    • Crypto Withdrawals
      • Get Whitelisted Wallets
      • Add Whitelisted Wallet
      • Delete Whitelisted Wallet
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
    • SEPA Deposits
      • Get SEPA Payment Details
      • Get SEPA Deposit Details
    • SEPA Withdrawals
      • Create SEPA Withdrawal
        POST
      • Get SEPA Withdrawal Details
        GET
    • Currency Exchange
      • Get Rates
      • Create Lock
      • Create Exchange
      • Get Exchange Details
  • Integration
    • Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • Crypto Deposit Webhook
      • Crypto Withdrawal Webhook
      • SEPA Deposit Webhook
      • SEPA Withdrawal Webhook
      • Exchange Webhook
  • Reference
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. SEPA Withdrawals

Create SEPA Withdrawal

Testing Env
http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com
Testing Env
http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com
POST
/v1/partner/sepa-withdrawal
Creates a SEPA withdrawal from the Partner's EUR balance to a bank account.

Amount and fee#

amount is the total amount debited from the balance, including the fee. The recipient receives amount - fee. The minimum amount and the fee are returned by Get Balances (withdrawal.minAmount, withdrawal.feeAmount).

Processing#

The request is validated immediately - if it is invalid, an error is returned and no withdrawal is created. The full amount is debited from the balance when the withdrawal is created.
Each SEPA withdrawal is currently reviewed manually by support before sending. A new withdrawal has status STARTED and then PENDING while it awaits the review. If the withdrawal is rejected, the full amount including the fee is returned to the balance. Track the status via Get SEPA Withdrawal Details, Get Balance History or webhooks.

Retries#

If the request times out or no response is received, do not retry it automatically - the withdrawal may have been created. Check Get Balance History or wait for the webhook first. Retrying without checking may result in a duplicate withdrawal.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/json

Examples

Responses

🟢201Created
application/json
Withdrawal created.
Bodyapplication/json

🟠401Access Denied
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com/v1/partner/sepa-withdrawal' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "balanceId": "ea93abc7-389d-4bd6-aeff-2257bfa72683",
    "amount": "10",
    "accountHolder": "Acme Corp",
    "iban": "DE89370400440532013000",
    "swift": "COBADEFFXXX",
    "bankName": "Commerzbank",
    "title": "Invoice 2026/10/015"
}'
Response Response Example
201 - Success
{
    "type": "WITHDRAWAL",
    "transactionId": "29d21864-3f9f-4d07-966e-4d40c2a24c21",
    "externalId": "8cb5745f-0e65-4323-891c-f1992423c982",
    "balanceId": "ea93abc7-389d-4bd6-aeff-2257bfa72683",
    "status": "STARTED",
    "amount": "9",
    "currency": "EUR",
    "accountHolder": "Acme Corp",
    "iban": "DE89370400440532013000",
    "swift": "COBADEFFXXX",
    "bankName": "Commerzbank",
    "title": "Invoice 2026/10/015",
    "fee": "1",
    "totalAmount": "10",
    "createdAt": "2026-10-08T12:57:54.839Z",
    "updatedAt": "2026-10-08T12:57:54.839Z"
}
Previous
SEPA Withdrawals
Next
Get SEPA Withdrawal Details
Built with