PayoutsImplementation Methods

Getting Started with Implementing Payouts

This guide outlines the core concepts required to implement payout flows supported through Coinflow. Before integrating withdrawals, developers should work with stakeholders to determine the right payout flow for your use case and configure each required step accordingly.

Choose Your Payout Flow

Before implementing, determine which flow fits your use case:

Flow TypeSource of FundsWho Owns Wallet?Best For
Merchant PayoutMerchant’s Wallet BalanceMerchantPlatforms that manage user balances internally
User Self-Custodial PayoutUser’s Wallet BalanceEnd UserUsers cashing out their own crypto tokens

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:

Learn more: What is KYC?

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:

SpeedDelivery TimeSupported Methods
InstantSecondsRTP, Push-to-Card, SEPA, UK Faster
Same DayWithin 24 business hoursSame-Day ACH
Standard2-3 business daysStandard ACH

Learn more: Understanding Payout Speeds

4. Initiate Payout

Submit the payout request using your chosen implementation method:

Implementation Options:

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:

CountrySupported DestinationsDefault Currency
United StatesUS Bank Account, Debit CardUSD
European UnionEuropean Bank AccountEUR
United KingdomUK Bank AccountGBP
BrazilBrazilian Bank AccountBRL

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 wallet providing funds for the payout:

Next Steps

  1. Choose your implementation method:

  2. Set up user identification:

  3. Configure KYC verification:

  4. Review payout scenarios: