ZZion Payment
Get Started
REST + Webhooks

Built for engineers,
designed for production

One REST API handles the entire payment lifecycle — from checkout link generation to payout settlement. Sandbox-first, fully documented, SDK-backed.

Three ways to integrate

Easiest

Hosted Checkout

Send your customer a payment link. Zero frontend code. Live in 30 minutes.

Most flexible

REST API

Full control. Create payments, query status, list transactions, manage payouts.

Event-driven

Webhooks

Signed events for payment.completed, payment.failed, and payout.settled.

Code samples

Copy-paste ready for curl, Node.js SDK, and webhook handling.

create-payment.shcURL
curl -X POST https://api.zionpayment.com/v1/payments \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1250,
    "currency": "USDT",
    "merchant_order_id": "order_8f3a",
    "callback_url": "https://your-site.com/webhook"
  }'
create-payment.jsNode.js
import { Zion } from '@zionpayment/sdk';

const zion = new Zion(process.env.ZION_API_KEY);

const payment = await zion.payments.create({
  amount: 1250,
  currency: 'USDT',
  merchantOrderId: 'order_8f3a',
});

console.log(payment.payment_url);
webhook-handler.jsWebhook
app.post('/webhook', (req, res) => {
  const signature = req.headers['zion-signature'];

  if (!zion.webhooks.verify(req.rawBody, signature, secret)) {
    return res.status(401).end();
  }

  const event = req.body;

  if (event.type === 'payment.completed') {
    markOrderPaid(event.data.merchant_order_id);
  }

  res.sendStatus(200);
});

Production-ready from day one

Every feature you need before going live is already built.

Idempotency

Safe to retry. Use the Idempotency-Key header to avoid duplicate charges.

Signed webhooks

HMAC-SHA256 signature on every event. Verify before processing.

Sandbox

Full testnet environment with test addresses and simulated confirmations.

Status page

Real-time API status and incident history at status.zionpayment.com.

OpenAPI spec

Machine-readable spec — auto-generate typed clients in any language.

24/7 request logs

Full request/response history available in the merchant dashboard.

Official SDKs

Node.js

@zionpayment/sdk

stable

Python

zionpayment

stable

PHP

zionpayment/php-sdk

beta

Go

github.com/zionpayment/go-sdk

alpha

Ruby

Coming soon

soon

Java

Coming soon

soon

Rate limits & quotas

  • 100 requests / second per API key
  • 10,000 payments / day on Starter tier
  • Burst protection: 200 req per 10 seconds
  • Higher limits available — contact sales

API versioning

Current stable version: v1. Breaking changes are released under a new version prefix with 6-month deprecation notice.

Ready to integrate?

Get your sandbox API key today. No commitment, no credit card.