Kripto ödeme geçidi nedir ve nasıl çalışır?

Kripto ödeme geçidi, müşterinizin cüzdanı ile sipariş sisteminiz arasında duran hizmettir: ödeme talebini oluşturur, blokzinciri izler, para geldiğinde mağazanıza haber verir ve siz çekene kadar fonları tutar. Bu rehber bunun pratikte nasıl çalıştığını ve seçmeden önce nelere bakmanız gerektiğini anlatır.

Kripto ödeme geçidi ne yapar

Geçit olmadan kripto kabul etmek; her müşteriye bir cüzdan adresi vermek, blokzinciri kendiniz izlemek, gelen transferleri siparişlerle eşleştirmek ve her istisnayı elle çözmek demektir. Bir geçit dört işi üstlenir:

Ödemeyi oluşturur. Sisteminiz belirli bir tutarda ödeme ister; geçit yalnızca o sipariş için bir ödeme sayfası veya adres döndürür.
Ağı izler. Transferin geldiğini görür, onayları sayar ve ödemenin ne zaman kesinleştiğine karar verir.
Size bildirir. Mağazanıza, genellikle webhook ile, 1024 numaralı siparişin ödendiğini söyler; böylece gönderim yapabilir veya erişim açabilirsiniz.
Fonları tutar ve taşır. Gelen para işletme bakiyesine düşer ve siz onu kendi cüzdanınıza çekersiniz.

Geçit, anahtarlarını sizin tuttuğunuz bir cüzdan değildir ve bir borsa da değildir. Ödeme altyapısıdır: kartlı ödemede bankanın ve ödeme işlemcisinin genellikle sizden sakladığı kısmın blokzincirler için yeniden kurulmuş hâlidir.

Bir ödeme geçitten nasıl geçer

Her geçit biraz farklı çalışır, ancak bir ödemenin yolu şöyledir:

Sunucunuz bir ödeme oluşturur: sipariş numarası ve genellikle dolar cinsinden bir tutar.
Müşteri ödeme sayfasını açar ve bir varlık ile ağ seçer, örneğin TRON üzerinde USDT. İşletme yöntemi önceden de seçebilir.
Geçit döviz kurunu sınırlı bir süre sabitler; böylece müşteri öderken göndermesi gereken tutar değişmez. Qvard'da kur bir saat boyunca sabitlenir.
Müşteri, kendi cüzdanından o ödeme için gösterilen adrese tam tutarı gönderir.
Geçit ağı izler, onayları bekler ve ödemeyi ödendi olarak işaretler.
Sunucunuzu bilgilendirir. Kodunuz siparişi ödendi olarak işaretler ve ürünü teslim eder.
Para işletme bakiyenizde görünür. Onu elle veya belirlediğiniz bir kuralla cüzdanınıza çekersiniz.

Gerçek ödemeler her zaman kusursuz gitmez: müşteriler eksik, fazla veya kurun süresi dolduktan sonra gönderir. İyi bir geçitte her durum için tanımlı bir ödeme durumu bulunur; mutabakatı elle yapmak size kalmaz. Qvard'da ödeme durumları wait, partial, completed ve rejected'dır.

Geçit, cüzdan, borsa ve ödeme işlemcisi: fark nedir

Bu terimler sık karıştırılır:

Cüzdan. Anahtarları saklar, göndermenizi ve almanızı sağlar. Ödemeleri siparişlerle eşleştirmez, mağazanıza haber vermez.
Borsa. Bir varlığı başka bir varlıkla takas eder. Bazı borsalar işletmelere yönelik araçlar sunar, ancak asıl işleri alım satımdır.
Ödeme geçidi. Siparişleriniz için ödemeleri oluşturur, takip eder ve durumlarını bildirir. Bu rehberin konusu budur.
Ödeme işlemcisi veya acquirer. Kartlı ödemelerde bankalar arasında para taşıyan şirket. Kriptoda «acquiring» sözcüğü tüm hizmet için gelişigüzel biçimde kullanılır; ikisinin farkı için kripto acquiring ile kripto ödeme geçidi yazısına bakın.

