Getting Started with Implementing Payouts
Choose Your Payout Flow
Before implementing, determine which flow fits your use case:
| Flow Type | Source of Funds | Best For |
|---|---|---|
| Merchant Payout | Merchant’s balance | Platforms that manage user balances internally |
Advanced: Direct User Withdrawal
| Flow Type | Source of Funds | Best For |
|---|---|---|
| Direct User Withdrawal | User’s own balance | Platforms where users hold and withdraw their own balances |
Learn more: Understand Your Flow of Funds
Implementation Steps Overview
Once you’ve selected a withdrawal flow, follow these high-level steps:
1. User Verification (KYC/KYB)
All users must complete identity verification before their first payout. This ensures compliance and prevents fraud.
Options:
- Coinflow’s Prebuilt KYC Solution - Fastest integration
- KYC Attestation - Pass your existing KYC data
- Sumsub Token Sharing - Share Sumsub verification
Learn more: What is KYC?
2. Link Payout Destination
Users need to add their bank account or debit card to receive funds.
For bank payouts:
- Users authenticate their bank account via Plaid or your preferred provider
- Required for ACH, RTP, SEPA, UK Faster Payments
Learn how to implement Bank Authentication →
For card payouts:
- Users tokenize their debit card for instant push-to-card payouts
- Required to maintain PCI compliance
Learn how to implement Debit Card Tokenization →
3. Select Payout Speed
Choose the right speed for your users’ needs:
| Speed | Delivery Time | Supported Methods |
|---|---|---|
| Instant | Seconds | RTP, Push-to-Card, SEPA, UK Faster |
| Same Day | Within 24 business hours | Same-Day ACH |
| Standard | 2-3 business days | Standard ACH |
Learn more: Understanding Payout Speeds
4. Initiate Payout
Submit the payout request using your chosen implementation method:
Implementation Options:
- API Integration - Full control and customization
- Coinflow Withdraw Component - Pre-built UI component
5. Monitor Status
Track payout status via webhooks or API polling. You’ll receive real-time updates when payouts complete or encounter issues.
Key Concepts
Payout Destinations
Payout destinations are determined by the country selected during verification:
| Country | Supported Destinations | Default Currency |
|---|---|---|
| United States | US Bank Account, Debit Card | USD |
| European Union | European Bank Account | EUR |
| United Kingdom | UK Bank Account | GBP |
| Brazil | Brazilian Bank Account | BRL |
View all countries: Supported Countries & Currencies
Payout Currency
By default, currency matches the user’s verification country:
- US verification → USD payouts
- EU verification → EUR payouts
- UK verification → GBP payouts
In some scenarios, users can select alternative currencies based on their payout method.
Source of Funds
The account providing funds for the payout:
- Coinflow Balance - Managed by Coinflow
Advanced: Other Source-of-Funds Options
- Merchant BYO Source - Fund payouts from your own treasury account
- Direct User Withdrawal - Payouts originate from the user’s own balance
Next Steps
-
Choose your implementation method:
- API Integration - For custom implementations
- Coinflow Withdraw Component - For pre-built UI
-
Set up user identification:
Advanced: Direct User Withdrawal
-
Configure KYC verification:
-
Review payout scenarios: