Partner API
  1. User Operations
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & Transaction History
        • Get Balances
        • Get Transaction History
        • Create Wallet
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • Get SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Orders
        • Get Rates
        • Retrieve Order Rate and Create a Lock
        • Create and Finalize an Order
        • Get Order Details
      • Payment link & Checkout Link
        • Generate Payment Link
        • Generate Hosted Checkout
        • Get Payment Link Details
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
        • Method A: Add KYC File
        • Method B: Creating KYC Verification
        • Method B: Redirect to Verification
        • Method B: Get KYC Status
        • Add User Verification
        • Add POA File
      • Account Management
        • Update Existing User
        • Delete User
        • Suspend User
        • Unsuspend User
      • Balances & Transaction History
        • Get User Balances
        • Get User Transaction History
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • SEPA Transfers
        • Get SEPA Deposit Info
        • GET SEPA Deposit Contact List
        • Create a SEPA Transfer
        • Get SEPA Transfer Details
      • Crypto Withdrawal
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • Crypto Deposits
        • Update Travel Rule
      • Internal Transfers
        • Create a Transfer
        • Get Transfer Details
      • Virtual Cards
        • Create Virtual Card
        • Get All User Cards
        • Get Card Details
        • Update Card PIN
        • Block Card
        • Unblock Card
        • Get Card Limits
        • Update Card Limits
        • Delete Card
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • Partner SEPA Transfer Webhook
        • User SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. User Operations

SEPA Payouts

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

Key Principles#

Personal Withdrawals: Users can only withdraw funds 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.
Safety: This "Closed Loop" policy ensures funds cannot be siphoned to unauthorized third parties.

Core Endpoints#

Get User SEPA Info
Retrieve the Virtual IBAN and Reference needed for the user to make a verification deposit.
Get User Contact List
Check which of the user's bank accounts are currently approved for withdrawals.
Create User SEPA Transfer
Initiate a withdrawal to a verified personal IBAN.
Get User Transfer Details
Track the status and outcome of a specific user transfer.

Bank Account Verification (Mandatory)#

To ensure security, a user cannot manually add a withdrawal IBAN. The system automatically captures and verifies bank details from incoming deposits.

The Verification Flow#

1.
Display Deposit Data: Call Get User SEPA Info. Show the user:
iban: Where to send money.
title (Reference): Crucial unique code for their account.
2.
User Action: The user logs into their banking app and sends a small deposit (e.g., 1 EUR) to the displayed details, including the Reference.
3.
Automatic Check:
The system compares the Sender Name on the bank transfer with the user's Verified KYC Name.
✅ Match: The funds are credited, and the sender's IBAN is added to the user's Whitelist.
❌ Mismatch: The deposit is rejected and returned.

Withdrawal Logic#

Whitelist Only: Users can only withdraw to IBANs present in their Contact List (status APPROVED).
Beneficiary Data: You do not need to send the user's 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 User Contact List.
2.
Empty List? Prompt the user to make a verification deposit using details from Get User SEPA Info.
3.
Has Contacts? Allow the user to select one of the verified IBANs.
4.
Execute: Call Create User SEPA Transfer with the selected destinationIban and externalUserId.
5.
Feedback: Monitor the transaction status via Webhooks or Get User Transfer Details.
Previous
Retrieve Detailed Exchange Information
Next
Get SEPA Deposit Info
Built with