Custodial mı, non-custodial mı

Her geçidin arkasındaki en önemli tasarım kararı, ödeme ile sizin çekiminiz arasında fonları kimin tuttuğudur.

Custodial bir geçitte gelen ödemeler sağlayıcının kontrol ettiği adreslere gider ve işletme bakiyenize yazılır. Sonra siz çekersiniz. Bu, mutabakatı kolaylaştırır ve geçidin otomatik çekim gibi özellikler sunmasını sağlar; ancak çekene kadar sağlayıcıya bağımlısınız, bu yüzden çekim koşulları önemlidir.

Non-custodial modelde ödemeler doğrudan cüzdanınıza gider. Anahtarlar sizde kalır, sağlayıcı yalnızca ödemeyi izler. Bu, karşı taraf riskini azaltır ve anahtar yönetimini size bırakır.

Qvard custodial'dır: ödemeler işletme bakiyesine yazılır ve siz cüzdanınıza bir kurala göre otomatik olarak ya da elle çekim yaparsınız. Cüzdana çekim yalnızca ağ ücretine mal olur; banka hesabına çekim yoktur.

Stablecoin'ler ve ağlar: ağ neden önemli

Aynı varlık birkaç blokzincirde bulunabilir. Örneğin USDT, TRON (TRC-20), Ethereum (ERC-20) ve BNB Smart Chain (BEP-20) üzerinde vardır. Bir transfer yalnızca ödeme sayfasının istediği ağda geçerlidir; ücretler ve hız ağlar arasında farklıdır.

Bu yüzden geçit varlığı ve ağı birlikte gösterir ve müşterinin seçimi açık olmalıdır. İşletme için pratik sonuçlar şunlardır:

hangi ağları kabul edeceğinize karar verin ve geçidin onları desteklediğini kontrol edin;
ağ ücretlerinin geçide değil, zincire ve ağ yoğunluğuna bağlı olduğunu unutmayın;
dolar cinsinden fiyatlama için stablecoin'leri tercih edin; çünkü oynak bir varlıkla yapılan ödeme, çektiğiniz anda belirgin biçimde daha az değer taşıyabilir.

Qvard şu anda başlıca ağlarda USDT ve USDC'yi, ayrıca kendi ağlarında BTC ve LTC'yi kabul eder; TON yakında geliyor. Tam liste desteklenen coin'ler ve ağlar sayfasındadır.

Geçit seçmeden önce nelere bakmalı

Kullanışlı bir geçidi riskli olandan ayıran kısa bir liste:

Ağlar ve varlıklar. Müşterilerinizin gerçekten kullandıklarını destekliyor mu?
Ücretler. Geçit ne alıyor, ayrıca ağ ücreti ne kadar? Hangisini kim ödüyor?
Fonlar ve çekimler. Parayı kim tutuyor, çekimler nasıl işliyor, ihtiyaç duyabileceğiniz limitler veya fiat seçenekleri var mı?
API kalitesi. Aynı sipariş numarasıyla bir ödemeyi güvenle birden fazla kez oluşturabiliyor musunuz? Hatalar anlaşılır mı? Sunucunuz kapalıysa webhook yeniden deneniyor mu?
Olağan dışı ödemeler. Eksik ödeme, fazla ödeme ve süresi dolmuş ödemeler nasıl ele alınıyor?
Test. Akışı gerçek para hareket ettirmeden deneyebiliyor musunuz?
Destek ve dokümantasyon. Bir ödeme takıldığında kim yanıt veriyor?

Kripto ödeme sağlayıcısı nasıl seçilir bu listeyi daha ayrıntılı ele alır.

Asgari bir entegrasyon neye benzer

Ödeme oluşturmak tek bir istektir. Qvard ile kendi sipariş numaranızı ve ABD doları cinsinden tutarı gönderirsiniz; karşılığında bir ödeme kimliği ve barındırılan ödeme sayfasına bir bağlantı alırsınız. Müşteriyi oraya yönlendirirsiniz; varlığı seçmek ve transferi göndermekle ilgili her şey o sayfada olur.

