E-ticaret için kripto ödemeleri

Bir online mağaza için kripto, kartların yanında ek bir ödeme yöntemidir, onların yerine geçmez. Kartı mağazanızda çalışmayan müşterilere ulaşır, kart chargeback'lerini ortadan kaldırır ve dolar bazlı stablecoin'lerle ödeme almanızı sağlar. Bu rehber, ödeme adımında nereye oturduğunu, ödeme durumlarını sipariş durumlarına nasıl eşleyeceğinizi, zor durumların nasıl ele alınacağını ve Qvard'da bugün neyin hazır olup neyin olmadığını anlatıyor.

Kripto bir mağazaya ne katar, ne katmaz

Beklentinizi net tutun; çünkü kripto bir büyüme düğmesi değildir.

Kart altyapınızın ıskaladığı müşteriler. Banka kartı yabancı mağazalarda reddedilen ya da ödeme işlemcinizin hizmet vermediği ülkelerde yaşayan alıcılar yine de dolar bazlı bir stablecoin ile ödeme yapabilir.
Kart chargeback'i yok. Gönderen kripto transferini geri alamaz; bu yüzden itiraz edilen kart ödemeleri bu siparişler için risk değildir. İade, göndermeye karar verdiğiniz bir transfere dönüşür.
Kart kaynaklı engeller olmadan sınır ötesi satış. Aynı ödeme sayfası dünyanın her yerindeki müşteri için çalışır.
Siparişlerin mütevazı bir payı. Ödeme sayfasında ek bir seçenek olarak ele alın. Çoğu mağazada kartların yerini almaz ve kart akışını karmaşıklaştırmasına izin vermemelisiniz.

Dijital ürün satıyorsanız dijital ürün mağazaları için kripto ödemeleri yazısını okuyun; oradaki teslimat kuralları her anlık ürün için geçerlidir.

Ödeme adımında nereye oturur

“Kriptoyla öde” seçeneğini ayrı bir mağaza olarak değil, mevcut yöntemlerin yanına bir ödeme yöntemi daha olarak ekleyin. Düzenli bir yerleşim:

Müşteri sepeti ve adresi her zamanki gibi doldurur ve “Kriptoyla öde”yi seçer.
Sunucunuz siparişi bekleyen durumda oluşturur, ardından bu sipariş için bir ödeme oluşturur.
Müşteriyi, bir varlık ve ağ seçip kendi cüzdanından ödeme yaptığı barındırılan ödeme sayfasına yönlendirirsiniz.
Ödeme tamamlandığında sunucunuz bir webhook alır ve siparişi ilerletir.

Fiyatı mağaza para biriminizle gösterin, ABD doları olarak tahsil edin: ödeme dolar cinsinden oluşturulur ve müşteri seçtiği varlıktaki karşılığını bir saat boyunca sabit tutulan kurla öder. Mağazanız dolar bazlı değilse ödemeyi oluşturmadan önce sipariş toplamını çevirin.

Ödemeyi oluşturun ve kendi sipariş numaranızı kullanın

Ödemeyi arka ucunuzdan https://api.qvard.com/api/v1/payment adresine tek bir POST ile oluşturun. İstek, anahtarınızı Authorization: Bearer başlığında taşır; JSON gövdesinde sipariş numarası id, ABD doları cinsinden tutar price olarak yer alır, sayfanın belirli bir varlık ve ağ seçili olarak açılmasını istiyorsanız isteğe bağlı paymentSystemId de eklenir. Yanıt, redirectUrl içeren 201 olur.

id olarak kendi sipariş numaranızı kullanın: webhook'ta geri gelir, yani ödemeyi siparişe bağlayan anahtardır. Aynı ödeme yöntemi için aynı id ile istek tekrarlanırsa mevcut ödeme döner; böylece çift tıklama veya yeniden denenen istek iki ödeme oluşturmaz. Kod içeren tam anlatım bir web sitesinde kripto ödemesi nasıl kabul edilir yazısında yer alıyor.

Ödeme durumlarını sipariş durumlarına eşleyin

Bir ödemenin dört durumu vardır ve siparişinizde her biri için net bir kural bulunmalıdır:

wait: ödeme oluşturuldu, müşteri ödemedi. Sipariş ödeme bekliyor.
partial: tam tutardan az geldi. Siparişi bekletin, ne kadar eksik olduğunu söyleyin ve müşterinin kalanı göndermesine izin verin ya da iptal edip iade edin.
completed: tam tutar geldi. Webhook'u tetikleyen durum budur ve malı serbest bırakması gereken tek durumdur.
rejected: ödeme reddedildi. Başka bir ödeme yolu sunun.

