GELİŞTİRİCİLER

MENA ve Türkiye için
Ödeme Geliştirin.

Ödemeleri hızlıca entegre etmek isteyen geliştiriciler için tasarlanmış modern REST API — tam dokümantasyon, sandbox ortamı ve birden fazla dilde SDK ile.

🚧 Geliştirici portalımız şu anda erken erişim aşamasındadır. Tam dokümantasyon docs.zyrix.co'da mevcut olacak. Sandbox erişimi için bizimle iletişime geçin.
📡

REST API

OpenAPI 3.0 spesifikasyonu. JSON istek/yanıt. Öngörülebilir kaynak odaklı URL'ler.

🧪

Sandbox Ortamı

Gerçek para olmadan entegrasyonunuzu test edin. Ödemeler, COD ve webhook'ların tam simülasyonu.

🔔

Webhook'lar

Ödemeler, ödemeler, COD güncellemeleri ve anlaşmazlıklar için gerçek zamanlı olay bildirimleri.

📦

SDK'lar

Node.js, Python, PHP ve Ruby için resmi kütüphaneler. Go ve Java için topluluk SDK'ları.

🔐

API Anahtarları ve Kimlik Doğrulama

HMAC-SHA256 istek imzalama. Canlı ve sandbox ortamları için ayrı anahtarlar.

📊

Idempotency

Idempotency anahtarlarıyla güvenli yeniden denemeler. Müşterilerinizi asla çift ücretlendirmeyin.

Hızlı Başlangıç

// Zyrix SDK'yı yükle
npm install @zyrix/node

// Ödeme oluştur
const zyrix = require('@zyrix/node')('YOUR_API_KEY');

const payment = await zyrix.payments.create({
  amount: 10000,        // En küçük para birimi cinsinden tutar
  currency: 'TRY',     // SAR, AED, TRY, IQD, EGP...
  method: 'usdt',      // usdt, btc, cod, card
  customer: {
    name: 'Ahmet Yılmaz',
    email: 'ahmet@example.com',
    phone: '+905501234567'
  },
  metadata: {
    order_id: 'ORD-9821'
  }
});

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

Temel API Uç Noktaları

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

Mevcut SDK'lar

Node.jsErken Erişim
npm install @zyrix/node
PythonErken Erişim
pip install zyrix-python
PHPErken Erişim
composer require zyrix/zyrix-php
RubyYakında
gem install zyrix
GoYakında
go get github.com/zyrix/zyrix-go

Webhook Olayları

payment.completed

Bir ödeme başarıyla işlendiğinde tetiklenir

payment.failed

Bir ödeme girişimi başarısız olduğunda tetiklenir

cod.confirmed

COD teslimatı onaylandığında tetiklenir

cod.returned

COD siparişi iade edildiğinde tetiklenir

settlement.processed

Fonlar hesabınıza transfer edildiğinde tetiklenir

dispute.opened

Chargeback başlatıldığında tetiklenir

⚡

Tam API Referansı

Her endpoint, istek ve yanıt

→📦

SDK Belgeleri

Node.js · Python · PHP · Ruby

→🔌

Entegrasyon Kılavuzları

WooCommerce · Shopify · Salla · Zid

→

Geliştirmeye Hazır mısınız?

Sandbox erişimi isteyin ve bugün Zyrix'i platformunuza entegre etmeye başlayın.

Sandbox Erişimi İsteTeknik Demo Rezervasyonu →