Üç istekle kripto ödeme API'si: fatura oluşturun, durumu kontrol edin, bakiyeyi görün

Satıcı API'sinde üç yöntem vardır. Bir fatura oluşturursunuz, durumunu okursunuz ve bakiyenizi görürsünüz. Müşteri ödeme sayfasında öder, siz de bunu webhook üzerinden ya da durumu sorgulayarak öğrenirsiniz.

Kimlik doğrulama

Her istek iki başlık taşır: X-Public-Key ve X-Private-Key. Genel anahtar satıcıyı tanımlar, bu yüzden gövdede bir mağaza kimliği göndermezsiniz. Özel anahtar yalnızca oluşturulduğunda bir kez gösterilir; kaybederseniz yeniden oluşturun, eskisi anında geçersiz kalır. Sınır dakikada 60 istektir.

Fatura oluşturma

amount ve currency ile POST /api/v1/payments isteği gönderin. Tutar 0.01'den başlar; para birimi RUB, USD, EUR, CNY, GBP, CHF, JPY veya KZT gibi bir fiat para birimi ya da USDT veya USDC olabilir. Kullanışlı isteğe bağlı alanlar: order_id (kendi numaranız, en fazla 80 karakter), purpose (açıklama), ttl_minutes (5 ile 1440 arasında geçerlilik süresi, varsayılan 30), return_url (ödeme sonrası müşterinin yönlendirileceği adres) ve müşterinin nasıl ödeyeceğini zaten biliyorsanız network ile birlikte crypto.

Yanıt, ödeme sayfası bağlantısını callback_url içinde barındırır. Müşteriyi oraya yönlendirin. crypto ve network gönderdiyseniz yanıt ayrıca adresi, gönderilecek tutarı ve bir QR kodu da içerir.

Durumlar

Bir fatura waiting, paid, expired veya cancelled durumundadır. Müşteri bir ağ seçtikten sonra nesnede adres, coin ve komisyon de yer alır. Ödeme sonrasında ise durum paid olur, işlem kimliği (transaction id) ve zaman bilgisi eklenir. Geçerlilik süresi dolmuş, hâlâ waiting durumundaki bir fatura, bir sonraki sorgulamada expired olur.

Bakiye

GET /api/v1/wallet, kullanılabilir ve dondurulmuş USDT bakiyesini döner. Hesaptaki tüm satıcılar tek bir bakiyeyi paylaşır. Test ödemeleri buna hiç dokunmaz.

Yayına almadan önce test edin

Test modundaki bir satıcı, sandbox faturaları oluşturur. Ödeme sayfasında faturayı ödendi olarak işaretleyen bir buton bulunur ve bakiyeniz hesaba geçmez. Gerçek transferleri kabul etmek için satıcıyı canlıya (live) geçirin.

curl, JavaScript ve PHP örnekleriyle tam referans geliştirici sayfasında yer alır.