Kripto ödeme oluşturun ve redirectUrl alın
Tek bir API çağrısıyla kripto ödeme oluşturma ve redirectUrl alma: POST /api/v1/payment, x-api-key başlığı, kendi para biriminizdeki fiyat (varsayılan USD) ve ödemeye yönlendirme.
Ödeme oluşturmak ve redirectUrl almak, Qvard Host-to-Host API v1’de tek bir istektir. Bu rehber istek alanlarını, yanıtı ve müşteriyi ödeme sayfasına güvenle nasıl göndereceğinizi anlatır.
İstek alanları
x-api-key başlığıyla /api/v1/payment adresine POST gönderin. id kendi işlem numaranızdır, price tutarı belirtir, currency ise isteğe bağlı bir ISO-4217 kodudur (ör. INR, RUB veya EUR; varsayılan USD), paymentSystemId ise isteğe bağlıdır. Yanıtı kaydınızla eşleştirebilmek için id değerini sipariş başına benzersiz tutun. Desteklenmeyen para birimi 422 unsupported_currency, o para birimi için fazla ondalık basamak 422 invalid_amount_precision, kuru olmayan para birimi 422 rate_unavailable ile reddedilir.
Yanıtı okumak
Yanıtta ödeme id’si ve redirectUrl bulunur. redirectUrl, https://my.qvard.com/pay/ adresinin ardına ödeme id’sini ekleyerek oluşan hosted sayfaya işaret eder. Müşteriyi yönlendirmeden önce iki değeri siparişle birlikte saklayın.
Müşteriyi yönlendirmek
Müşteriyi normal bir HTTP yönlendirmesiyle ya da sitenizdeki bir bağlantıyla redirectUrl’e gönderin. Hosted sayfada müşteri varlık ve ağı seçer ve tam tutarı sabit kurla görür.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Hatalar ve yeniden denemeler
Bir istek başarısız olursa aynı siparişin iki ödeme almaması için yeniden göndermeden önce kayıtlarınıza bakın. Yanıt gövdesini destek için kaydedin ve yalnızca o sipariş için ödeme olmadığını doğruladıktan sonra yeniden deneyin.
Sık yapılan hatalar
x-api-key’i ön yüz kodunuza koymayın, yönlendirmeyi ödeme onayı saymayın ve fiyatı currency alanında belirtilenden farklı bir para biriminde göndermeyin. Son durum her zaman webhook ile gelir.
Bir online sipariş, adım adım
Alıcı öde düğmesine bastığında sunucunuz, sipariş numarası ve sepet toplamıyla ödemeyi oluşturur, ardından alıcıyı redirectUrl’e yönlendirir. Webhook ödendi bildirdiğinde siparişi ödendi olarak işaretlersiniz.
FAQ
paymentSystemId göndermek zorunda mıyım?
Hayır, isteğe bağlıdır. Belirli bir ödeme yöntemi istediğinizde gönderin; aksi halde hosted sayfa mevcut seçenekleri sunar.
Bir redirectUrl’i başka bir sipariş için yeniden kullanabilir miyim?
Hayır. Her ödemenin kendi redirectUrl’i vardır. Her sipariş için yeni bir ödeme oluşturun.
Müşteri e-postayla gönderdiğim bağlantıdan ödeme yapabilir mi?
Evet. redirectUrl sıradan bir HTTPS sayfasıdır, e-postada veya sohbette çalışır. Paneldeki kodsuz ödeme linki yol haritasındadır.
Müşteri ne kadar öder?
Hosted sayfa, seçilen varlık için fatura süresi boyunca sabit kurla tam tutarı gösterir.
