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/sepa-withdrawal
Creates a SEPA withdrawal from the Partner's EUR balance to a bank account.
CAUTION
SEPA withdrawals can only be sent to a bank account held by the Partner. accountHolder must match the Partner's name. Withdrawals to accounts of other persons or companies are rejected (REJECTED-BY-REVIEWER) and the funds are returned to the balance.

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, and the response contains the transactionId of the withdrawal.
Each SEPA withdrawal is reviewed before sending:
1.
WAITING-FOR-VERIFICATION - the withdrawal is under review.
2.
QUESTIONED - additional information is required. We contact you by email.
3.
WAITING-TO-BE-SENT - the withdrawal is approved and queued for sending to the bank.
4.
SUCCESSFUL - the transfer is sent.
If the withdrawal is rejected, it gets status REJECTED-BY-REVIEWER, the reason is sent by email and 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/jsonRequired

Examples

Responses

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

🟠400P4007: Validation Error
🟠400P4103: Insufficient Funds
🟠400P4104: Amount Below Minimum
🟠400P4105: Amount Precision Exceeded
🟠401P4001: Missing API Key
🟠401P4002: Invalid API Key
🟠403P4003: IP Not Allowed
🟠403P4004: Access Denied
🟠404P4101: Balance Not Found
🔴500P5000: Unknown Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com/v1/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",
    "bic": "COBADEFFXXX",
    "bankName": "Commerzbank",
    "title": "Invoice 2026/10/015"
}'
Response Response Example
201 - Success
{
    "transactionId": "30107ece-fe40-47f3-9c45-7925e5ca1851"
}
Previous
SEPA Withdrawals
Next
Get SEPA Withdrawal Details
Built with