
JavaScript istemcisi entegrasyonu
Tür tanımlı ve çalışma zamanı bağımlılığı yok. API'yi Node'dan veya tarayıcıdan çağırır, callback'leri Node'da denetler.
API hızlı başlangıç rehberini okuyunGereksinimler
- Node 20+ veya fetch destekli tarayıcı. Callback imza doğrulaması Node gerektirir ve node:crypto kullanır.
- Gateway temel URL’si, aktarım cüzdanı ve genel callback URL’si. Genel çağrılar API anahtarı istemez.
Kurulum ve yapılandırma
- Uygulamaya @suawave/gateway-client kurun. Çalışma zamanı bağımlılığı olmadan ESM, CommonJS ve tip tanımları sunar.
- baseUrl ile GatewayClient oluşturun; ticker, aktarım adresi ve siparişe özel callback URL’siyle publicCreate kullanın.
- Ödeme akışını kurarken publicQrCode, publicLogs, publicInfo, publicEstimate ve dönüşüm yöntemlerini gerektiği gibi kullanın.
- Node sunucusunda @suawave/gateway-client/verify içinden verifyCallbackSignature alın. publicCallbackKey değerini alıp önbelleğe koyun; callback uygulamadan tam GET URL’sini veya ham POST gövdesini doğrulayın.
Müşterinin gördükleri
Uygulamanız dönen adresi, token tutarını ve QR’ı gösterir. İstemci mağazaya ödeme yöntemi eklemez veya siparişi otomatik güncellemez; ödeme ekranını ve callback işleyicisini siz kurarsınız.
Ödemenin işleyişi
- Tutarlar ondalık dizelerdir. JavaScript number yerine tamsayı aritmetiği için sağlanan temel birim yardımcılarını kullanın.
- Her işlem iptal sinyali kabul eder; isteklerin zaman aşımı ayarlanabilir. İmza yardımcıları Node’a özel verify girişinde kalır, böylece ana istemci tarayıcılar için paketlenebilir.
USDT ödeme ağları ve ücretleri · Ödeme entegrasyon rehberleri