Kullanım senaryoları

Bir online mağazada eklenti olmadan kripto ödemeleri kabul edin

Bir online mağaza, REST API üzerinden her sipariş için bir fatura oluşturup müşteriyi faturanın barındırılan ödeme sayfasına göndererek Crypto Merchant ile kripto kabul eder. Müşteri bir coin seçer, tam tutarı o fatura için sabitlenmiş kurla öder ve imzalı invoice.paid webhook'u geldiğinde sunucunuz siparişi gönderir. Ücret, ödenen fatura başına %1. WooCommerce, Shopify veya Magento eklentisi yoktur: entegrasyon bir API çağrısı ve bir webhook uç noktasından oluşur.

Güncellendi: 6 Kasım 2026

Bu sayfadaki her şey, Crypto Merchant'ın API referansı, ödeme sayfası belgeleri ve Fiyatlandırma sayfasında açıklandığı şekliyle bugün nasıl çalıştığını anlatır. Buradaki hiçbir şey başka ödeme altyapıları hakkında bir iddia değildir.

Bir bakışta

Konu	Nasıl işler
Müşteriler nasıl öder	Barındırılan bir fatura sayfasında: kabul ettikleriniz arasından bir coin ve ağ seçer, tam tutarı ve o fatura için oluşturulmuş bir yatırma adresini QR kodu ve geri sayımla birlikte görür.
Ne geliştirirsiniz	Müşteri kriptoyu seçtiğinde bir `POST /invoices` çağrısı ve webhook'lar için bir HTTPS uç noktası. HTTPS isteği yapabilen herhangi bir dil veya çerçeve.
Ne zaman gönderilir	Ödeme onaylarını aldıktan sonra, `invoice.paid` olayında. Asla `invoice.confirming` üzerine değil.
Yanlış tutarlar	Toleransınızı aşmayan bir eksik ödeme, ödenmiş sayılır. Daha büyük bir eksiklik faturayı `underpaid` yapar: müşteri kalanını tamamlayabilir veya gönderdiğini geri alabilir. Fazla ödeme yine ödenmiş sayılır ve fazlalık müşteri adına tutulur.
Fiyatlandırma para birimi	Varsayılan olarak ABD doları veya EUR, GBP, TRY ya da BRL gibi desteklenen başka bir para birimi; coin tutarı, müşteri coini seçtiğinde canlı fiyatlardan hesaplanır.
Eklentiler	Yok. Aşağıdaki akış, bir API çağırabilen herhangi bir sepet veya özel ödeme adımıyla çalışır.

Adım adım nasıl işler?

Müşterinin “Kriptoyla öde”yi seçtiği andan siparişin deponuzdan çıkmasına kadar:

1
Ödeme adımında faturayı oluşturun
Müşteri kriptoyu seçtiğinde sunucunuz, sipariş toplamı, order_id değeriniz, müşterinin e-postası, teşekkür sayfanıza dönen bir redirect_url ve geri gönderilmesini istediğiniz herhangi bir metadata ile POST /invoices çağrısı yapar. Yanıt, bir checkout_url içeren faturadır.
2
Müşteriyi fatura sayfasına gönderin
checkout_url adresine yönlendirin. Sayfa kabul ettiğiniz coinleri listeler; müşteri birini seçtiğinde o coindeki tutar canlı fiyatlardan hesaplanıp sabitlenir ve bu fatura için oluşturulmuş bir yatırma adresi QR koduyla gösterilir. Fatura, belirlediğiniz süre boyunca açık kalır; varsayılan 30 dakikadır.
3
İmzalı webhook'ları alın
Uç noktanız, ödeme zincirde görüldüğünde invoice.confirming, yeterli onaya ulaştığında invoice.paid alır. CM-Signature başlığını doğrulayın, olayı kaydedin, 10 saniye içinde 2xx ile yanıt verin, sonra siparişi kaydettiğiniz kopyadan serbest bırakın. Olaylar iki kez gelebilir: yalnızca bir kez göndermek için olayın id değerini kullanın.
4
Üç uç durumu ele alın
invoice.expired: zamanında ödeme gelmedi, bu yüzden yeni bir fatura teklif edin. invoice.underpaid: müşteri kalanını aynı adrese gönderebilir veya fatura sayfasından iade alabilir. Fazla ödenen bir fatura yine ödenmiştir; fazlalık müşteri adına tutulur ve müşteri bunu fatura sayfasından çekebilir.
5
Ödeme gönderimi alın
Onaylanan ödemeler %1 düşülerek bakiyenize yatırılır ve işletmenizin havuz cüzdanına süpürülür. İstediğiniz zaman kendi adreslerinize ödeme gönderimi yapın; her coin olduğu gibi veya her şey tek bir tutulacak coine takas edilerek.

