Bags DocsSettlements & Payouts
Withdraw USDC earnings from your Bags balance to an external wallet.
After Bags collects USDC on your behalf, funds accumulate in your merchant balance. Payouts (settlements) move USDC from that balance to a wallet you control.
Balance breakdown
Your dashboard Payouts page shows:
| Line item | Description |
|---|---|
| Gross collected | Total customer payments before deductions |
| Platform fee (1.5%) | Bags MoR fee per transaction |
| Tax withheld | Tax Bags remits as Merchant of Record |
| Net to you | Amount available for withdrawal |
| Paid out | USDC already sent to your payout wallet |
Payout methods (v0)
| Method | Status | Notes |
|---|---|---|
| USDC → wallet | Live | Base, Polygon, Solana (and Ethereum when enabled) |
| USDC → bank (ACH, SEPA, IMPS) | Coming Q2 | Join the waitlist |
Fiat bank payouts are on the roadmap for Q2. Today, withdraw USDC to any wallet address you configure during onboarding.
Request a payout
Dashboard
- Go to Payouts.
- Review your Available balance.
- Click Withdraw now and confirm the destination wallet.
Payout schedule can be configured from the same page (Configure).
API
# Check balance
curl https://www.getbags.app/api/settlements/balance \
-H "Authorization: Bearer $BAG_API_KEY"
# Request a payout
curl -X POST https://www.getbags.app/api/settlements \
-H "Authorization: Bearer $BAG_API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 500.00}'Requires a live API key and completed KYB. Sandbox/test mode does not support real settlements.
Approval workflow
Settlement requests are not instant. Each payout moves through:
applied → approved → processing → completed| Status | What it means |
|---|---|
applied | Request submitted; amount reserved from withdrawable balance |
approved | Bags approved the withdrawal |
processing | On-chain transfer dispatched |
completed | USDC received at your payout wallet |
Rejected or failed requests release the reserved amount back to your available balance.
Settlement invoices
Bags issues consolidated settlement invoices for accounting. See Settlement Invoices for how MoR invoicing works.