Gönderdiğiniz id sipariş numaranızdır: aynı ödeme yöntemi için aynı id'yi yeniden göndermek, kopya oluşturmak yerine mevcut ödemeyi döndürür; bu da yeniden denemeleri güvenli kılar. Müşteri ödediğinde Qvard sunucunuza aynı id ve ödeme durumuyla bir webhook gönderir. Arka ucunuz için kod örnekli tam akış bir web sitesinde kripto ödeme nasıl kabul edilir yazısındadır; API referansı geliştiriciler sayfasındadır.

curlPOST /api/v1/payment

curl -X POST https://api.qvard.com/api/v1/payment \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "id": "order_1024", "price": 149.99 }'

# 201 Created
{ "id": "8f3k2a1c", "redirectUrl": "https://my.qvard.com/pay/8f3k2a1c" }

Sık yapılan hatalar

Yönlendirmeye güvenmek. Müşterinin «teşekkürler» sayfanıza dönmesi ödediğini kanıtlamaz. Siparişi yalnızca geçit nihai bir durum bildirdiğinde ödendi olarak işaretleyin.
Kısmi ödemeleri yok saymak. Müşteri tutardan az gönderdiyse sipariş ödenmemiştir. Farkı isteyip istemeyeceğinize ya da iade edip etmeyeceğinize önceden karar verin.
Webhook yeniden denemesini test etmemek. Sunucunuz bir webhook isteğine hatayla yanıt verirse bildirim yeniden denenmelidir ve işleyiciniz aynı olayı iki kez almayı sorunsuz karşılayabilmelidir.
Oynak bir varlıkla fiyatlamak. Fiyat riskini taşıyamıyorsanız dolar cinsinden fiyat verin ve müşterinin stablecoin ile ödemesine izin verin.
Çekim yolunu test etmemek. Gerçek gelir için geçide güvenmeden önce küçük bir tutarı çekin.

Qvard nerede yer alıyor

Qvard, işletmeler için custodial bir kripto ödeme geçididir. Bugün API ile bir ödeme oluşturur, müşteriyi barındırılan ödeme sayfasına yönlendirir, nihai durumu webhook ile alır ve işletme bakiyenizden bir cüzdana çekim yaparsınız. Ödeme kabul etmenin diğer yolları, yani ödeme bağlantıları, gömülü pencere, SDK ve kasa terminali geliştirme aşamasındadır. Hesap açmadan önce gerçek ödeme sayfasını bir demo faturayla görebilirsiniz; ücretlerin nasıl işlediğini fiyatlandırma sayfası açıklar.

FAQ

Kripto ödeme geçidi ile kripto cüzdanı aynı şey mi?

Hayır. Cüzdan anahtarları saklar ve transfer gönderir. Geçit ise belirli bir sipariş için ödeme oluşturur, blokzincirde takip eder, durumunu mağazanıza bildirir ve siz çekene kadar parayı işletme bakiyesinde tutar.

Kripto ödemesi geri alınabilir mi?

Hayır. Blokzincirde onaylanmış bir transfer kesindir. Bir müşteriye iade yapmanız gerekirse yeni bir transferi kendiniz gönderirsiniz; bu yüzden ödeme kabul etmeye başlamadan önce iade politikanızı belirleyin.

Bir ödemenin onaylanması ne kadar sürer?

Ağa ve geçidin kaç onay beklediğine bağlıdır. Bazı ağlar saniyeler içinde onaylar; Bitcoin ise yaklaşık her on dakikada bir blok üretir. Müşteri beklerken ödeme sayfası durumu gösterir.

Kendi tarafımda bir şey geliştirmem gerekir mi?

Ödemeyi arka ucunuzdan oluşturmanız ve durumunu bildiren webhook'u işlemeniz gerekir. Ödeme sayfasından blokzincir izlemeye kadar geri kalan her şeyi geçit yapar.

Kripto ödeme geçidi nedir?