Clip Payments Skill

Triggers

Activate when user says: "clipping payments", "payouts", "earnings", "clip revenue", "clip ledger", "payment rails", "spark ads", "boost clip", or similar payment/earnings topics related to the TikTok clipping revenue stream.

Context

Chinchilla AI runs a TikTok clipping operation across three platforms (Vyro, Whop/ClipFlow, ClipHaven). Revenue needs unified tracking now (PayPal) and crypto rails later (x402/WDK on Base chain — backburner).

Revenue expectations are modest ($50-200/mo initially). The real value is building a marketing asset and proving the autonomous pipeline.

Code lives at: /Users/tori/Documents/Repos/CHI/automations/clip-payments/ X402 thesis: /Users/tori/Documents/Repos/CHI/context/x402-whitelabel-thesis.md

Phase 1 — PayPal (NOW — Primary Focus)

Setup

• PayPal Business account for Chinchilla AI (chinchillaai@paypal or similar)
• All three platforms (Vyro, Whop/ClipFlow, ClipHaven) pay out via PayPal
• PayPal Business API (REST) for programmatic payout tracking

Platform Payout Mechanics

• Vyro: Pays via PayPal when balance hits threshold (typically $25-$50). Payout emails come from Vyro.
• Whop/ClipFlow: Pays via Stripe or PayPal depending on creator settings. Set to PayPal for unified tracking.
• ClipHaven: Escrow-based — funds release after view verification. Pays via PayPal.

Unified Ledger

• ledger.py tracks all earnings across platforms
• Run python ledger.py --summary for totals
• Run python ledger.py --by-platform for per-platform breakdown
• Run python ledger.py --by-campaign for per-campaign breakdown
• Data stored in data/earnings-ledger.json

Tax Considerations

• 1099-K threshold: $600/year per platform (as of 2024+)
• Each platform issues its own 1099 — track per-platform totals
• Quarterly estimated tax if total clipping income exceeds $1,000/quarter
• Keep PayPal transaction IDs as receipts
• Deductible expenses: software subscriptions, editing tools, platform fees, Spark Ads spend

Phase 2 — TikTok Spark Ads (Paid Amplification)

What Are Spark Ads

Spark Ads are TikTok's native ad format that boosts existing organic posts. Unlike traditional ads, they amplify content that already exists on your account, preserving all engagement (likes, comments, shares) on the original post.

Rules for Spark Ad Spend

• Only boost clips that already performed well organically — minimum 1K views in first 24 hours
• Budget: $5-10 per boost, no more
• Goal: extend the reach of proven winners, not rescue underperformers
• Track Spark Ad spend as a line item in the ledger (deductible marketing expense)

When to Boost

1. Clip hits 1K+ views in 24 hours organically
2. Engagement rate (likes + comments + shares / views) is above 5%
3. The campaign is still active and the brand deal is still live
4. Total Spark Ad spend for the month is under $50 (cap it)

Tracking Spark Ad ROI

• Log in data/earnings-ledger.json with type spark_ad_spend
• Track: clip ID, organic views before boost, views after boost, spend amount, incremental revenue attributed
• Monthly Spark Ad P&L: if spend > incremental revenue for 2 months straight, pause Spark Ads

Phase 3 — Direct Brand Deals (FUTURE)

Value Proposition

• Brands currently pay platforms (Vyro, ClipHaven) who take a cut, then pay us
• With direct deals: negotiate flat rates or per-1K-view rates directly with brands
• Our rate: lower than platform rates (brand saves money, we earn more net)

Payment Terms

• Invoice via PayPal (keep it simple)
• Net-15 or prepaid for new brands
• Per verified 1K views or flat fee per clip, depending on deal structure

BACKBURNER — Phase 3+ (Month 6+): x402/WDK Crypto Rails

x402 and WDK are not being actively developed. Keep the scaffold code but don't invest time here until the clipping operation proves it can sustain $200+/month revenue.

X402 Protocol (Coinbase)

• HTTP 402 Payment Required for USDC micropayments on Base chain
• Flow: Brand sends HTTP request -> 402 response with payment details -> USDC payment on Base -> access/verification granted
• Gas fees on Base: <$0.0001 per transaction
• Settlement: instant (no 30-day net terms)

Use Case for Clipping

• Brands pay us directly per verified 1K views, bypassing platform intermediaries
• Price: $0.001-$0.005 per view (configurable per brand deal)
• Platform fees eliminated (Vyro/Whop/ClipHaven each take 10-30%)
• We keep 100% minus gas (<$0.0001)

WDK (Wallet Development Kit)

• Coinbase's SDK for building wallet infrastructure
• Creates/manages USDC wallets on Base
• Handles: wallet creation, balance checks, transaction history, auto-withdrawal
• Auto-sweep to bank when balance exceeds configurable threshold

Smart Contract Architecture

• View verification oracle: TikTok API view count -> on-chain attestation
• Payment contract: brand deposits USDC, auto-releases per verified 1K views
• Dispute resolution: 48-hour challenge window before final settlement

Code Scaffolding

• x402_scaffold.py — X402 server endpoint and payment verification
• wdk_wallet.py — Wallet management and auto-withdrawal
• Both are placeholder/stub files ready for implementation when x402 SDK stabilizes
• Do not invest further development time here until monthly clipping revenue consistently exceeds $200

Pricing Strategy (for when this becomes relevant)

• Platform rate (what brands pay Vyro/ClipHaven): $5-$15 per 1K views
• Our direct rate: $3-$10 per 1K views (brand saves 20-40%)
• Our net after gas: essentially the full amount (<$0.0001 gas)
• vs platform payout after their cut: $2-$8 per 1K views

Instructions for Claude

When helping with clip payments:

1. Always read the current state of data/earnings-ledger.json first
2. For PayPal setup questions, reference paypal_config.py for the integration pattern
3. For Spark Ads questions, check monthly spend cap and ROI tracking in the ledger
4. For x402/WDK questions, reference the thesis at context/x402-whitelabel-thesis.md but remind the user these are backburner items
5. Tax questions: remind about 1099-K thresholds and quarterly estimates
6. Never hardcode API keys — use environment variables or secrets manager
7. All monetary values stored in cents internally, displayed in dollars
8. Revenue expectations are modest — focus on proving the pipeline works, not maximizing short-term revenue