⚡ REST API VE SDK

Her Şeyi İnşa Edin.
Hızlı Gönderin.

Tam kontrol isteyen geliştiriciler için inşa edilmiş modern, tam dokümante edilmiş REST API. OpenAPI 3.0 spesifikasyonu, sandbox ortamı, webhooklar ve Node.js, Python, PHP için SDK'lar.

99.9%

Çalışma Süresi SLA

Resmi SDK

OpenAPI

3.0 Dokümante

Sandbox

Test Ortamı

Temel API Uç Noktaları

POST/v1/paymentsYeni bir ödeme oluşturun — kart, kripto veya COD. payment_id ve ödeme URL'si döndürür.

GET/v1/payments/:idTam ödeme ayrıntılarını alın — durum, tutar, para birimi, yöntem, zaman damgaları.

POST/v1/refundsHerhangi bir uzlaşmış ödemeye karşı tam veya kısmi iade gönderin.

GET/v1/settlementsTüm uzlaşma kayıtlarını listeleyin — tarihler, tutarlar, ücretler, para birimi başına net ödemeler.

POST/v1/webhooksGerçek zamanlı ödeme olayları almak için bir webhook uç noktası kaydedin.

GET/v1/balanceGerçek zamanlı olarak para birimi başına mevcut satıcı bakiyenizi alın.

Resmi SDK'lar

🟩Node.jsnpm install zyrix-sdk

const zyrix = require('zyrix-sdk');
const payment = await zyrix.payments.create({
  amount: 25000,
  currency: 'IQD',
  method: 'card'
});

🐍Pythonpip install zyrix

import zyrix
client = zyrix.Client(api_key)
payment = client.payments.create(
  amount=250,
  currency='SAR',
  method='crypto'
)

🐘PHPcomposer require zyrix/sdk

$zyrix = new Zyrix\Client($apiKey);
$payment = $zyrix->payments->create([
  'amount' => 1500,
  'currency' => 'TRY',
  'method' => 'card'
]);

Webhook Olayları

payment.completed

Bir ödeme tamamen onaylandığında ve fonlar yakalandığında tetiklenir.

payment.failed

Bir ödeme girişimi başarısız olduğunda tetiklenir — hata kodu ve nedeni içerir.

payment.pending

Blockchain onayı bekleyen kripto ödemeler için tetiklenir.

refund.issued

Bir iade başarıyla işlendiğinde tetiklenir.

dispute.opened

Müşterinin bankası tarafından bir chargeback veya anlaşmazlık açıldığında tetiklenir.

settlement.completed

Bir uzlaşma toplu işlemi işlendiğinde ve fonlar yolda olduğunda tetiklenir.

Geliştirici Deneyimi

📖

OpenAPI 3.0 Spesifikasyonu

Tam makine tarafından okunabilir API spesifikasyonu. Postman, Insomnia veya herhangi bir API istemcisine içe aktarın. 40+ dilde istemci kodu otomatik oluşturun.

🧪

Sandbox Ortamı

Simüle edilmiş ödeme akışları, webhook teslimi ve uzlaşma döngüleriyle tam test ortamı. Test kartları, test kripto cüzdanları, test COD.

🔑

API Anahtar Yönetimi

Ayrı canlı ve test API anahtarları oluşturun. Anahtarları IP, alan adı veya izin kapsamına göre kısıtlayın. Kesinti olmadan anahtarları döndürün.

📊

İstek Günlükleri

Her API çağrısı için tam istek ve yanıt günlükleri — uç nokta, durum, zamana göre filtrelenebilir. Tahmin etmeden entegrasyon sorunlarını hata ayıklayın.

⚡

Düşük Gecikme

Çoğu uç nokta için 200ms'nin altında API yanıt süreleri. Minimum gecikme için MENA ve Avrupa genelinde uç altyapıda barındırılır.

🔒

HMAC Webhook İmzalama

Her webhook HMAC-SHA256 ile imzalanır. Olayların gerçekten Zyrix'ten geldiğinden emin olmak için sunucunuzda imzaları doğrulayın.

İnşa Etmeye Başlayın

Sandbox API anahtarlarınızı alın ve dakikalar içinde entegre etmeye başlayın.

Demo Rezervasyonu API Dokümanlarını Görüntüle →

Her Şeyi İnşa Edin.Hızlı Gönderin.