Bu sayfada
Onayla
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.
API anahtarı: Payment
Hâlâ awaiting_client durumunda olan bir fatura için stablecoin ve ağı onaylayın. Tutar ister fiat ister token cinsinden fiyatlanmış olsun, çağrı depozito adresini atar ve faturayı awaiting_payment durumuna taşır. Fiat cinsinden fiyatlanmış faturada aynı anda kur da kilitlenir. Tutar zaten token cinsindense kilitlenecek kur yoktur: onayladığınız token, fatura oluşturulurken istenen token olmalıdır; oluşturmada bir ağ sabitlendiyse ağ da aynı olmalıdır.
Bunu, kendi ödeme sayfanızı çizdiğinizde ve token seçimini kendi sunucunuzda topladığınızda kullanın. Ödemeyi Paymos kendi tarafında yürütüyorsa — payment_url adresindeki barındırılan sayfa, iframe gömmesi, Low-Code SDK ya da Telegram botu projesinde payment_url adresinin bunun yerine açtığı Paymos botu — seçim aynı yoldan onaylanır ve bu uç noktayı çağırmanız gerekmez. Uç nokta projenin kanalına bağlı değildir: Telegram botu projesinde de sunucu tarafında onaylayabilirsiniz, o zaman ödeyen kişinin açtığı bağlantı doğrudan depozito adresine gider ve seçim adımı görünmez.
Burada elinize geçen bir uç noktadır; markası size ait hazır bir ürün değil. Ödeme sayfasını kendiniz, kendi alan adınızda kurmanızı sağlar; Paymos'un barındırdığı sayfalarda ise hiçbir şeyi değiştirmez: orada her temada ve her gömme biçiminde "Secured by Paymos" satırı durur, kendi alan adınıza taşınan bir ödeme sayfasını da Paymos sunmaz.
İstek gövdesi
| Parametre | Tür | Zorunlu | Açıklama |
|---|---|---|---|
currency |
string | Evet | Müşterinin ödeme için seçtiği stablecoin (örn. USDT, USDC). Faturanın projesinde etkin olmalı |
network |
string | Evet | Müşterinin ödeme için seçtiği ağ (örn. TRC20, BASE) — o token'ın etkin olduğu bir ağ olmalı |
{
"currency": "USDT",
"network": "TRC20"
}
Yanıt (200 OK)
Tam faturayı, artık doldurulmuş payment bölümüyle döndürür — seçilen currency / network, atanan depozito address, fiat cinsinden fiyatlanmış faturada kilitlenen exchange_rate ve beklenen expected kripto tutarı. Bu çağrı işyeri anahtarınızla kimliği doğrulandığı için yanıt, yalnızca işyerine açık fee ve net alanlarını da taşır. Gövde, Fatura sorgulama ile aynı biçime sahiptir.
Hatalar
Tam katalog için Hata Kodları bölümüne bakın. Her hata yanıtındaki type URI'si, ilgili satıra doğrudan bağlanır. Size ait olmayan bir faturayı onaylamak 404 döndürür. expired veya cancelled bir fatura 410 döndürür; awaiting_client sonrasındaki diğer tüm durumlar — nihai paid, paid_over ve underpaid dahil — 409 döndürür.