Dijital dönüşümün ve sınır ötesi e-ticaretin (e-ihracat) hızla büyüdüğü günümüzde, web sitelerinde yalnızca geleneksel kredi kartı sanal POS'larına bağımlı kalmak işletmeler için ciddi bir ciro kaybı anlamına gelmektedir. Yurt dışı kart reddi oranları (%30-%50), kredi kartı komisyonlarının %4-%8 seviyelerine tırmanması, bankaların 30 ila 45 günlük bloke valör süreleri ve en tehlikelisi aylar sonra gelen ters ibraz (chargeback) dolandırıcılıkları e-ticaret firmalarını zorlamaktadır. Kripto Sanal POS altyapısı bu sorunların tamamına modern bir çözüm sunar. Bu rehberde web sitenize kripto ödeme geçidini nasıl entegre edebileceğinizi tüm teknik detaylarıyla açıklıyoruz.

Geleneksel Kredi Kartı POS'ları vs Kripto Sanal POS

İşletmenizin finansal verimliliğini artırmak için iki ödeme modelini karşılaştıralım:

Kriter Geleneksel Kredi Kartı Sanal POS MutabıkPOS Kripto Sanal POS
Ters İbraz (Chargeback) Riski Çok Yüksek (Satıcı aleyhine) %0 (Blokzincirde geri alma yoktur)
Sınır Ötesi Satış / Global Kabul 3D Secure hataları ve kart reddi sık yaşanır Dünyanın her yerinden anında ödeme
Hakediş Valör / Bloke Süresi 30 ile 45 Gün Blokeli Ertesi Gün veya Anında FAST TL
Komisyon Maliyeti %3.5 - %8.0 + POS Aidatı Avantajlı B2B Oranları (Sabit aidsız)
Kripto Oynaklık Riski Geçerli değil Sabitlenmiş TL Garantisi

Kripto Sanal POS Nasıl Çalışır? (REST API & Webhook Yaşam Döngüsü)

MutabıkPOS B2B Sanal POS sistemi basit ve standart bir 3 adımlı yaşam döngüsüne sahiptir:

  1. Ödeme Oturumu Başlatma: Müşteriniz web sitenizde sepeti onayladığında sunucunuz MutabıkPOS /api/v1/checkout/sessions uç noktasına sipariş tutarını ve para birimini bildiren bir POST isteği gönderir.
  2. Müşteri Ödeme Ekranı (Checkout): Dönen yanıt içindeki checkout_url adresine müşteri yönlendirilir. Müşteri ekranda QR kod ve yatırma cüzdan adresini görür; dilediği ağdan (TRC20, BEP20, Polygon vb.) ödemesini yapar.
  3. Otomatik Webhook Bildirimi: Blokzincir üzerinde transfer teyit edildiği anda sunucunuza kriptografik olarak imzalanmış checkout.completed webhook'u iletilir. Siteniz siparişi otomatik olarak "Ödendi" statüsüne alır.
💻
Örnek API İsteği (cURL)
curl -X POST https://pos.mutabik.app/api/v1/checkout/sessions \
  -H "Content-Type: application/json" \
  -H "X-POS-API-Key: MPOS_LIVE_FIRMA_API_KEYINIZ" \
  -d '{
    "amount": 1500,
    "currency": "TRY",
    "order_title": "Siparis #10482",
    "customer_name": "Mehmet Demir",
    "customer_email": "mehmet@example.com"
  }'

Node.js ve PHP ile Hızlı Entegrasyon Kılavuzu

Yazılım ekibiniz modern dillerle birkaç satır kod ile entegrasyonu tamamlayabilir. Node.js backend altyapınızda ödeme oturumu açmak için şu basit mantığı kurabilirsiniz:

const response = await fetch('https://pos.mutabik.app/api/v1/checkout/sessions', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-POS-API-Key': process.env.MUTABIKPOS_KEY
  },
  body: JSON.stringify({
    amount: cart.totalTry,
    currency: 'TRY',
    order_title: `Sipariş #${cart.orderId}`,
    customer_name: user.fullName
  })
});
const session = await response.json();
if (session.success) {
  res.redirect(session.checkout_url);
}

