DEVELOPERS

Build Payments for
MENA & Turkey.

A modern REST API built for developers who want to integrate payments quickly — with full documentation, sandbox environment, and SDKs in multiple languages.

🚧 Our developer portal is currently in early access. Full documentation will be available at docs.zyrix.co. Contact us to request sandbox access.
📡

REST API

OpenAPI 3.0 specification. JSON request/response. Predictable resource-oriented URLs.

🧪

Sandbox Environment

Test your integration without real money. Full simulation of payments, COD, and webhooks.

🔔

Webhooks

Real-time event notifications for payments, settlements, COD updates, and disputes.

📦

SDKs

Official libraries for Node.js, Python, PHP, and Ruby. Community SDKs for Go and Java.

🔐

API Keys & Auth

HMAC-SHA256 request signing. Separate keys for live and sandbox environments.

📊

Idempotency

Safe retries with idempotency keys. Never double-charge your customers.

Quick Start

// Install the Zyrix SDK
npm install @zyrix/node

// Create a payment
const zyrix = require('@zyrix/node')('YOUR_API_KEY');

const payment = await zyrix.payments.create({
  amount: 10000,        // Amount in smallest currency unit
  currency: 'SAR',     // SAR, AED, TRY, IQD, EGP...
  method: 'usdt',      // usdt, btc, cod, card
  customer: {
    name: 'Ahmed Al-Rashid',
    email: 'ahmed@example.com',
    phone: '+966501234567'
  },
  metadata: {
    order_id: 'ORD-9821'
  }
});

console.log(payment.checkout_url);
// → https://pay.zyrix.co/checkout/ch_xxxxx

Core API Endpoints

POST/v1/payments
GET/v1/payments/:id
POST/v1/payments/:id/refund
POST/v1/cod/orders
PUT/v1/cod/orders/:id
GET/v1/settlements
POST/v1/webhooks
GET/v1/balance

Available SDKs

Node.jsEarly Access
npm install @zyrix/node
PythonEarly Access
pip install zyrix-python
PHPEarly Access
composer require zyrix/zyrix-php
RubyComing Soon
gem install zyrix
GoComing Soon
go get github.com/zyrix/zyrix-go

Webhook Events

payment.completed

Triggered when a payment is successfully processed

payment.failed

Triggered when a payment attempt fails

cod.confirmed

Triggered when COD delivery is confirmed

cod.returned

Triggered when a COD order is returned

settlement.processed

Triggered when funds are settled to your account

dispute.opened

Triggered when a chargeback is initiated

⚡

Full API Reference

Every endpoint, request & response

→📦

SDK Documentation

Node.js · Python · PHP · Ruby

→🔌

Integration Guides

WooCommerce · Shopify · Salla · Zid

→

Ready to Start Building?

Request sandbox access and start integrating Zyrix into your platform today.

Request Sandbox AccessBook a Technical Demo →