API PAYMENTS
Full programmatic control over every payment.
Build custom payment flows with our REST API. Create payments, verify transactions, and manage wallets with clean, predictable endpoints. Designed for developers who want total control.
CREATE A PAYMENT
One request to get paid
A single cURL command creates a payment, sets up the hosted page, and configures the webhook. Copy, paste, done.
curl -X POST https://zateway.com/api/v1/payments \ -H "X-API-Key: zate_live_..." \ -H "Content-Type: application/json" \ -d '{ "amount": "150.00", "currency": "USDT", "chain": "polygon", "metadata": { "orderId": "ord_29fk3m", "customer_email": "jane@acme.com" }}, "webhookUrl": "https://you.com/webhooks" }'
{
"id": "zate_sess_abc123def456",
"displayAmount": "150.00",
"status": "pending",
"currency": "USDT",
"chain": "polygon",
"checkoutUrl": "https://zateway.com/checkout/zate_sess_...",
"expiresAt": "2026-03-25T13:15:00Z",
"merchantWallet": "0xYour..."
}HOW IT WORKS
From API call to settled funds
Get Your API Keys
Sign up and grab your test and live API keys from the dashboard. Sandbox mode lets you test everything risk-free.
Create a Payment
Make a POST request with the amount, currency, and recipient wallet. We return a payment object with a unique ID.
Customer Completes Payment
Direct your customer to complete the on-chain transaction. We monitor the blockchain and confirm settlement.
Receive Webhook
We fire a signed webhook to your endpoint with the full payment details. Verify the signature, then fulfill.
DEVELOPER EXPERIENCE
APIs developers actually enjoy
We obsess over DX so you can ship faster.
RESTful & Predictable
Clean REST endpoints with consistent JSON responses. Standard HTTP status codes. No surprises.
HMAC-Signed Webhooks
Every webhook payload is signed with your secret. Verify the signature to ensure it came from Zateway.
Sandbox Environment
Separate test mode with sandbox-tagged sessions and testnet support, so you can debug integrations without mixing them with live traffic.
Idempotency Keys
Send an idempotency key with any POST request. Safe to retry failed requests without creating duplicates.
Code Samples & Guides
Ready-to-use code samples in Node.js, Python, and PHP. Integration guides for Next.js, Express, and more — all without giving up raw REST access.
Granular Permissions
Scope your API keys to specific actions. Read-only keys for dashboards, write keys for payment creation.
API REFERENCE
Core endpoints
/v1/paymentsCreate a new payment/v1/payments/:idRetrieve a payment/v1/paymentsList all payments/v1/checkout/sessionsCreate a checkout session/v1/walletsList connected wallets/v1/webhooksRegister a webhook endpointStart building with the Zateway API
Grab your sandbox keys and make your first API call in under five minutes. No approval process, no sales calls.