Örnek eşlemeyi küçük bir tablo olarak gösterir. İki kural onu güvenli tutar: ödenmiş siparişi asla önceki bir duruma döndürmeyin ve siparişi completed dışında hiçbir durumda teslim etmeyin. Webhook işleyicisi ayrıca idempotent olmalı ve yanıtı tam olarak HTTP 200 olmalıdır; bkz. kripto ödeme webhook'ları nasıl güvenli hale getirilir.

Node.jsorder-status.js

// Qvard payment status -> your order state. Only "completed" releases goods.
const ORDER_STATE = {
  wait:      'pending_payment',   // created, the customer has not paid yet
  partial:   'on_hold',           // less than required arrived: ask for the rest or refund
  completed: 'paid',              // full amount arrived: start fulfilment
  rejected:  'payment_failed'     // rejected: offer another way to pay
};

function nextState(current, qvardStatus) {
  const target = ORDER_STATE[qvardStatus];
  if (!target) return current;                    // unknown status: change nothing
  if (current === 'paid') return current;         // never move a paid order backwards
  return target;
}

Kısmi ödemeler, süresi dolan siparişler ve iadeler

Mağazaların en çok zamanını alan durumlar bunlardır:

Daha az ödeyen müşteriler. Bir borsanın çekim ücreti çoğu zaman tutardan düşülür ve ödeme eksik gelir. Farkı isteyip istemeyeceğinize veya iade edip etmeyeceğinize karar verin ve sipariş sayfasında gösterin.
Geç ödeyen müşteriler. Kur bir saat sabittir. Sipariş terk edildikten çok sonra gelen ödemeyi otomatikleştirmek yerine destek vakası olarak ele alın.
Stok. Ödenmemiş siparişler için stok ayırıyorsanız sipariş süresi dolunca serbest bırakın.
İadeler. Kripto ödemesini siz de geri alamazsınız; iade, müşterinin cüzdanına gönderdiğiniz bir transferdir. Kuralı kullanım koşullarınıza yazın ve iade adresini ödemeden almak yerine müşteriden isteyin.
Siteye dönüş. Ödeme sonrası dönüş URL'leri henüz yok, bu yüzden müşteri siteye kendi başına döner. Başarıyı varsayan bir teşekkür sayfası yerine gerçek durumu gösteren bir sipariş sayfası verin.

Fiyatlandırma, ücretler ve muhasebe

Para tarafını basit tutun.

Dolar cinsinden fiyat, dolar cinsinden tahsilat. Sipariş değerini sipariş anında dolar olarak kaydedin ve mutabakat için ödemenin id değerini yanında saklayın.
Maliyet. Abonelik ücreti yoktur. Komisyon projenize özeldir ve fiyatlandırma sayfasına göre %1'den başlar, %0,1'e kadar inebilir.
Parayı çekmek. Fonlar Qvard bakiyenizde durur ve kendi cüzdanınıza çekersiniz; çekim yalnızca ağ ücretine mal olur. Fiat banka hesabına çekim mevcut değildir, bu yüzden nakde ihtiyacınız varsa zaten kullandığınız bir hizmet üzerinden çıkış planlayın.
Vergi ve muhasebe. Kripto tahsilatlarının vergi ve muhasebe açısından nasıl ele alınacağı ülkenize bağlıdır; yayına almadan önce muhasebecinizle netleştirin.

Bugün neler hazır

Qvard API üzerinden çalışır: mağazanız ödemeyi oluşturur ve webhook'u alır. Mağaza platformları için hazır bir eklenti henüz yok, ödeme bağlantıları ve ayrı bir sandbox geliştirme aşamasında ve müşteriler siteye kendi başlarına döner. Platformunuz WordPress ise çalışan kod için WordPress için kripto ödemeleri yazısına bakın. Kabul edilen varlıklar ve ağlar için desteklenen paralar, istek biçimleri için geliştirici belgeleri sayfasına bakın; müşterinizin ne göreceğini görmek için bir demo fatura açın.

FAQ

Kripto mağazamda kartların yerini alacak mı?

Hayır. Kartı mağazanızda çalışmayan veya stablecoin tercih eden müşteriler için ek bir seçenek olarak en iyi şekilde çalışır. Kart akışını olduğu gibi bırakın.

Bir siparişi ne zaman ödendi olarak işaretlemeliyim?

Yalnızca Qvard completed durumu için webhook gönderdiğinde. Müşterinin siteye dönmesi ödeme kanıtı değildir ve partial durumu gerekenden az tutar geldiği anlamına gelir.

Kriptoda iadeler nasıl yapılır?

Gönderen kripto ödemesini geri alamaz; bu yüzden iade, müşterinin cüzdanına gönderdiğiniz bir transferdir. Kuralı kullanım koşullarınızda tanımlayın ve iade adresini müşteriden isteyin.

Mağaza platformum için eklenti var mı?

Henüz yok. Bugün entegrasyon API üzerinden yapılır: ödeme oluşturmak için bir istek ve sonucu almak için bir webhook.