Withdraw / Payout Implementaiton
Getting Started with Implementing Payouts
This guide outlines the core concepts required to implement payout flows supported through Rapid. Before integrating withdrawals, developers should work with stakeholders to determine the right payout flow for your use case and configure each required step accordingly.
🧭 Choosing a Payout Flow
Before implementing payouts, determine which flow fits your use case:
| Flow Type | Source of Funds | Who Owns Wallet? | Common Use Case |
|---|---|---|---|
| Merchant Payout | Merchant’s Wallet Balance | Merchant | Platforms managing user balances or paying their users. |
| User Custodial Payout | Withdrawer's Wallet Balance | End User (Withdrawer) | Users cashing out their own tokens. |
🔗 Learn more about Rapid's supported payout flows
🔄 Overview of a Payout Flow
After selecting a flow and completing setup, follow these steps:
-
KYC/KYB Verification
Create a withdrawer. This ensures legitimacy before allowing withdrawals. -
Tokenize or Authenticate Payout Details
- Bank Account: Authenticate for bank payouts
- Debit Card: Tokenize for push-to-card payouts
-
Add Payout Destination
Save the authenticated/tokenized bank or card to the user's profile. -
Select Payout Speed
Set the desiredspeedparameter based on destination and country. -
Initiate & Confirm Payout
Trigger the payout and handle response or webhook for success/failure.
🔐 Payout Concepts
✅ KYC or KYB Verification
Withdrawers must pass identity verification before withdrawals. Supported methods:
- Rapid's Built In Verification
- Passing External KYC Data to Rapid
- Sumsub Token Sharing
💳 Debit Card Tokenization & Bank Authentication
💳 Debit Card Tokenization
Tokenization Guide →
Merchants offering push-to-card payouts must tokenize card data to stay PCI compliant. This protects sensitive information by replacing it with a secure token.
🏦 Bank Authentication
Bank Auth Guide →
Required for AML compliance. Ensures the verified user owns the bank account. You can use:
- Rapid's built-in solution
- Your own bank auth provider
📍 Payout Destination
Withdrawers can only select payout methods supported in the country listed during verification.
| Country | Allowed Payout 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 |
💱 Payout Currency
Currency defaults to the country selected during verification. Changing currency is only allowed in specific scenarios.
🚀 Payout Speeds
Payout methods support different speeds and fees:
- Fees are hardcoded in sandbox mode for testing.
- Confirm with stakeholders what fees apply under your MSA before production deployment.
Updated 4 months ago