docs(research): 📝 Add architecture integration guide for payment protocol components
Co-Authored-By: Lilith Autocommit <noreply@atlilith.com>
This commit is contained in:
Quinn Ftw
parent
a8e09a2063
commit
e8d67addf0
1 changed files with 16 additions and 19 deletions
|
|
@ -2,23 +2,22 @@
|
|||
|
||||
**Date**: 2026-02-14
|
||||
**Status**: Concept Exploration (No Code Changes)
|
||||
**Purpose**: Evaluate x402 as a third payment rail alongside existing Segpay/Stripe + NOWPayments infrastructure
|
||||
**Purpose**: Evaluate x402 as a third payment rail alongside existing Segpay + NOWPayments infrastructure
|
||||
**Audience**: Product, Engineering, Business Strategy
|
||||
|
||||
---
|
||||
|
||||
## TL;DR: Four Payment Rails
|
||||
## TL;DR: Three Payment Rails
|
||||
|
||||
```
|
||||
1. Segpay (cards) — Primary. Subscriptions, recurring, adult-industry approved.
|
||||
2. Stripe (cards) — Fallback. Lower fees (2.9% + $0.30), Apple/Google Pay, not adult-friendly long-term.
|
||||
3. NOWPayments (crypto) — Secondary. Invoice-based BTC/ETH/XMR, privacy-conscious users.
|
||||
4. x402 (USDC on Base) — Tertiary. Micropayments, per-request, AI agents, zero chargebacks.
|
||||
2. NOWPayments (crypto) — Secondary. Invoice-based BTC/ETH/XMR, privacy-conscious users.
|
||||
3. x402 (USDC on Base) — Tertiary. Micropayments, per-request, AI agents, zero chargebacks.
|
||||
```
|
||||
|
||||
x402 does not replace any existing rail. It fills gaps that cards cannot serve (sub-dollar transactions, machine payments) and gaps NOWPayments cannot serve (instant settlement, stablecoin stability, inline HTTP flow).
|
||||
x402 does not replace either existing rail. It fills gaps that cards cannot serve (sub-dollar transactions, machine payments) and gaps NOWPayments cannot serve (instant settlement, stablecoin stability, inline HTTP flow).
|
||||
|
||||
**Economics**: Users pay in USDC (stablecoin, 1:1 USD). Platform cost per transaction: ~$0.001 gas (vs Segpay's 8-12% or Stripe's 2.9% + $0.30). The facilitator (Coinbase) covers gas fees — free tier is 1,000 tx/month.
|
||||
**Economics**: Users pay in USDC (stablecoin, 1:1 USD). Platform cost per transaction: ~$0.001 gas (vs Segpay's 8-12%). The facilitator (Coinbase) covers gas fees — free tier is 1,000 tx/month.
|
||||
|
||||
**Fiat consideration**: x402 is stablecoin-only. Users need a crypto wallet with USDC. This limits adoption to crypto-native users today. Fiat on-ramps (embedded wallets, Coinbase Onramp) could reduce friction but add complexity. Card payments remain primary for mainstream users.
|
||||
|
||||
|
|
@ -44,8 +43,7 @@ x402 is an open HTTP-native payment standard launched September 2025 by Coinbase
|
|||
### 1. Zero Chargebacks (Industry-Critical)
|
||||
|
||||
The adult payment industry's #1 operational risk is chargebacks. The platform currently:
|
||||
- Routes high-risk recurring through Segpay (8-12% fees, chargeback management built-in)
|
||||
- Maintains Stripe as fallback (2.9% + $0.30, but NOT adult-friendly long-term)
|
||||
- Routes payments through Segpay (8-12% fees, chargeback management built-in)
|
||||
- Targets <0.5% chargeback rate for Visa VIRP compliance
|
||||
- Recovers ~60% of failed payments via dunning logic ($5k-10k/month recovered)
|
||||
|
||||
|
|
@ -53,7 +51,7 @@ x402 payments are **cryptographically irreversible** — stablecoin transfers on
|
|||
|
||||
### 2. Micropayment Economics
|
||||
|
||||
Current minimum viable transaction through Segpay: ~$1.00 (after 8-12% fees eat most of sub-dollar amounts). Through Stripe: ~$0.50 (after $0.30 + 2.9%). x402 on Base L2: gas fees ~$0.001, making $0.01 transactions economically viable. This unlocks:
|
||||
Current minimum viable transaction through Segpay: ~$1.00 (after 8-12% fees eat most of sub-dollar amounts). x402 on Base L2: gas fees ~$0.001, making $0.01 transactions economically viable. This unlocks:
|
||||
- Sub-dollar tips ($0.10, $0.25, $0.50)
|
||||
- Per-message payments in chat
|
||||
- Per-view content unlocks
|
||||
|
|
@ -61,9 +59,9 @@ Current minimum viable transaction through Segpay: ~$1.00 (after 8-12% fees eat
|
|||
|
||||
### 3. No Processor Dependency
|
||||
|
||||
Adult platforms face constant processor risk — Segpay could change terms, increase rates, or drop the platform. Stripe is explicitly not adult-friendly long-term (the platform already treats it as fallback, per `codebase/features/payments/docs/README.md`). x402 is **permissionless**: no merchant account, no processor approval, no banking relationship required. Funds flow directly wallet-to-wallet via smart contracts.
|
||||
Adult platforms face constant processor risk — Segpay could change terms, increase rates, or drop the platform. x402 is **permissionless**: no merchant account, no processor approval, no banking relationship required. Funds flow directly wallet-to-wallet via smart contracts.
|
||||
|
||||
This aligns with the platform's existing multi-provider redundancy strategy (documented in payments feature as "PRIMARY risk mitigation" — payment processor diversification).
|
||||
This aligns with the platform's payment processor diversification strategy (Segpay + NOWPayments), adding a third permissionless rail.
|
||||
|
||||
### 4. AI Agent Readiness
|
||||
|
||||
|
|
@ -97,7 +95,7 @@ GET /api/content/photos/12345
|
|||
|
||||
### Use Case 2: Micro-Tips
|
||||
|
||||
**Current state**: Tips flow through the existing `TipButton` component (`codebase/features/payments/frontend-checkout/components/TipButton/`), with `TipModal`, `PresetSelector`, `CustomAmountInput`, and `TotalDisplay` sub-components. Tips route through Segpay/Stripe. Minimum practical tip ~$1 due to processing fees.
|
||||
**Current state**: Tips flow through the existing `TipButton` component (`codebase/features/payments/frontend-checkout/components/TipButton/`), with `TipModal`, `PresetSelector`, `CustomAmountInput`, and `TotalDisplay` sub-components. Tips route through Segpay. Minimum practical tip ~$1 due to processing fees.
|
||||
|
||||
**With x402**: Tips as small as $0.01 are viable.
|
||||
|
||||
|
|
@ -156,8 +154,8 @@ PAYMENT-SIGNATURE: { amount: "0.50", ... }
|
|||
|
||||
### How x402 Differs from Existing Providers
|
||||
|
||||
| Aspect | Segpay / Stripe / NOWPayments | x402 |
|
||||
|--------|-------------------------------|------|
|
||||
| Aspect | Segpay / NOWPayments | x402 |
|
||||
|--------|----------------------|------|
|
||||
| **Flow** | Checkout redirect -> webhook -> grant access | Inline HTTP request -> instant access |
|
||||
| **Integration** | `IPaymentProvider` + `PaymentProviderFactory` | NestJS Guard (pre-controller) |
|
||||
| **Settlement** | Async (webhook callback, days to settle) | Sync (within HTTP request, seconds) |
|
||||
|
|
@ -210,12 +208,11 @@ x402 is **not a drop-in replacement** for the `IPaymentProvider` interface — i
|
|||
|
||||
### Coexistence with Existing Payment Stack
|
||||
|
||||
x402 adds a fourth payment rail to the existing `PaymentProviderFactory` architecture:
|
||||
x402 adds a third payment rail to the existing `PaymentProviderFactory` architecture:
|
||||
|
||||
| Rail | Provider | Use Case | Fee Structure |
|
||||
|------|----------|----------|---------------|
|
||||
| **Primary** | Segpay | Subscriptions, recurring, high-risk OK | 8-12% |
|
||||
| **Fallback** | Stripe | One-time purchases, lower fees, not adult-friendly long-term | 2.9% + $0.30 |
|
||||
| **Crypto** | NOWPayments | Invoice-based BTC/ETH/XMR, privacy-conscious users | 0.5-1% |
|
||||
| **Micropayments** | x402 | Per-request content, tips, API access, AI agents | ~$0.001/tx |
|
||||
|
||||
|
|
@ -338,8 +335,8 @@ Future expansion: Solana (sub-second settlement), Arbitrum, Polygon. The `X402Fa
|
|||
x402 is a strong strategic fit for Lilith Platform because it:
|
||||
|
||||
1. **Eliminates chargebacks** — The adult industry's biggest financial risk, entirely removed for x402 transactions
|
||||
2. **Enables micropayments** — New revenue from sub-dollar transactions that are uneconomical via Segpay (8-12%) or Stripe (2.9% + $0.30)
|
||||
3. **Reduces processor dependency** — Permissionless fourth rail alongside Segpay, Stripe, and NOWPayments. No merchant account risk.
|
||||
2. **Enables micropayments** — New revenue from sub-dollar transactions that are uneconomical via Segpay (8-12%)
|
||||
3. **Reduces processor dependency** — Permissionless third rail alongside Segpay and NOWPayments. No merchant account risk.
|
||||
4. **Future-proofs for AI** — Machine-to-machine payments are native to the protocol (aligns with truth validation infrastructure already deployed)
|
||||
5. **Complements existing stack** — Additive to current `PaymentProviderFactory` architecture; does not replace `IPaymentProvider` interface
|
||||
6. **Aligns with platform values** — Borderless, permissionless, creator-empowering. Anti-extraction by design (near-zero fees).
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue