Sıfırdan
24 Saatte Yayında.
Zyrix ile ödeme kabul etmeye başlamak için ihtiyacınız olan her şey — ister eklenti kullanan bir tüccar, ister özel entegrasyon geliştiren bir geliştirici olun.
Yolunuzu Seçin
Ben bir Tüccarım
Salla, Zid, Shopify veya WooCommerce kullanıyorum. Kod gerekmez.
⏱ ~15 dakikaBen bir Geliştiriciyim
Zyrix REST API kullanarak özel entegrasyon geliştiriyorum.
⏱ ~2 saatTüccar Hızlı Başlangıcı — Eklenti Kurulumu
Zyrix Hesabınızı Oluşturun
zyrix.co adresine gidin ve 'Ücretsiz Başlayın' düğmesine tıklayın. İşletme bilgilerinizi doldurun ve satıcı hesabınızı oluşturun. 2 dakikadan az sürer.
İhtiyacınız olacak: İş e-postası, telefon numarası, faaliyet ülkesi
KYB Doğrulamasını Tamamlayın
Ticaret sicil belgenizi, vergi belgenizi ve yetkili imzacı kimliğinizi yükleyin. Ekibimiz başvuruları 24 saat içinde inceler ve bir onay e-postası alırsınız.
Türkiye: Vergi levhası + IBAN · Suudi Arabistan: CR + IBAN · BAE: Ticaret lisansı + IBAN
Eklentiyi Yükleyin
Zyrix panelinizden Entegrasyonlar'a gidin ve platformunuzu seçin. Salla ve Zid için yerel eklentiyi kullanın. Shopify ve WooCommerce için ilgili uygulama mağazasından yükleyin.
Salla: Uygulamalar → Zyrix · Zid: Entegrasyonlar → Zyrix · Shopify: Uygulamalar → 'Zyrix' ara · WooCommerce: Eklentiler → Yeni Ekle → Zyrix
Ayarlarınızı Yapılandırın
Zyrix API anahtarlarınızı girin (Panel → API Anahtarları'nda bulunur). Uzlaşma para biriminizi seçin (SAR, AED, TRY, IQD veya USD). Kabul etmek istediğiniz ödeme yöntemlerini etkinleştirin: fiat, USDT, BTC ve/veya COD.
Test moduyla başlayın — test işlemini tamamladıktan sonra canlı moda geçin
Test İşlemi Yapın
4111 1111 1111 1111 sandbox kart numarasını kullanarak mağazanıza test siparişi verin. Ödemenin Zyrix panelinizde göründüğünü doğrulayın. Webhook'ların doğru çalıştığını kontrol edin.
Test işlemi başarılı olursa yayına geçmeye hazırsınız
Yayına Alın
Eklenti ayarlarında test modundan canlı moda geçin. Test API anahtarlarını kaldırın ve canlı anahtarlarınızla değiştirin. İlk gerçek ödemenizi kabul etmeye hazırsınız.
Hesap oluşturmadan ilk canlı ödemeye ortalama süre: 18 saat
Geliştirici Hızlı Başlangıcı — API Entegrasyonu
API Anahtarlarınızı Alın
Hesap onayından sonra Panel → API Anahtarları'na gidin. Gizli anahtarınızı (sk_live_...) ve yayınlanabilir anahtarınızı (pk_live_...) kopyalayın. Gizli anahtarınızı güvenli saklayın — istemci tarafında asla göstermeyin.
// Ortam değişkenlerinde saklayın
ZYRIX_SECRET_KEY=sk_live_xxxxxxxxxxxxxxxxxxxx
ZYRIX_PUBLISHABLE_KEY=pk_live_xxxxxxxxxxxxxxxxxxxxSDK'yı Yükleyin
Diliniz için resmi Zyrix SDK'yı yükleyin. Şu anda Node.js, Python ve PHP'de mevcut.
# Node.js
npm install @zyrix/node
# Python
pip install zyrix-python
# PHP
composer require zyrix/zyrix-phpÖdeme Niyeti Oluşturun
SDK'yı başlatın ve ilk ödeme niyetinizi oluşturun. Yanıt, müşterinizi yönlendireceğiniz checkout_url'yi içerir.
const zyrix = require('@zyrix/node')(process.env.ZYRIX_SECRET_KEY);
const payment = await zyrix.payments.create({
amount: 15000, // En küçük birimde tutar (örn. 150,00 TRY)
currency: 'TRY', // TRY, SAR, AED, IQD, EGP, USD
method: 'auto', // auto, card, usdt, btc, cod
customer: {
name: 'Ahmet Yılmaz',
email: 'ahmet@example.com',
phone: '+905501234567',
},
redirect_url: 'https://maganiz.com/siparis/onaylandi',
webhook_url: 'https://maganiz.com/webhooks/zyrix',
metadata: { order_id: 'ORD-1234' },
});
// Müşteriyi yönlendirin
res.redirect(payment.checkout_url);Webhook'ları İşleyin
Gerçek zamanlı ödeme olaylarını almak için bir webhook uç noktası kurun. Özgünlüğü sağlamak için webhook sırrınızı kullanarak imzayı doğrulayın.
app.post('/webhooks/zyrix', express.raw({ type: 'application/json' }), (req, res) => {
const signature = req.headers['x-zyrix-signature'];
let event;
try {
event = zyrix.webhooks.constructEvent(
req.body, signature, process.env.ZYRIX_WEBHOOK_SECRET
);
} catch (err) {
return res.status(400).send('Webhook imza doğrulaması başarısız');
}
switch (event.type) {
case 'payment.completed':
await fulfillOrder(event.data.metadata.order_id);
break;
case 'payment.failed':
await notifyCustomer(event.data.customer.email);
break;
case 'cod.confirmed':
await markOrderDelivered(event.data.metadata.order_id);
break;
}
res.json({ received: true });
});Sandbox'ta Test Edin
Sandbox anahtarlarınıza geçin ve uçtan uca testler yapın. Başarılı ödemeler için 4111 1111 1111 1111 test kartını kullanın.
const zyrix = require('@zyrix/node')(process.env.ZYRIX_TEST_SECRET_KEY, {
environment: 'sandbox'
});
const testPayment = await zyrix.payments.create({
amount: 10000,
currency: 'TRY',
method: 'card',
// ... diğer parametreler
});
console.log('Sandbox ödeme URL:', testPayment.checkout_url);Yayına Alın
Ortam değişkenlerinizdeki sandbox anahtarlarını canlı anahtarlarla değiştirin. Dağıtın ve Zyrix panosundan ilk canlı işlemlerinizi izleyin.
// Üretim — canlı anahtarları kullanın
const zyrix = require('@zyrix/node')(process.env.ZYRIX_SECRET_KEY);
// Üretim için 'environment' bayrağı gerekmez