1. Partner Operations
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & History
        • Get Balances
        • Get Balance History
      • Crypto Deposits
        • Get Crypto Deposit Details
      • Crypto Withdrawal
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Currency Exchange
        • Get Rates
        • Create Lock
        • Create Exchange
        • Get Exchange Details
      • SEPA Deposit
        • Get SEPA Deposit Details
        • Get SEPA Deposit Info
      • SEPA Withdrawal
        • Create a SEPA Withdrawal
        • Get SEPA Withdrawal Details
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • Transaction Webhooks
        • Crypto Deposit Webhook
        • Crypto Withdrawal Webhook
        • Exchange Webhook
        • SEPA Deposit Webhook
        • SEPA Withdrawal Webhook
  • Reference
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. Partner Operations

SEPA Payouts

This module enables partners to withdraw Euro (EUR) funds from their balance to their own bank account via the SEPA network.

Key Principles#

Partner Withdrawals Only: Partners can withdraw funds exclusively to a bank account held in their own name.
Verification First: A bank account must be verified via an inbound deposit before it can be used for withdrawals.
Closed Loop Safety: This policy ensures funds cannot be sent to unauthorized third parties.

Core Endpoints#

Get Partner SEPA Info
Retrieve the Virtual IBAN and Reference needed for the partner to make a verification deposit.
Get Partner Contact List
Check which bank accounts are currently approved for withdrawals.
Create Partner SEPA Withdrawal
Initiate a withdrawal to a verified bank account.
Get Withdrawal Details
Track the status and outcome of a specific transfer.

Bank Account Verification (Mandatory)#

A partner cannot manually add a withdrawal IBAN. The system automatically captures and verifies bank details from incoming deposits.

Verification Flow#

1.
Display Deposit Data: Call Get Partner SEPA Info. Show the partner:
iban: Where to send money.
title (Reference): Crucial unique code for verification.
2.
Partner Action: The partner sends a small deposit (e.g. 1 EUR) from their bank account using the displayed details.
3.
Automatic Check:
The system compares the Sender Name on the bank transfer with the partner's Verified Name.
✅ Match: The funds are credited, and the sender's IBAN is added to the partner's Whitelist.
❌ Mismatch: The deposit is rejected and returned.
CRITICAL: Mandatory Payment Reference
The partner must include the title (Reference) exactly as-is in their bank transfer. Without this unique code, the system cannot automatically verify the partner's IBAN or credit the funds to their balance.

Withdrawal Logic#

Whitelist Only: Partners can only withdraw to IBANs present in their Contact List with an APPROVED status.
Beneficiary Data: You do not need to send the recipient name in the withdrawal request. The system automatically uses the verified details linked to the IBAN.
Asynchronous: Transfers are scheduled for processing after passing internal risk checks.

Typical Integration Workflow#

1.
Check Status: Call Get Partner Contact List.
2.
Empty List? Prompt the partner to make a verification deposit using details from Get Partner SEPA Info.
3.
Has Contacts? Allow the partner to select one of the verified IBANs.
4.
Execute: Call Create Partner SEPA Withdrawal with the selected destinationIban.
5.
Feedback: Monitor the transaction status via webhooks or Get Withdrawal Details.
Previous
Get Exchange Details
Next
Get SEPA Deposit Details
Built with