İngilizce
Almanca
İspanyolca
Fransızca
Türkçe
Kılavuzlara Geri Dön
Kripto Ödeme Entegrasyonu: 2026 E-Ticaret ve SaaS için Türkiye Rehberi
2026'da kripto ödeme entegrasyonu özel bir mühendislik projesi değil. Türk tüccarların büyük kısmı için bu bir eklenti kurulumu ya da dört uç noktalı bir API entegrasyonudur. Zor kısım hazine, mutabakat ve uyumdur; kablolama değil.
Bu oyun kitabı üç gerçekçi entegrasyon yolunu kapsar (barındırılan checkout, eklenti, doğrudan API), webhook ve iade akışlarını, muhasebenin ihtiyaç duyduğu veriyi ve çoğu ilk entegrasyonu öldüren hataları anlatır.
Kripto Ödemelerini Kabul Ederek İşinizi Geliştirin
Kripto Ödeme Entegrasyonunun Anlamı
Checkout'u, dijital varlık kabul eden, işlemi zincirde onaylayan ve gelirleri (döviz veya stablecoin olarak) muhasebenin mutabakat yapabileceği meta verilerle işletmeye ileten bir sağlayıcıya bağlamaktır. Müşteri bir ödeme butonu daha görür; ekibiniz kart veya SWIFT işleminden farksız bir defter kaydı.
Üç Entegrasyon Yolu
Barındırılan checkout
Sağlayıcı sayfasına yönlendirme veya modal. 1-2 gün.
Platform eklentisi
Shopify, WooCommerce, Ticimax, IdeaSoft, Magento. Yarım gün.
Doğrudan API
REST ile backend'den. 1-3 hafta.
API 4 Uç Nokta
| Uç nokta | Amaç | Önemli alanlar |
|---|---|---|
| POST /invoices | Kripto fatura oluştur. | order_id, fiat_amount, fiat_currency, callback_url |
| GET /invoices/:id | Durum sorgula. | status |
| POST /webhooks | Neredeyse anlık olay alımı. | event_type, invoice_id, tx_hash |
| POST /refunds | Token iade. | invoice_id, amount, destination_address |
Webhook disiplini
- İmzayı her zaman doğrulayın.
- Idempotent, event_id ile tekrarsız.
- 5 saniyede 2xx. Ağır iş asenkron.
- Polling yedeği.
İade ve Müşteri Hizmetleri
Kripto iadeleri yeni bir giden işlemdir, iptal değil. Chargeback yok; uyuşmazlıklar doğrudan sizinle. "Aynı token miktarı" veya "aynı fiat değer" politikası yayımlanmalı ve tutarlı uygulanmalı.
Muhasebe ve Mutabakat
- TxID saklayın.
- Döviz eşdeğerinde kaydedin, fatura anındaki kurdan.
- Günlük mutabakat.
- Logo, Mikro, Netsis, QuickBooks'a aktarın.
- Maliyet takibi: bilançoda stablecoin veya kripto tutuluyorsa lot bazlı.
GatewayCrypto ile Entegre Olun
Yığınınıza uyum sağlayan bir entegrasyon.
- Resmi eklentiler. Shopify, WooCommerce, Ticimax, IdeaSoft, Magento, Medusa.
- Tam REST API.
- Sandbox-üretim paritesi.
- SDK: Node.js, Python, PHP, Ruby, Go, Java.
- Atanmış entegrasyon mühendisi çıkış boyunca.
Kripto Ödemelerini Kabul Ederek İşinizi Geliştirin
Başlayın
Sıkça Sorulan Sorular
Platform eklentisi. Shopify, WooCommerce, Ticimax veya IdeaSoft'ta yarım günlük iş.
Eklentilerde hayır. Doğrudan API veya özel yığınlarda evet. En büyük yük hazine ve mutabakattır.
Evet. Sağlayıcı otomatik çevirir ve yurt dışı hesabınıza ödeme yapar.
Eksik: fatura askıda veya sona erer. Fazla: müşteriye alacak yazılır veya fark iade edilir.
Refund uç noktası ile invoice_id, tutar ve adres. Yeni bir giden işlem. Chargeback değil.
BTC, ETH, Tron üzerinde USDT, Base veya Arbitrum üzerinde USDC. 2026 hacminin büyük kısmını kapsar.
Barındırılan ve eklenti akışlarında hayır. Kripto bacağının PCI kapsamı yok.
