← Bloga dön

Pazar Yerleri icin Kripto Odemeleri: Tek Hesap, Her Saticinin Cuzdani

· 4 min read
marketplace channels api guide

Bir pazar yeri isletiyorsaniz — veya birden fazla saticinin odeme aldigi herhangi bir platform — kripto belirli bir sorun yaratir: her saticinin kendi odeme hedefine ihtiyaci vardir. Cogu odeme islemcisi her satici icin ayri bir tuccar hesabi olusturmanizi, ayri API anahtarlari yonetmenizi ve hepsini uzlastirmanizi gerektirir.

MutoPay farkli bir yaklasim benimser. Tek tuccar hesabi, tek API anahtari ve satici basina bir kanal. Her kanal odemeleri o saticinin cuzdanina, tercih ettigi zincirde, tercih ettigi token ile yonlendirir. Her seyi tek bir API uzerinden yonetirsiniz.

Pazar yeri isletmiyor musunuz? Kendiniz icin odeme kabul eden tek bir uygulama veya site icin, master key gerekmez. Kontrol panelinde (Ayarlar → Kanallar) bir kanal olusturun, ep_… API anahtarini ve webhook sirrini kopyalayin — bu kadar. Minimum kurulum icin Kripto odemeleri nasil kabul edilir makalesine bakin. Asagidaki master key yalnizca backend’iniz uclu taraflar icin programatik olarak kanal olusturdugunda gereklidir.

Model

Kanal, hesabiniz altinda izole bir odeme yoludur. Her birinin kendine ait:

  • API anahtari (o saticiya atfedilen odeme olusturmak icin)
  • Uzlasma hedefi (zincir, token, cuzdan adresi)
  • Webhook URL’si (her saticinin sunucusunu bagimsiz olarak bilgilendirmek icin)

Master API anahtari, kanallari programatik olarak olusturmanizi ve yapilandirmanizi saglar — tarayici girisi gerekmez. Sunucunuz saticilari otomatik olarak yapilandirir.

Sonuc: bir alici Satici A’nin magazasindan odeme yaptiginda, fonlar dogrudan Satici A’nin cuzdanina gider. Satici B’nin odemeleri Satici B’nin cuzdanina gider. Fonlara hic dokunmazsiniz.

Kurulum: satici basina uc API cagrisi

Platformunuza yeni bir satici kaydolup cuzdan adresini sagladiginda, sunucunuz uc cagri yapar:

1. Kanal olusturun

curl -X POST https://mutopay.com/api/merchant/channels \
  -H "Authorization: Bearer msk_<your_master_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Vendor: Acme Widgets",
    "webhook_url": "https://acme-widgets.com/webhooks/mutopay"
  }'

Yanit kanal kimligini ve bir kanal API anahtarini (ep_...) icerir. Ikisini de saklayin — anahtar bir kez gosterilir.

2. Saticinin uzlasma hedefini ayarlayin

curl -X PUT https://mutopay.com/api/merchant/channels/ch_abc123/settlement \
  -H "Authorization: Bearer msk_<your_master_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "preferred_token": "USDC",
    "preferred_chain_id": "137",
    "wallet_address": "0xVendorWalletAddress..."
  }'

Artik bu kanal uzerinden olusturulan her odeme, Polygon’da USDC olarak o saticinin cuzdanina uzlasir.

3. Kanalin API anahtariyla odeme olusturun

curl -X POST https://mutopay.com/api/payments \
  -H "X-API-Key: ep_<channel_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 49.99,
    "currency": "USD",
    "external_id": "order_5821",
    "description": "Acme Widgets — Order #5821"
  }'

Odeme otomatik olarak kanala atfedilir. Alici odeme sayfasini gorur, elindeki herhangi bir token ile oder ve fonlar saticinin cuzdanina USDC olarak ulasir.

Bu size ne saglar

Satici basina hesap yok. Her saticiyi ayri tuccar olarak kaydetmezsiniz. Tek hesap, N kanal.

Saklama yok. Fonlar dogrudan saticinin cuzdanina gider. Kripto tutmaz, emanete almaz veya iletmezsiniz.

Bagimsiz anahtarlar. Bir saticinin entegrasyonu tehlikeye girerse, yalnizca o kanalin anahtarini iptal edersiniz. Baska hicbir sey etkilenmez.

Satici basina Webhook’lar. Her kanal kendi webhook URL’sine sahip olabilir. Satici A’nin sunucusu Satici A’nin odemeleri hakkinda bilgilendirilir.

Karisik zincirler ve tokenlar. Satici A, Polygon’da USDC ile uzlasir. Satici B, Arbitrum’da USDT ister. Satici C, TON cuzdanini tercih eder. Her kanal bagimsizdir.

Satici eklemeyi otomatiklestirme

Tipik bir akis:

  1. Satici platformunuza kaydolur, cuzdan adresini ve tercih ettigi zinciri girer
  2. Sunucunuz kanal olusturmak icin POST /api/merchant/channels cagrisini yapar
  3. Sunucunuz cuzdan detaylarini ayarlamak icin PUT /api/merchant/channels/:id/settlement cagrisini yapar
  4. Kanal kimligini ve API anahtarini veritabaninizda o saticiyla iliskili olarak saklarsiniz
  5. Bu satici icin siparis olustururken, X-API-Key icerisinde kanalin API anahtarini kullanirsiniz

Bir saticiyi cikarmak icin:

curl -X POST https://mutopay.com/api/merchant/channels/ch_abc123/revoke \
  -H "Authorization: Bearer msk_<your_master_key>"

API anahtari aninda calismayi durdurur. Mevcut tamamlanmis odemeler etkilenmez.

MutoPay’in yapamadiklari

Beklentileri dogru belirlemek icin: MutoPay odemeleri bir hedef cuzdana yonlendirir. Tek bir odemeyi birden fazla cuzdana bolmez, fonlari emanette tutmaz veya bir komisyon yapisi dayatmaz. Pazar yeriniz bir pay aliyorsa, bunu uygulama mantaginizda halledersiniz.

Bu kimler icin

  • Cok saticili pazar yerleri (el yapimi urunler, dijital urunler, hizmetler)
  • SaaS platformlari (Shopify tarzi, beyaz etiketli magazalar)
  • Ajanslar birden fazla musteri icin odeme yonetenler
  • WooCommerce cok saticili kurulumlar (Dokan, WCFM)
  • Serbest calisma platformlari her serbest calisanin dogrudan odeme aldigi

Baslangic

  1. MutoPay panelinize giris yapin
  2. Ayarlar sayfasina gidin ve bir master API anahtari olusturun
  3. Kanallari programatik olarak olusturmaya baslamak icin API dokumantasyonunu kullanin

Tam kanal yonetim API’si mutopay.com/api/docs adresinde dokumante edilmistir.