İçeriğe atlayın

Dokümantasyon

API Dokümantasyonu

Ödeme alın, fatura oluşturun, ödeme çıkışı başlatın, webhook’ları dinleyin. Paymos REST API’sinde hızlı başlangıç, kimlik doğrulama, hata formatı ve Sandbox.

API

Kimlik Doğrulama
Her Merchant API isteğini HMAC-SHA256 ile doğrulayın: zorunlu başlıklar, kanonik yük oluşturma, zaman damgaları ve tekrar koruması.
API Anahtarları
Payment ve Payout API anahtarları oluşturun, kapsam ve öneklerini öğrenin, kimlik bilgilerini güvenle rotasyona alın ve test ile canlı erişimi ayırın.
Base URL
Test ve canlı istekler için tek Paymos Merchant API base URL'sini kullanın, ortamı anahtar önekiyle seçin ve tek bir entegrasyon yolu koruyun.
Desteklenen Para Birimleri
Bir projede varlıkları etkinleştirmeden önce 13 blockchain ağının hangilerinin USDT, USDC, USD1, DAI ve altın destekli XAUT'u desteklediğini kontrol edin.
Hata Yönetimi
Merchant API hatalarını yönetin: yanıt zarfı, HTTP durum grupları, makine tarafından okunabilir kodlar, istek limitleri ve yeniden deneme rehberi.
Hata Kodları
Merchant API hatalarını kararlı, makine tarafından okunabilir kodlar, alan düzeyi doğrulama ayrıntıları ve belgelenmiş kurtarma yollarıyla yönetin.

Genel

GET
Sunucu Saati
GET /v1/time ile Paymos sunucu saatini Unix saniyesi olarak okuyun. Uç herkese açık; API anahtarı ya da imza gerekmez. Farkı ölçüp imzalarken uygulayın.

Faturalar

POST
Fatura Oluşturma
Kripto ödeme almak için fatura oluşturun. İki akış: doğrudan kripto (token ve ağ sabit) ve fiat (müşteri token'ı hosted checkout'ta seçer).
GET
Fatura Listele
Faturaları katı durum ve tarih filtreleriyle listeleyin, imleç sayfalamasıyla ilerleyin ve yinelenen sayfalar olmadan mutabakat yapın.
POST
Ödeme Onayı
Fiat ya da token cinsinden fiyatlanmış bir fatura için token ve ağı kendi checkout'unuzdan onaylayın, dönen depozito adresini ve ödeme ayrıntılarını gösterin.
GET
Fatura Getir
Kimliğiyle tek bir faturayı getirin, ödeme ve onay durumunu inceleyin, yanıtı kendi harici sipariş referansınızla mutabık kılın.
POST
Fatura İptali
Müşteri bir varlık kilitlemeden önce açık bir faturayı iptal edin, izin verilen durum geçişini öğrenin ve iptal yanıtını işleyin.
POST
Fatura Ödemesi Simüle Et
Sandbox faturayı bir ödeme sonucundan geçirin ve onaylanmış bir zincir üstü transferle aynı yaşam döngüsünü ve webhook'ları test edin.

Transferler

POST
Çekim Oluştur
Token bakiyesinden beyaz listedeki bir cüzdana çekim oluşturun, ödeme çıkış ağını seçin, isteği imzalayın ve durumunu izleyin.
GET
Çekim Listele
Çekimleri katı filtreler ve ileri imleç sayfalamasıyla listeleyin, hedef ağları inceleyin ve transfer geçmişini güvenilir şekilde mutabık kılın.
GET
Çekim Getir
Kimliğiyle bir çekimi getirin, mevcut durumunu ve işlem referansını inceleyin, tamamlanmayı imzalı webhook ile mutabık kılın.
POST
Çekim İptal Et
İşlem imzalama başlamadan önce bekleyen bir çekimi iptal edin, hangi durumların iptale izin verdiğini anlayın ve güncellenen yanıtı işleyin.
POST
Çekim Tamamlanması Simüle Et
Zincire işlem yayınlamadan bekleyen bir sandbox çekimini tamamlayın ve ödeme çıkışı webhook'larını uçtan uca doğrulayın.

Bakiye

GET
Bakiyeleri Sorgula
Kullanılabilir token bakiyelerini alın, tutarları kaynak ağ yerine coin bazında okuyun ve sonucu bir ödeme çıkışı oluşturmadan önce kullanın.

Ödeme kanalları

