Hosted checkout ile kripto fatura API’si
Kripto faturalarını programatik olarak oluşturun, her ödeme için bir hosted checkout bağlantısı alın ve fatura başına sabit kur ile nihai durum webhooklarını alın.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR"
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Kripto fatura API’si
- externalId eşleştirmesi
- Yanıtta redirectUrl
- Nihai durumda webhook
x-api-key: sk_live_…
{
"id": "order_1024",
"status": "paid"
}1 istek, 1 yönlendirme, 1 webhook
Ödeme oluşturun, müşteriyi yönlendirin ve son webhook’u işleyin — tüm entegrasyon tek sayfaya sığar.
externalId, tutar, para birimi ve URL’lerle ödeme oluşturun.
Müşteriyi data.redirectUrl adresine yönlendirin.
Son durum webhook’unu alın: wait, processing, completed veya rejected.
Kendi para biriminizde tahsil edin, muhasebe USD
currency alanıyla herhangi bir ISO-4217 para biriminde tutar belirtin, ör. INR, RUB veya EUR. Alan yoksa tutar eskisi gibi USD’dir.
- Qvard kuru ödeme oluşturulduğunda bir kez sabitlenir. Ödeyen, tutarı kendi para biriminizde ve ödediği tokendeki tutarı görür; ödeme USD olarak kaydedilir.
- Limitler dönüşümden sonra USD üzerinden kontrol edilir. Tutar aralık dışındaysa hata metninde limit sizin para biriminizde gösterilir.
- Güncel kurlar kur sayfasında ve API’de: GET /api/v1/rates, anahtar gerekmez. Mağaza ayarlarında her para birimi için kendi kurunuzu belirleyebilirsiniz.
- Hatalar: 422 unsupported_currency — desteklenmeyen para birimi; 422 rate_unavailable — kur yok; 422 invalid_amount_precision — para biriminin izin verdiğinden fazla ondalık basamak (JPY 0, KWD 3, çoğu 2).
curl "https://api.qvard.com/api/v1/rates?currencies=EUR,INR"
// 200 OK
{ "data": { "base": "USD", "updatedAt": "…", "rates": { "EUR": 0.92, "INR": … } } }Webhook imzalarını doğrulayın
Her Qvard webhook’u HMAC-SHA256 ile imzalanır. Node.js ve PHP için hazır kod ile imzayı nasıl doğrulayacağınızı ve sahte imzalardan nasıl korunacağınızı öğrenin.
SSS
A quick overview of how Qvard handles payments, integration and merchant operations.
Qvard nedir?
Qvard, hosted checkout, faturalar, API ödemeleri ve merchant bakiyeleri sunan işletmeler için bir kripto ödeme ağ geçididir.
Hangi varlıklar destekleniyor?
Qvard USDT, USDC, BTC, LTC, TRX, BNB ve ETH ödemelerini destekler. TON ve TON üzerindeki USDT yakında.
Geliştiriciler için uygun mu?
Evet. Qvard; API ödemeleri, redirectUrl, webhook'lar, yeniden denemeler ve teslimat günlükleri içerir.
Checkout'u özelleştirebilir miyim?
Checkout; merchant logosu, mağaza adı, buton rengi ve yerelleştirmeyi destekler. Özel dönüş URL'leri yakında.
Başlamak için ne gerekiyor?
Bir merchant hesabı oluşturun ve işletme doğrulamasını tamamlayın. Bir test faturasıyla akışı denedikten sonra hosted checkout veya API bağlantısını kurun ve gerçek ödemeleri kabul etmeye başlayın.
Çekimler nasıl çalışır?
Fonlar, varlık ve ağ bazında ayrılan merchant bakiyelerinde takip edilir. Çekimi manuel yapabilir veya otomatik ödemeler için çekim kuralları tanımlayabilirsiniz.