Gereken tek API çağrısı

Ödeme adımında faturayı oluşturun

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

Maliyeti nedir?

Ödenen her faturadan %1; ödeme bakiyenize yatırıldığında düşülür. Kurulum ücreti, aylık ücret ve canlıya geçiş ödemesi yoktur; süresi dolan ve iptal edilen faturalar hiçbir şeye mal olmaz. Coin taşımak (süpürmeler, takaslar ve ödeme gönderimleri) bir gas ücreti gerektirir; bu ücret, eklediyseniz gas bakiyenizden, aksi halde taşınan coinlerden alınır. Müşteriler de her faturada bir gas ücreti öder: bu ücret gönderdikleri tutara eklenir, ödeme sayfasında gösterilir ve hiçbir zaman $5 tutarını aşmaz. Takas kurları %1 oranında bir hizmet marjı içerir. Tüm maliyetler Fiyatlandırma sayfasında tek bir tablodadır.

Crypto Merchant burada ne yapmaz

Mağaza eklentisi yok. WooCommerce, Shopify, Magento, PrestaShop veya OpenCart modülü yoktur. API çağrısını kendiniz eklersiniz ya da ödeme sayfanızı ve ödeme bağlantılarınızı paylaşırsınız.
Otomatik iade yok ve API'de iade çağrısı yok. Onaylanmış bir kripto ödemesi nihaidir, bu yüzden iade yeni bir transferdir. Ürün iadesinde bir Admin, portalda ödenmiş ödemeden özel bir iade bağlantısı oluşturur; müşteri kendi adresini girer, ağ ücreti iadeden düşülür ve %1 ücreti geri verilmez.
Emanetçi, yalnızca kripto. Siz ödeme gönderimi yapana kadar anahtarları Crypto Merchant tutar ve ödeme gönderimleri banka hesabına değil, kendi cüzdan adreslerinize gider.

Bu kimin için?

Zaten kendi ödeme adımını çalıştıran ve bir API çağrısı ile bir webhook ekleyebilen mağazalar.
Kartların zor edinildiği veya ters ibrazların (chargeback) zarar verdiği ülkelerdeki müşterilere satış yapan mağazalar.
Dolar cinsinden fiyatlandıran ve USDT veya USDC ile tahsilat yapmak isteyen mağazalar.

Sıkça sorulan sorular

Crypto Merchant için bir WooCommerce veya Shopify eklentisi var mı?

Hayır. Entegrasyon, fatura oluşturan bir API çağrısı ve ödendiğini öğrenen bir webhook uç noktasından oluşur. Eklenti şartsa, alternatifler sayfaları eklentisi olan ödeme altyapılarını listeler.

Bir kripto ödemesinin onaylanması ne kadar sürer?

Ağa bağlıdır. Her ağın, Coinler ve ağlar sayfasında listelenen belirli bir onay sayısı vardır. Tron, Solana, BNB Smart Chain, Polygon, Base ve Arbitrum üzerindeki stablecoinler genellikle birkaç dakika içinde onaylanır; Bitcoin 2 onay gerektirir, bu da genellikle 20 dakika kadar sürer.

Müşteri yanlış tutar öderse ne olur?

Toleransınız içindeki bir eksiklik ödenmiş sayılır. Daha büyük bir eksiklik faturayı eksik ödenmiş yapar ve müşteri fatura sayfasından kalanını tamamlayabilir veya gönderdiğini geri alabilir. Fazla ödeme yine ödenmiş sayılır ve fazlalık, müşterinin çekmesi için onun adına tutulur.

Müşterinin bir Crypto Merchant hesabına ihtiyacı var mı?

Hayır. Müşterinin yalnızca ödemek istediği coini içeren bir cüzdana ihtiyacı vardır. Fatura sayfasını açar, coini seçer ve gösterilen tutarı gönderir.

Siparişleri euro veya başka bir para biriminde fiyatlandırabilir miyim?

Evet. Faturalar varsayılan olarak ABD doları cinsinden fiyatlandırılır ve para birimi alanı EUR, GBP, TRY veya BRL gibi desteklenen diğer para birimlerini kabul eder. Coin tutarı, müşteri coini seçtiğinde canlı fiyatlardan hesaplanır.

Diğer kullanım senaryoları

Tüm kullanım senaryoları

Bugün kripto kabul etmeye başlayın

Ücretsiz kurulum, kayıt için belge gerekmez, ödenen fatura başına %1 ve istediğiniz zaman ödeme gönderimi.

Hesabınızı oluşturun Belgeleri okuyun