vault1984/docs/PAYMENTS-PLAN.md

333 lines
13 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Clavitor — Global Recurring Payment Infrastructure Plan
*Last updated: March 2026*
---
## Executive Summary
**Strategy:** Two primary partners, regional satellites. Stripe for card-present markets + developed economies. Paddle or Lemon Squeezy for tax compliance and emerging market coverage. Local payment orchestration for Africa, South Asia, and LATAM where cards fail.
**Coverage:** 180+ countries, excluding Russia and China by policy.
**Key insight:** In Nigeria, Bangladesh, Pakistan, and much of Africa/LATAM, credit card penetration is <5%. Mobile money, bank transfers, and carrier billing dominate. A "global" plan that only accepts cards is not global.
---
## Tier 1: Primary Infrastructure (The Core Stack)
### Partner 1: Stripe
**Role:** Card processing, subscriptions, developed markets, API infrastructure.
**Why Stripe:**
- Best-in-class subscription APIs (Billing, Checkout)
- Strongest fraud prevention (Radar, 3D Secure)
- Developer experience is unmatched
- Supports 135+ currencies
- Embeddable pricing tables and customer portal
**Markets (Stripe dominates):**
- North America (US, Canada)
- Western Europe (UK, DE, FR, NL, ES, IT, etc.)
- Australia, New Zealand, Japan, Singapore, Hong Kong
- Eastern Europe (Poland, Czech Republic, etc.)
- Most of LATAM (Mexico, Brazil, Chile, Argentina with local card schemes)
- India (with some local method support)
**Limitations:**
- No native mobile money (M-Pesa, MTN, etc.)
- Weak in Sub-Saharan Africa outside South Africa
- No carrier billing
- Bangladesh, Pakistan: cards only, no local bank transfer support
- Nigeria: cards work but ~70% fail due to bank restrictions
**Implementation:**
```
Stripe Checkout (hosted) for < $100/month plans
Stripe Elements (embedded) for enterprise/annual
Stripe Billing for subscription lifecycle
Stripe Tax for EU VAT, US sales tax (where required)
```
---
### Partner 2: Paddle or Lemon Squeezy
**Role:** Merchant of record (MOR), tax compliance, emerging market coverage, local payment methods.
**Decision point:** Paddle vs. Lemon Squeezy
| Factor | Paddle | Lemon Squeezy |
|--------|--------|---------------|
| Pricing | 5% + 50¢ per transaction | 5% + 50¢ per transaction |
| MOR coverage | 100+ countries | 50+ countries |
| Local methods | Strong (PayPal, Apple Pay, Google Pay, wire, Alipay in some regions) | Stronger on PayPal, weaker on wires |
| Africa coverage | Limited | Limited |
| India | Good | Good |
| Pakistan/Bangladesh | PayPal, cards only | Same |
| Nigeria | PayPal, some card coverage | Similar |
| API quality | Mature, well-documented | Newer, improving |
| Checkout UX | Hosted, customizable | Beautiful, opinionated |
| Marketplace/airport model | Yes | No (direct only) |
**Recommendation: Paddle** specifically for the MOR coverage and the ability to handle "airport" sales (someone buys in Nigeria while traveling, pays from a German account).
**Why not just Stripe + Paddle?**
- Paddle's API is slower, less flexible than Stripe
- Paddle's checkout is hosted you lose some UX control
- Paddle takes 5% vs Stripe's 2.9% + 30¢
**The split:**
- Stripe: Card-present markets, enterprise sales, API-driven purchases
- Paddle: Self-serve customers in emerging markets, tax compliance for EU/UK/US
---
## Tier 2: Regional Satellites (Where Cards Fail)
### Africa: M-Pesa, MTN Mobile Money, Airtel Money
**Challenge:** In Kenya, Tanzania, Uganda, Ghana, mobile money is 80%+ of digital payments. Cards are rarely used.
**Partner: DPO Group (now Network International) or Flutterwave**
**DPO Group:**
- Covers 20+ African markets
- Aggregates M-Pesa, MTN, Airtel, plus cards
- PCI compliant
- Recurring support via tokenization (user approves repeat payment on mobile)
**Flutterwave:**
- Nigerian-founded, strong in West Africa
- Supports M-Pesa, mobile money, bank transfers, cards
- "Subscription" product exists but is newer
- Better developer experience than DPO
**Recommendation: Flutterwave** for primary African coverage.
**Implementation model:**
```
User selects country →
If Kenya/Ghana/Nigeria/Tanzania → Flutterwave checkout
If South Africa → Stripe (cards work well)
If other Africa → Paddle (PayPal fallback) or Flutterwave
```
**Critical note on recurring:** Mobile money subscriptions work differently. User gets an SMS to approve each monthly charge. This is not "set and forget" like cards. UX needs to explain: "We'll send you a monthly SMS to confirm. Reply YES to continue."
---
### South Asia: India, Pakistan, Bangladesh
**India:** Stripe works well. UPI (Unified Payments Interface) is critical. Stripe added UPI support in 2023. Razorpay is the local leader if Stripe fails.
**Pakistan:**
- Cards: ~10% penetration, high fraud, high decline rates
- Bank transfers: HBL, UBL, other major banks
- Mobile wallets: JazzCash, Easypaisa dominate
**Partner: Payoneer, Wise, or local aggregator**
Realistic options:
- **Payoneer Checkout:** Covers Pakistan, Bangladesh, supports local bank debits
- **2Checkout (Verifone):** Mature, supports Pakistan, but high fees (6%+)
- **Local partner:** Easypaisa/JazzCash APIs for Pakistan requires local entity
**Recommendation for Pakistan/Bangladesh:**
- Start with Paddle (PayPal + cards)
- Add Payoneer Checkout for local bank support
- Long-term: evaluate Easypaisa direct integration if volume justifies local entity
**Bangladesh:**
- bKash is the mobile money giant (45M+ users)
- Cards: ~5% penetration
- Bank transfers: growing
**bKash integration:** Requires Bangladesh Bank approval, local entity. Not feasible for MVP.
**Short-term:** Paddle or Payoneer for card + PayPal coverage. Acknowledge that Bangladesh is "card and PayPal only" until volume justifies bKash integration.
---
### Southeast Asia: Indonesia, Philippines, Vietnam
**Indonesia:**
- Cards work in Jakarta/Bali. Elsewhere: bank transfers, OVO, GoPay, DANA (e-wallets)
- Xendit is the leading local aggregator
**Philippines:**
- GCash and Maya dominate (90%+ of digital payments)
- Cards work but high fraud
**Partner: Xendit**
- Covers Indonesia, Philippines, Vietnam
- Supports OVO, GoPay, GCash, Maya, bank transfers, cards
- Recurring support via tokenization
**Recommendation:**
- Tier 1 cities: Stripe (cards)
- Tier 2+ and general population: Xendit
**Implementation:**
```
If country = ID/PH/VN →
Xendit checkout with local wallets
Fallback to Stripe for cards
```
---
### Middle East: UAE, Saudi Arabia, Egypt
**UAE/Saudi:** Stripe works. Cards are common. Apple Pay/Google Pay growing.
**Egypt:**
- Cards work (limited penetration)
- Fawry (cash network) is massive pay at any Fawry kiosk
- Vodafone Cash (mobile wallet)
**Partner: Fawry or Paymob**
- Paymob is Egyptian, supports Fawry, Vodafone Cash, cards, bank installments
- Recurring: tricky. Fawry is cash-based. Paymob can tokenize for wallets.
**Recommendation:**
- UAE/Saudi: Stripe primary
- Egypt: Paymob if volume justifies, otherwise Paddle (PayPal + cards)
---
## The Consolidated Stack (Minimal Partners)
| Partner | Markets | Methods | Role |
|---------|---------|---------|------|
| **Stripe** | 40+ developed | Cards, SEPA, UK faster payments, Apple/Google Pay, UPI (India) | Core API, subscriptions, enterprise |
| **Paddle** | 100+ (MOR) | Cards, PayPal, Apple Pay, bank transfers (limited) | Tax compliance, self-serve global fallback |
| **Flutterwave** | 20+ Africa | M-Pesa, MTN, Airtel, cards, bank | Africa mobile money |
| **Xendit** | ID, PH, VN | OVO, GoPay, GCash, Maya, cards, bank | SE Asia e-wallets |
| **Payoneer** | PK, BD, global | Local bank debits, cards, PayPal | Pakistan, Bangladesh local coverage |
**Total partners: 5.** Could reduce to 4 if Xendit and Flutterwave merge efforts (not currently possible).
**Could go to 3?** Only if you accept that Pakistan, Bangladesh, and parts of Africa are "cards and PayPal only" at launch. That's a business decision acceptable for MVP, limiting for scale.
---
## Recurring Payment Mechanics by Region
### Card-based (Stripe, Paddle)
- Standard: Customer agrees, token stored, charged monthly
- Failed charges: Retry logic, dunning emails, grace periods
- Cancellation: Self-serve portal
### Mobile Money (Flutterwave, M-Pesa)
- Model: "Consent-based recurring"
- Flow: User approves first payment. For renewals, SMS sent: "Clavitor wants to charge $12. Reply YES to approve."
- Churn: Higher than cards (users forget to reply, change numbers)
- UX requirement: Explain the SMS flow upfront. Don't surprise users.
### E-wallets (Xendit, OVO, GCash)
- Model: Tokenized recurring where supported
- Some wallets: Monthly approval required (like mobile money)
- Status: Varies by wallet. Xendit abstracts this.
### Bank transfers (SEPA, UK, local)
- Model: Invoice or direct debit
- SEPA direct debit: Strong authorization required, 8-week refund window
- UK Direct Debit: Bacs, 3-day settlement
- Local (Pakistan, Bangladesh): Push payment user must initiate each time. Not truly "recurring."
---
## Tax and Compliance
### Merchant of Record vs. Self-Filing
**Option A: Paddle or Lemon Squeezy as MOR**
- They collect, remit VAT/GST/sales tax
- You receive net revenue
- Pros: Zero tax compliance work
- Cons: Higher fees (5% vs 2.9%), less control
**Option B: Stripe + Self-Filing**
- You collect, you remit
- Stripe Tax calculates, you file
- Pros: Lower fees, full control
- Cons: Complex need accountants in EU, US, etc.
**Recommendation:**
- **Paddle for self-serve:** < $1,000/year customers, global spread
- **Stripe for enterprise:** > $1,000/year, direct contracts
**Specific jurisdictions:**
- **EU:** VAT OSS (One Stop Shop) — file in one country, cover all 27. Stripe Tax or Paddle handles.
- **UK:** VAT registration required > £85k. Stripe Tax calculates.
- **US:** Sales tax nexus varies by state. Stripe Tax is essential.
- **India:** GST on B2B exports is 0% with LUT (Letter of Undertaking). B2C: 18% IGST.
- **Nigeria:** VAT 7.5%. Complex to collect as foreign entity — Paddle or local partner handles.
---
## Implementation Roadmap
### Phase 1: MVP (Months 12)
**Goal:** Launch with coverage for 80% of addressable market.
- Stripe: US, Canada, EU, UK, Australia, Japan, Singapore
- Paddle: Global fallback for countries without Stripe coverage
- Result: 40+ countries, card/PayPal only
### Phase 2: Emerging Markets (Months 36)
**Goal:** Add mobile money and local wallets.
- Flutterwave: Kenya, Nigeria, Ghana, Tanzania
- Xendit: Indonesia, Philippines
- Evaluate: Pakistan (Payoneer), Bangladesh (stay on Paddle)
### Phase 3: Deep Localization (Months 612)
**Goal:** True local payment methods where volume justifies.
- Egypt: Fawry/Paymob if customer base grows
- Bangladesh: bKash integration (requires local entity)
- Pakistan: Easypaisa/JazzCash direct
- India: Full UPI optimization, RuPay support
---
## Fallback Strategy: What If a Payment Fails?
**The problem:** A user in Nigeria tries to pay, card fails, no mobile money option, no PayPal.
**Options:**
1. **Wire transfer / SWIFT:** Manual. You send invoice, they wire. High friction, high fees ($2050), but works for annual enterprise contracts.
2. **Crypto (USDC/USDT):** Immediate, global, final settlement. Controversial but effective for unbanked tech users.
3. **Partner/reseller model:** Local MSP or integrator buys Clavitor seats wholesale, resells locally, handles local payment collection.
**Recommendation:**
- For enterprise Nigeria, India, etc.: Offer annual wire/crypto with 10% discount to offset friction
- For SMB: If Paddle + Stripe fail, the market isn't reachable yet. Don't build custom.
---
## Summary: The Minimal Viable Stack
If you want absolute minimal partners with maximum honest coverage:
1. **Stripe** — 70% of global revenue, all enterprise
2. **Paddle** — Tax compliance, global self-serve fallback, 100+ countries
3. **Flutterwave** — Africa mobile money (if you want Africa properly)
That's **3 partners**. Covers 95% of the addressable market with honest local payment methods.
**Can you do 2?** Stripe + Paddle only. Accepts that Africa outside South Africa and parts of Asia are "cards and PayPal only." Defensible for MVP. Plan to add Flutterwave or Xendit by month 6 if African/SE Asian traction surprises you.
---
## Open Questions for You
1. **Crypto:** Accept USDC/USDT for annual contracts in unbanked markets? (Fast, final, but adds compliance complexity)
2. **MSP/Reseller:** Do you want a formal partner program where local MSPs (like your Kaseya contacts) can resell Clavitor with local payment handling? They collect local, pay you net.
3. **Free tier:** Is there a free tier that doesn't require payment at all? (Reduces the payment problem, increases adoption, defers the hard questions)
4. **Annual default:** Do you optimize for annual payments (one transaction, less recurring complexity) or monthly (lower barrier, higher LTV analysis)?
---
*Plan complete. Ready to implement Phase 1 (Stripe + Paddle) immediately.*