Müşteri ödemesini tamamladığında sunucunuza gelen Webhook'u karşılamak ise şu kadar kolaydır:

app.post('/api/webhook/mutabikpos', (req, res) => {
  const event = req.body;
  if (event.status === 'completed') {
    db.orders.updateStatus(event.order_code, 'PAID');
    sendTelegramAlert(`Ödeme Alındı: ${event.order_code}`);
  }
  res.json({ received: true });
});

E-Ticaret Şirketleri İçin Kripto POS'un En Büyük 4 Avantajı

  • Uluslararası Müşterilere Kapı Açma: Rusya, Körfez ülkeleri, Avrupa ve Asya'dan Türkiye'deki sitelerden alışveriş yapmak isteyen yabancı müşteriler yerel banka kartlarının kısıtlamalarına takılmadan USDT ile kolayca ödeme yaparlar.
  • Nakit Akışını Hızlandırma: Banka POS'larında haftalarca bekletilen sermayeniz yerine toplanan ödemeler ertesi gün şirket IBAN'ınıza net TL olarak geçer.
  • Chargeback Dolandırıcılıklarına Son: Dijital ürün, yazılım veya oyun kodu satan firmalar en çok sahte harcama itirazlarıyla batarlar. Kriptoda ters ibraz imkansızdır.
  • Prestij ve İnovasyon: Web sitenize "Kripto ile Öde" seçeneği eklemek markanızı teknolojik olarak rakiplerinizin önüne geçirir.

Muhasebe ve E-Fatura Uyum Süreci Nasıl Yönetilir?

Kripto para ile ödeme alan Türk e-ticaret şirketlerinin en sık sorduğu sorulardan biri faturalandırma sürecidir. Türkiye'de e-fatura veya e-arşiv fatura düzenlerken ürünün Türk Lirası cinsinden bedeli esas alınır. Müşteri ödemesini USDT, BNB veya ETH ile yapsa dahi, sipariş anındaki TCMB gösterge kuru üzerinden hesaplanan Türk Lirası tutarı faturaya yazılır ve standart KDV hesaplaması yapılır.

MutabıkPOS B2B paneli, her siparişin tamamlandığı andaki döviz kurunu, işlem kodunu (TxID) ve TL karşılığını otomatik olarak arşivler. Muhasebe departmanınız ay sonunda tek bir Excel veya CSV çıktısı alarak tüm mutabakatı dakikalar içinde resmi defterlerine işleyebilir. Böylece hem modern bir ödeme yöntemi sunmuş olur hem de yasal mevzuata %100 uyum sağlarsınız.

E-Ticaret Platformlarıyla Uyumluluk (WooCommerce, Shopify, Özel SaaS)

İster özel yazılmış bir Next.js veya Laravel e-ticaret siteniz olsun, ister hazır WooCommerce veya OpenCart kullanıyor olun; MutabıkPOS'un sade REST API yapısı herhangi bir harici kütüphane bağımlılığı olmaksızın dakikalar içinde çalışır. Müşteriniz ödeme adımında cüzdan QR kodunu tarattığında ekranda anlık geri sayım çalışır; transfer blokzincir mempool havuzuna düştüğü saniye "Ödeme Algılandı" teyidi gösterilir. Bu kusursuz kullanıcı deneyimi sepet terk oranlarını (cart abandonment) önemli ölçüde düşürür.

Sonuç: E-Ticarette Kripto Çağına Geçiş Yapın

Kredi kartı faizlerinin ve komisyonlarının yükseldiği bir dönemde alternatif ve küresel ödeme kanalları sunmak işletmenize can suyu olacaktır. Basit REST API entegrasyonu ve sıfır ters ibraz garantisiyle çalışan MutabıkPOS B2B Sanal POS, şirketinizin dijital dönüşümündeki en güçlü müttefikidir. Hemen Kripto Sanal POS ve B2B POS Dokümantasyonu sayfalarımızı inceleyerek başvurunuzu yapabilirsiniz.

