Payment Gateway
Creator Features
Bio links, tip jar, subscriptions and the supporter CRM spec.
The influencer side of ZapAPI: bio links, tips, subscriptions, supporter CRM. Design goal: Linktree-quality UX, Nostr-native under the hood, 0% platform lock-in.
1. Bio Page (/u/:username)
Page anatomy (mobile-first)
┌─────────────────────────┐
│ Avatar (NIP-05) │
│ @alice │
│ alice@zapapi.com │ tap = zap/copy
│ Short bio │
│ [social icons] │
├─────────────────────────┤
│ TIP JAR (block) │ preset 21/210/2100 sats + custom
│ Latest video (block)│
│ SUPPORT ME (tiers) │ subscription plans
│ Photo preset (paid) │ paid link block
│ All links… │
├─────────────────────────┤
│ Recent supporters │ public zap feed (opt-in)
└─────────────────────────┘Block types (v1 later)
| Block | Phase | Description |
|---|---|---|
| Link | 2 | URL + title + auto-favicon |
| Tip jar | 2 | LNURL payment overlay, presets + custom + comment |
| Subscription tiers | 2 | plan cards hosted checkout |
| Paid link | 2 | pay-to-unlock URL/download |
| Social icons | 2 | auto from URLs |
| Zap feed | 2 | recent supporters w/ amounts |
| Embed (YT/Spotify/X) | 4 | oEmbed |
| Email capture | 4 | CRM + newsletter module |
| Zap goal | 4 | fundraising progress bar |
Theming
- 5 presets (light/dark/minimal/neon/brutalist) at v1
- Custom accent color + font pair choice
- Custom CSS = paid SaaS tier (Phase 4)
- Avatar/banner upload (existing upload infra or nostr media)
SEO & sharing
- SSR via Next.js,
og:imageauto-generated (avatar + name +) <link rel="lightning" href="lnurlp:alice@zapapi.com">meta for wallets- JSON-LD ProfilePage schema
2. Tips & Zaps
- Tip jar on bio page uses the SAME LNURL endpoint as Nostr clients one balance, one history, whether payment came from bio page or Damus
- Anonymous tips allowed; optional "leave your npub/name" (feeds CRM, LUD-18)
- Instant notifications: dashboard toast + optional nostr DM/email
- Success action message configurable ("Thanks for the zap! ")
3. Subscriptions
Plan model
Plan: name, description, amount (sats or fiat), interval (week/month/year),
trialDays, perks[], maxSubscribers? (scarcity), activeFollower checkout (hosted, no account needed)
/u/alice/support
1. pick tier
2. choose method:
a) Connect wallet (NWC) — auto-pay monthly [best UX, needs NWC wallet]
b) Pay first month now (QR/WebLN) + email reminder each cycle [universal]
3. enter email and/or npub (for perks + portal access)
4. done magic link to manage anytimeRenewal engine (cron, daily)
for subscriptions where currentPeriodEnd <= today:
nwc: request pay_invoice via NWC paid? extend: grace(3d) past_due(7d) canceled
manual: create invoice email/nostr DM link paid? extend: same grace ladder
events fired: subscription.renewed / past_due / canceled (webhook + creator notif)Perks delivery (v1 later)
- v1: badge on bio page supporter wall + creator can export subscriber list
- v2: subscriber-only pages on ZapAPI (
/u/alice/exclusivegated by active sub) - v3: nostr-based gated content (gift-wrapped DMs to subscriber pubkeys)
4. Supporter CRM (per-creator customer management)
Auto-created on first payment (keyed by npub if present, else email, else anon id).
Creator sees
Customers
├── Table: name/npub, total paid, last payment, plan, tags
├── Detail: full payment history, subscription state, notes field
├── Segments: VIP (>100k sats), Monthly supporters, New this week, Churned
└── Actions: tag, note, export CSV, send message (email/nostr DM)Creator analytics
- MRR/ARR, subscriber count trend, churn rate
- Tips vs subscriptions split
- Top supporters all-time (public opt-in leaderboard block)
- Earnings export for taxes (CSV by period)
5. Identity & Trust
| Signal | Source |
|---|---|
| NIP-05 checkmark | username pubkey match |
| Zap counter | total zaps received (public) |
| Supporter badges | top zappers on your page |
| Nostr profile link | nprofile deep link |
Influencers bring their existing Nostr reputation; ZapAPI amplifies it instead of replacing it (vs Linktree which knows nothing about identity).
6. Monetization for the platform (us)
| Lever | Proposal |
|---|---|
| Free tier | bio page, 1 plan, tips, zaps — 1% fee on payments |
| Creator Pro (~$5-8/mo in sats) | custom themes, paid links, analytics, 0% fees |
| Merchant/API usage | 1% per invoice, volume discounts |
| Custom domains | Pro add-on |
Fees configurable per project in admin (feeBps). |
7. Why this wins (vs Linktree/Beacons/Patreon)
| Linktree/Beacons | Patreon | ZapAPI | |
|---|---|---|---|
| Fees | sub + 0-9% txn | 8-12% | 0-1% |
| Payout | T+days, fiat rails | monthly, fiat | instant, self-withdraw |
| Identity | none | platform account | Nostr portable identity |
| Censorship | platform rules | platform rules | open protocol exit anytime |
| Global | card networks | card networks | any Lightning wallet, 190+ countries |
| Follower needs account | no | yes | no (magic link) |