Payments & escrow
Secure transactions with escrow protection and seller payouts
Overview
Current state
No in-app payments, transactions happen outside the platform.
Target state
- In-app checkout with Stripe
- Escrow protection for buyers
- Automated seller payouts
- Platform fees and revenue
Tech stack
- Payments: Stripe Connect
- Escrow: Stripe Payment Intents with manual capture
- Payouts: Stripe Connect Express/Standard
- Webhooks: Stripe webhook handlers
Flow
Purchase flow
Dispute flow
Architecture
Stripe Connect setup
Escrow payment
Release funds
Refund
Implementation
Stripe Connect
Set up Stripe Connect platform, seller onboarding flow, and KYC/verification handling.
Checkout
Build payment UI components, Payment Intent creation, and order confirmation.
Escrow
Implement manual capture flow, delivery confirmation, and fund release automation.
Disputes
Create dispute opening flow, admin resolution panel, and refund processing.
Pricing model
| Fee Type | Amount |
|---|---|
| Platform fee | 10% of sale |
| Stripe fee | 3.99% + R$0.39 |
| Seller receives | ~86% of sale |
Checklist
Infrastructure
- Stripe Connect account setup
- Webhook endpoint for events
- Transaction table in database
Seller onboarding
- Connect account creation
- Onboarding UI flow
- KYC status tracking
- Payout settings
Checkout
- Buy button and checkout modal
- Payment method selection
- Order confirmation page
- Email notifications
Escrow & disputes
- Delivery confirmation flow
- Auto-release after X days
- Dispute opening
- Admin resolution tools