Skip to Content
Devnet open · mainnet by application — these docs ship with the pre-alpha release.

NinjaPay integration docs

Private payments with the API surface merchants already know.

These docs walk through wiring NinjaPay into a working merchant integration end-to-end. Devnet is open today; mainnet rolls out by application.

Start here

  • Quickstart — your first NinjaPay charge in ~15 minutes (API key → payment link → webhook reconciliation).
  • Migration guide — what changes, what stays the same, how to port an existing payment integration.
  • Webhooks — full event reference, HMAC verification, replay protection, delivery SLO.

By feature

  • Subscriptions — recurring billing, proration, dunning.
  • Refunds — partial + full, on-chain settlement, audit trail.
  • Disputes — evidence submission, lifecycle events, mediation.
  • Connect — platform splits, payouts to sub-merchants, reverse transfers.

What’s not here yet

  • x402 facilitator integration guide — the facilitator service is live in apps/facilitator; a dedicated agent-integration guide ships with the next slice.
  • Payroll integration guide — API + dashboard scaffold today; on-chain payroll instructions and end-to-end tutorial ship when the program ix lands.
  • API reference — auto-generated from OpenAPI; queued behind the docs-site build.

Get help

The migration is a base-URL change. The privacy comes from Umbra. The settlement is on Solana. The rest is what your stack already speaks.

Quickstart