8000
Skip to content

Latest commit

 

History

934 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SubScript

SubScript

Programmable USDC payments for modern commerce

Set‑and‑forget subscriptions, one‑tap checkout, usage billing, and peer payments — settled in stablecoin USDC on Arc, with no card declines, hidden fees, or chargebacks.

Live site · Dashboard · Docs

License Next.js TypeScript Settlement Status

Public beta: SubScript currently runs on the Arc testnet — all payments settle in testnet USDC (no monetary value) while the protocol is hardened for mainnet. See the Terms, Refund Policy, and Fulfillment Policy.


What is SubScript?

SubScript is a payments product for businesses and people who want to move money in stablecoin without the friction of cards. Merchants get checkout, recurring billing, payment links, and webhooks; customers get a wallet that just works — fund it once and let payments run on autopilot.

It is not just a subscription tool. A single framework — Unified Payment Authorization (UPA) — powers one‑time checkout, recurring plans, usage‑based charges, invoice‑style collection, sponsored payments, and AI‑native transactions, all with the same predictable lifecycle.

Why it's better

The card world SubScript
Declines, expirations, and re‑auth loops Fund once; bounded authorizations keep paying
2.9% + fixed fees, surprise charges Transparent 1% merchant fee, no hidden costs
Chargebacks and fraud risk On‑chain settlement with signed, verifiable receipts
Opaque international restrictions Borderless USDC, same experience everywhere
"Trust us" reporting Every payment carries an Arc memo receipt you can verify

Features

For customers

  • Fee‑free, set‑and‑forget USDC subscriptions — no card declines or maintenance charges
  • One‑tap checkout and peer‑to‑peer transfers from an in‑app wallet
  • Built‑in messaging with payment requests, receipts, and status — right in the thread
  • Email or Google sign-in provisions an in-app wallet backed by Circle developer-controlled MPC custody (existing legacy EOA wallets keep working); external self-custody wallets are supported via SIWE

For merchants

  • Hosted checkout, payment links, and recurring billing
  • Signed webhooks for reliable order fulfillment
  • Pay‑per‑use commit vaults — customers escrow a merchant‑set commit once; usage (API calls, tokens, sessions, per‑item) accrues and is drawn from escrow each cycle
  • Invoice‑style collection and a transparent 1% fee
  • Privacy Premium surfaces for confidential commercial flows

For developers

  • One lifecycle: create intent → bounded authorization → receipt binding → on‑chain verification → webhook
  • One-time Checkout Intents (/api/intent, GET /api/intent/:id), recurring plans (/api/v1/plans), subscriptions (/api/v1/subscriptions), payment links (/api/payment-links), metered vault status/reporting (/api/user/vault/status, /api/user/vault/report-usage), and a typed CLI
  • DNS‑style aliases for human‑readable payment identities

Billing endpoint rule

Use /api/intent only for a one-time order, invoice, ticket, or fixed pass. It never creates a merchant dashboard/DM plan, regardless of its title. Use /api/v1/plans for a reusable recurring catalog plan and /api/v1/subscriptions for a recurring checkout or user-assigned offer. API-created subscription products publish to the dashboard and DM by default; customer plan changes are upgrade-only.

How a payment works

  1. The merchant creates a structured Checkout Intent or payment link.
  2. The payer authorizes a bounded USDC action.
  3. SubScript binds the payment to an Arc memo receipt token.
  4. The backend verifies settlement on‑chain.
  5. The merchant receives a signed webhook and unlocks the order, user, or entitlement.

A look inside

Hosted USDC checkout   SubScript dashboard   In‑app payments chat

Tech stack

Next.js (App Router) · React · TypeScript · Prisma · Supabase PostgreSQL · Tailwind CSS · Viem/Wagmi · Circle wallet onboarding · Sentry & PostHog instrumentation.

Local development

npm install
npx prisma generate
npm run dev

Then open http://localhost:3000. Copy .env.example to .env.local and fill in the required keys (Supabase, Circle, JWT secret, etc.) before running the full flow.

Verify a change

npx tsc --noEmit --pretty false
npm run build

Integrate in minutes (CLI)

# Scaffold a recurring subscription + signed-webhook routes + env:
npx @subscriptonarc/cli init
# Non-interactive (agent/CI):
npx @subscriptonarc/cli init --key sk_test_... --merchant 0x... --framework next-app --yes
# Add a one-time checkout, diagnose, or forward live webhooks to localhost:
npx @subscriptonarc/cli add checkout
npx @subscriptonarc/cli doctor
npx @subscriptonarc/cli listen --forward-to http://localhost:3000/api/webhooks
npx @subscriptonarc/cli trigger payment.succeeded --url http://localhost:3000/api/webhooks/subscript

First API call with no account (shared simulation-only demo key; create your own sk_test_ key for funded Arc testnet settlement):

curl -X POST https://www.subscriptonarc.com/api/intent \
  -H "Authorization: Bearer sk_test_demo_subscript_sandbox_2026" \
  -H "Content-Type: application/json" \
  -d '{"title": "Hello SubScript", "amountUsdcMicros": "15000000"}'

Documentation

On the roadmap

Capabilities that stay deployment‑scoped until code, contracts, and production config prove them live: full Circle developer-controlled MPC wallet custody cutover (re-enabling Google login, sweep-migrating legacy wallets, deleting the legacy AES path), direct fiat‑to‑USDC on‑ramps, encrypted private‑key export (for legacy wallets), dedicated invoice objects with custom terms, sponsored "Pay for Me" relationships, configurable dunning, Chainlink Automation execution, Circle Paymaster gas sponsorship, ArcaneVM governed confidentiality, and Arc post‑quantum resilience.

License

© 2026 SubScript. All Rights Reserved. This is proprietary software — see LICENSE.

About

Programmable USDC payments for modern commerce — subscriptions, checkout, usage billing, and peer payments settled on Arc.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

1646
0