Sınır Ötesi E-Ticarette Kripto POS'un İhracatçıya Sağladığı Rekabet Avantajı

Küresel e-ticaret pazarında Türk girişimcilerin en sık karşılaştığı engel ödeme tahsilatıdır. Özellikle Orta Doğu, Kuzey Afrika, Körfez ülkeleri ve Doğu Avrupa'da kredi kartı sahiplik oranları düşüktür veya yerel bankalar Türkiye merkezli e-ticaret sitelerine yapılan döviz harcamalarını güvenlik gerekçesiyle reddetmektedir. Geleneksel sanal POS'larda yaşanan %35 ila %50 arasındaki sepet terk oranları (cart abandonment), kripto ödeme seçeneği sunulduğunda dramatik biçimde düşmektedir.

USDT ve yerel kripto paralar coğrafi sınırları tanımaz. Dubai'den, Londra'dan veya Bakü'den sitenize giren bir müşteri, yerel bankasının onayına ihtiyaç duymadan saniyeler içinde cüzdanındaki Tether ile ödeme yapabilir. MutabıkPOS, müşterinizden toplanan bu döviz ve kripto ödemelerini otomatik olarak Türk Lirasına dönüştürüp ertesi gün şirket hesabınıza aktarır. Böylece döviz kuru dalgalanması riskine girmeden global bir müşteri kitlesine satış yapma gücüne kavuşursunuz.

Adım Adım Entegrasyon ve Canlı Ortama Geçiş Kontrol Listesi

MutabıkPOS B2B Sanal POS'u sitenizde aktif hale getirmeden önce şu 5 adımı tamamlamanız önerilir:

  1. API Anahtarı Üretimi: B2B Yönetim Paneli üzerinden firmanızı kaydederek canlı (live) ve test (sandbox) API anahtarlarınızı oluşturun.
  2. Webhook Uç Noktası Tanımlama: Sunucunuzda HTTPS protokolüyle çalışan ve gelen POST bildirimlerini karşılayan güvenli bir endpoint açın (Örn: https://siteniz.com/api/mpos-webhook).
  3. Kriptografik İmza Teyidi: MutabıkPOS tarafından gönderilen webhook'ların başlığındaki HMAC imzasını kontrol ederek isteğin gerçekten sistemimizden geldiğini doğrulayın.
  4. Test Ödemesi Gerçekleştirme: Minimum tutarlı bir test ödeme oturumu açarak cüzdandan transfer yapın ve webhook ile sipariş durumunun otomatik güncellendiğini teyit edin.
  5. Canlıya Alım: Testler tamamlandıktan sonra sitenizdeki ödeme adımına "💎 Kripto ile Öde (USDT, BNB, ETH, SOL)" seçeneğini ekleyerek müşterilerinize sunun.

B2B Kripto Ödeme ve Sanal POS Terimleri Sözlüğü

  • Webhook (Ters API): Bir ödeme blokzincirde teyit edildiğinde MutabıkPOS sunucularının sitenize anında otomatik HTTP POST bildirimi göndermesi.
  • API Key (Uygulama Anahtarı): Sitenizin MutabıkPOS ödeme ağ geçidine güvenli biçimde bağlanmasını sağlayan gizli kriptografik kimlik kodu.
  • HMAC SHA-256 İmzası: Gelen webhook verisinin yolda değiştirilmediğini ve gerçekten MutabıkPOS tarafından gönderildiğini kanıtlayan matematiksel hash imzası.
  • Ters İbraz (Chargeback): Kredi kartı sahibinin harcama sonrasında bankasına itiraz ederek parayı satıcının hesabından zorla geri çekmesi dolandırıcılığı.
  • Valör / Bloke Süresi: Geleneksel bankaların kredi kartı tahsilatlarını satıcının hesabına geçirmeden önce faizsiz tuttukları 30-45 günlük bekleme süresi.