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.

Get API Keys Read the Docs

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.

REQUEST
curl -X POST https://zateway.com/api/v1/payments \
  -H "X-API-Key: zate_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "150.00",
    "currency": "USDT",
    "chain": "polygon",
    "merchantWallet": "0xYourWallet...",
    "metadata": {
      "orderId": "ord_29fk3m",
      "customer_email": "jane@acme.com"
    }},
    "webhookUrl": "https://you.com/webhooks"
  }'
RESPONSE
{
  "id": "zate_sess_7kJ2mNx9qL",
  "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

STEP 1

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.

STEP 2

Create a Payment

Make a POST request with the amount, currency, and recipient wallet. We return a payment object with a unique ID.

STEP 3

Customer Completes Payment

Direct your customer to complete the on-chain transaction. We monitor the blockchain and confirm settlement.

STEP 4

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

Full test environment with simulated blockchain transactions. Build and debug without spending real crypto.

Idempotency Keys

Send an idempotency key with any POST request. Safe to retry failed requests without creating duplicates.

Comprehensive SDKs

Official libraries for Node.js, Python, Go, and Rust. Type-safe, well-documented, and actively maintained.

Granular Permissions

Scope your API keys to specific actions. Read-only keys for dashboards, write keys for payment creation.

API REFERENCE

Core endpoints

POST/v1/paymentsCreate a new payment
GET/v1/payments/:idRetrieve a payment
GET/v1/paymentsList all payments
POST/v1/checkout/sessionsCreate a checkout session
GET/v1/walletsList connected wallets
POST/v1/webhooksRegister a webhook endpoint

Start 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.

Get API Keys Read the Docs