Suawave ve Plisio: fatura ve ödeme adresi API’leri

Kaynak kontrol tarihi

Kısa değerlendirme

İhtiyacınız olan ödeme akışına göre seçin
Suawave: Şu durumda seçin:Plisio: Şu durumda seçin:
Adresinizi kendi ödeme ekranınızda göstermek ve siparişleri callback URL’siyle izlemek istiyorsunuz.Sağlayıcının döndürdüğü bir fatura URL’sine ihtiyacınız var.

Plisio fatura oluşturma yanıtında txn_id ve invoice_url belgeler. [p-invoice]

Plisio alternatifi için ödeme ekranınızın kullandığı veriden başlayın. Suawave bir ödeme adresi ve QR endpoint’i sunar. Sipariş tutarını, referansını ve tamamlanma durumunu uygulamanızda tutun.

Suawave ile geliştirin

API farkları

Dokümantasyondaki API davranışı
KapsamSuawavePlisio
İsteklerGenel GET endpoint’leri kimlik doğrulama istemez ve JSON döndürür.Plisio /api/v1 altında sorguda api_key kullanan GET isteklerini ve JSON yanıtlarını belgeler. [p-auth]
OluşturmaGET /{ticker}/create/ address ve callback alır.Plisio order_name, order_number ve api_key ile GET /api/v1/invoices/new belgeler. [p-create]
Yanıt kimliğiaddress_in alanını ticker, callback ve iç sipariş referansınızla saklayın.Plisio fatura oluşturma yanıtında txn_id ve invoice_url belgeler. [p-invoice]
BildirimlerVarsayılan GET callback; post=1 form POST, json=1 JSON POST seçer.Plisio fatura güncellemelerini POST ile gönderir; callback_url yapılandırılmış Status URL yerine kullanılabilir. [p-callback]

Suawave’de callback URL’si yalnızca bildirim adresi değil, kalıcı eşleştirme kimliğinin parçasıdır. Sipariş referansını ve nonce değerini içine kodlayın ve URL’yi aynen saklayın. İlk create çağrısı ticker/callback çiftinin seçeneklerini sabitler. Yeni sipariş kimliği yeni callback URL’si gerektirir.

Desteklenen varlıklar: bep20/usdc (BSC), bep20/usdt (BSC), trc20/usdt (TRON). Güncel istek ve yanıt yapıları için dokümantasyona bakın. Ticker ve ağlar · API referansı

Geçiş adımları

  1. Fatura arayüzünü ve ödeme ekranını değiştirin

    Üretilen ticker listesinden desteklenen Suawave varlık ve ağını seçip minimumu okuyun. Beklenen tutarı siparişte saklayın. Barındırılan fatura URL’si beklemek yerine dönen adresi ve QR’ı gösterin. Olayı işlemeden imzayı doğrulayan ayrı Suawave callback işleyicisi kurun.

  2. Aktarım adresi ve callback ile yeni siparişler oluşturun

    GET /{ticker}/create/ çağrısına address ve URL kodlaması uygulanmış HTTPS callback gönderin. Callback URL’sine sipariş referansını ve tahmin edilemez nonce ekleyip sunucuda saklayın. Dönen address_in alanını sağlayıcı ve ticker ile kaydedin. Başka sağlayıcının ödeme adresini yeniden kullanmayın.

  3. Callback doğrulamasını ve sipariş tamamlamayı değiştirin

    x-ca-signature değerini Suawave GET /pubkey/ anahtarıyla doğrulayın. GET callback için tam özgün URL’yi; POST için ayrıştırmadan önce ham gövdeyi koruyun. Sipariş, nonce, varlık, adres ve tutarı kontrol edip uuid ile tekrarları eleyin. Yalnızca pending 0 olduğunda siparişi tamamlayın ve HTTP 200 ile *ok* döndürün.

  4. Yeni siparişleri yönlendirin, eskileri uzlaştırın

    Mevcut siparişlerde özgün sağlayıcıyı ve callback işleyicisini etkin tutun. Yalnızca yeni siparişleri Suawave’e yönlendirin. Akışı müşterilere açmadan geçerli ve bozulmuş imzaları, yinelenen iletileri, onaydan sonra gelen bekleyen olayları, eksik ödemeleri ve callback hatalarını deneyin. Suawave loglarını yedek sorgulama yolu olarak kullanın.

Adaptörü değiştirirken bu rehberleri kullanın: Hızlı başlangıç · Callback sözleşmesi · İmza doğrulama örnekleri

Ücretler ve minimumlar

Plisio Gateway API ve White Label seçeneklerini ayrı fiyatlandırır. [p-fees]

Beklediğiniz varlık ve ödeme tutarı için aşağıdaki sağlayıcı fiyat kaynağına ve ücret dokümantasyonumuza bakın. Ücretler ve minimumlar

Sık sorulan sorular

Kendi sipariş numaramı kullanabilir miyim?

Evet. Uygulamada saklayıp tahmin edilemez nonce ile URL kodlamalı callback içine ekleyin. Suawave özel sorgu parametrelerinizi callback ile geri gönderir; bunları saklanan siparişle karşılaştırın.

Suawave callback bildirimleri GET kullanmak zorunda mı?

Hayır. Eşleştirmeyi oluştururken form POST için post=1, JSON POST için json=1 ayarlayın. İkisi de varsa JSON önceliklidir. İmza doğrulaması için ham POST gövdesini koruyun.

Mevcut ödeme adresleri entegrasyonla taşınabilir mi?

Her yeni ticker ve callback çifti için Suawave üzerinden yeni adres oluşturun. Mevcut ödeme talimatlarını ve açık siparişleri uzlaştırılana kadar özgün sağlayıcıda tutun.

Toplam maliyeti nasıl karşılaştırırım?

İlgili varlık ve beklenen ödeme tutarı için bağlantıdaki sağlayıcı fiyatlarını ve Suawave ücret ve minimumlarını okuyun. Yalnızca ilan edilen oranı değil, hizmet ücretini, ağ ücretini ve minimumları birlikte değerlendirin.

Kaynaklar ve yöntem

Bu, Suawave tarafından yayımlanan bir dokümantasyon karşılaştırmasıdır. Seçim önerileri belgelenmiş özelliklere dayanır; ödeme performansı testi değildir. Her dipnot sağlayıcının kendi dokümantasyonuna veya fiyat sayfasına bağlantı verir ve kontrol tarihini belirtir.

USDT ödeme ağları ve ücretleri · Mağaza eklentileri ve geliştirici araçları · Ödeme entegrasyon rehberleri