Skip to content
ZeroKYC Pay

Documentation

One REST call to accept a payment, one signature check for trust. Your first sandbox invoice takes about five minutes; production integration with webhook verification usually fits within one business day.

Start here

Connect ZeroKYC Pay in 15 minutes

Step-by-step guide: account and keys, first invoice, hosted checkout, webhooks and HMAC, going live — with copy-paste code.

Quickstart

Create your first invoice with payment_currency=any, send the buyer to hosted checkout and receive a signed webhook.

Sandbox & testing

How pk_test keys and the simulated chain work, simulating payments from the console and testing your webhook handler end-to-end.

Invoices API

Every merchant endpoint with examples: create, list, get, cancel, payment QR codes, plus events and payouts.

Invoice lifecycle

The invoice state machine: statuses, option statuses, observations, unique-amount windows and which webhook fires when.

Rate limits & idempotency

Per-key limits with X-RateLimit headers and Retry-After, plus Idempotency-Key semantics: replays, conflicts, the 24-hour window.

Errors

The uniform error envelope and all eight error codes: when each fires and how to handle it.

Webhooks reference

The full event catalogue with exact payloads, delivery headers and semantics, the 1m→12h retry ladder and consumer idempotency rules.

SDKs: PHP, Python, Node.js

Official PHP, Python and Node.js SDKs: install, create invoices with idempotency keys and verify webhook signatures in one call.

HMAC signature verification

Verify webhook signatures in Node.js, PHP and Python — constant-time comparison and the 5-minute timestamp window.

Networks: confirmations & TTL

Confirmation thresholds per network (TRON, EVM incl. Ethereum/BSC, BTC/LTC/DOGE/BCH, XRP, NEAR, Solana, TON, Monero) and invoice TTL rules: mempool waiting, expiry and rescan behaviour.

Direct checkout guide

Connect your own wallet: one static address + unique amounts for every asset except Monero (view key).

API Reference (OpenAPI)

Interactive REST API specification: invoices, webhooks, payouts, exchange rates, and sandbox.