ZapAPI Docs
Get StartedConceptsAI GatewayGuidesPayment GatewaySDKAPI ReferenceResources
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)

BlockPhaseDescription
Link2URL + title + auto-favicon
Tip jar2LNURL payment overlay, presets + custom + comment
Subscription tiers2plan cards hosted checkout
Paid link2pay-to-unlock URL/download
Social icons2auto from URLs
Zap feed2recent supporters w/ amounts
Embed (YT/Spotify/X)4oEmbed
Email capture4CRM + newsletter module
Zap goal4fundraising 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:image auto-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), active

Follower 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 anytime

Renewal 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/exclusive gated 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

SignalSource
NIP-05 checkmarkusername pubkey match
Zap countertotal zaps received (public)
Supporter badgestop zappers on your page
Nostr profile linknprofile 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)

LeverProposal
Free tierbio 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 usage1% per invoice, volume discounts
Custom domainsPro add-on
Fees configurable per project in admin (feeBps).

7. Why this wins (vs Linktree/Beacons/Patreon)

Linktree/BeaconsPatreonZapAPI
Feessub + 0-9% txn8-12%0-1%
PayoutT+days, fiat railsmonthly, fiatinstant, self-withdraw
Identitynoneplatform accountNostr portable identity
Censorshipplatform rulesplatform rulesopen protocol exit anytime
Globalcard networkscard networksany Lightning wallet, 190+ countries
Follower needs accountnoyesno (magic link)

On this page