POST
Ödeme Kanalı Oluştur
Kendi harici kimliğinize bağlı, desteklenen her ağda tek kalıcı adresi olan, yeniden kullanılabilir bir yatırma kimliği oluşturun.
GET
Ödeme Kanallarını Listele
Ödeme kanallarınızı imleç sayfalamasıyla en yeniden eskiye gezin; projeye, duruma veya kendi harici kimliğinize göre filtreleyin.
GET
Ödeme Kanalı Getir
Tek bir ödeme kanalını; ağ başına kalıcı adresleri, her ağın o an kabul ettiği token'lar ve güncel komisyon oranlarınızla birlikte okuyun.
POST
Ödeme Kanalını Engelle
Kanalı silmeden, adreslerini bırakmadan ve alınmış ödemelere dokunmadan yeni yatırmaların o kanala işlenmesini durdurun.
POST
Ödeme Kanalının Engelini Kaldır
Yatırmaların kanala işlenmesini yeniden başlatın; sunucu, adres olup olmamasına göre kanalı active ya da provisioning durumuna alır.
GET
Kanal Yatırmalarını Sorgula
Onaylanmış kanal yatırmalarını yayın sırasıyla, hep ilerleyen bir imleçle sorgulayın; kesinleşmiş hiçbir ödeme atlanmaz veya sessizce tekrarlanmaz.
GET
Kanal Yatırması Getir
Tek bir kanal yatırmasını her durumda okuyun: dondurulmuş komisyon anlık görüntüsü, brüt, komisyon ve net tutarlar ile zincir üstü kanıtı.
POST
Kanal Yatırması Simüle Et
Sandbox kanal yatırmasını confirming, reorged veya confirmed aşamasına sürükleyin ve gerçek bir zincir üstü ödemenin ürettiği webhook'ları alın.

Webhook’lar

Webhook'lar
Paymos'u arka ucunuza imzalı, ortam izoleli webhook uç noktaları ve eksiksiz bir teslimat iş akışıyla bağlayın.
Webhook olayları
Açık kaynak durumu ve nihai durum anlambilimiyle 16 Paymos webhook olay türünün tamamını işleyin.
Webhook yükleri
Sürümlenmiş webhook zarfını ve data içindeki eksiksiz fatura, çekim veya kanal yatırması anlık görüntüsünü okuyun.
İmzaları doğrulama
X-Webhook-Signature başlığını HMAC-SHA256 ile doğrulayın, imzaları güvenle karşılaştırın, zaman damgası kurallarını uygulayın ve sır rotasyonunu destekleyin.
Teslimat ve yeniden denemeler
Yaklaşık 16 saat içinde 11 webhook teslimat denemesine göre tasarlayın, olayları tekilleştirin, hataları inceleyin ve toparlanma sonrası tekrar gönderin.
Webhook'ları test etme
Etkileşimli dokümantasyon playground'undan gerçek sandbox fatura ve webhook teslimat yolunu çalıştırın.

Eklentiler

WooCommerce Eklentisi
WooCommerce için resmî Paymos eklentisini kurun, proje kimlik bilgilerini bağlayın, ödeme sayfasını test edin ve siparişleri imzalı webhook ile güncelleyin.
WHMCS Eklentisi
WHMCS faturalarına stablecoin ödemesi ekleyin, Paymos'u anahtar girmeden bağlayın, webhook'u test edin ve mevcut provisioning kurallarını koruyun.
OpenCart Eklentisi
OpenCart için resmî Paymos eklentisini kurun, mağazayı secret kopyalamadan bağlayın ve test modunda ödeme durumu güncellemelerini doğrulayın.
Easy Digital Downloads Eklentisi
Paymos'u Easy Digital Downloads'a bağlayın, bir stablecoin siparişi test edin, imzalı ödeme güncellemelerini doğrulayın ve dosyaları onaydan sonra teslim edin.
CS-Cart Eklentisi
CS-Cart ve Multi-Vendor için resmî Paymos eklentisini kurun, bir proje bağlayın, imzalı güncellemeleri doğrulayın ve yayına çıkmadan bir siparişi test edin.
Magento 2 Eklentisi
Magento 2 veya Adobe Commerce için Paymos modülünü kurun, test ve canlı kimlik bilgilerini bağlayın ve siparişten faturaya durum akışını doğrulayın.
Shopware 6 Eklentisi
Shopware 6 için Paymos eklentisini kurun, satış kanalı başına etkinleştirin, imzalı işlem güncellemelerini doğrulayın ve yeniden kurmadan mod değiştirin.
PrestaShop Eklentisi
PrestaShop 8 veya 9'a Paymos ekleyin, modülü kurup mağazayı tek tıkla bağlayın, imzalı callback'i doğrulayın ve Payment accepted sipariş geçişini test edin.