Kripto Odeme Gateway - Merchant API

Siz odeme saglayicisisiniz (xKriptoPay gibi). Bahis/casino siteleri size entegre olur.

---

1. Odeme baslat (musteri backend'i cagirir)

POST https://onlykriptoevg.com/api/create-payment.php
Content-Type: application/json

{
  "api_key": "MERCHANT_API_KEY",
  "api_secret": "MERCHANT_API_SECRET",
  "user_id": "123456",
  "order_id": "ORD-UNIQUE-001",
  "amount": 5000,
  "callback_url": "https://musteri-site.com/crypto/callback",
  "return_url": "https://musteri-site.com/deposit/success"
}

Yanit: payment_url → kullaniciyi yeni sekmede acin: window.open(payment_url)

---

2. Kullanici odeme yapar (sizin arayuzunuz)

1. payment-detail — coin sec + tutar (API'den gelmisse tutar kilitli)
2. withdraw-detail — cekim adresi kaydi (opsiyonel)
3. process-detail — soguk cuzdan + QR + 3dk kur

---

3. Callback (musteri sitesine POST)

Odeme onaylaninca musterinin callback_url adresine gider:

• Header: X-Signature: HMAC-SHA256(body, api_secret)
• Header: X-Event: payment.completed
• Body: amount_tl, commission_tl, credit_amount_tl, commission_mode, order_id, user_id, ...

Bakiye yuklerken credit_amount_tl kullanin (komisyon modeline gore hesaplanir).

Musteri imzayi dogrular, bakiye yukler, 200 OK doner.

---

4. Cekim talebi (musteri backend'i cagirir)

POST https://onlykriptoevg.com/api/create-withdrawal.php
Content-Type: application/json

{
  "api_key": "MERCHANT_API_KEY",
  "api_secret": "MERCHANT_API_SECRET",
  "user_id": "123456",
  "order_id": "WDR-UNIQUE-001",
  "amount": 3000,
  "coin_type": 2,
  "wallet_address": "TExampleWalletAddress...",
  "callback_url": "https://musteri-site.com/crypto/callback"
}

Yanit: token, status: pending — operatör onayindan sonra callback gider.

---

5. Cekim callback'leri

Admin cekim durumunu guncellediginde ayni callback_url adresine POST gider:

• X-Event: withdrawal.processing — onaylandi, isleme alindi
• X-Event: withdrawal.completed — kripto gonderildi (tx_hash dahil)
• X-Event: withdrawal.rejected — reddedildi (admin_note opsiyonel)

Body ornegi: event, order_id, user_id, amount_tl, wallet_address, status, tx_hash, ...

Müşteri sitesi: processing → bakiye bloke, completed → bakiye dus, rejected → iade.

---

6. Komisyon modeli

• merchant_pays (varsayilan): Uye brüt tutari alir. Komisyon gateway'e merchant borcu (mutabakat).
• deduct_from_user: Uye net tutari alir; komisyon yatirimdan kesilir.

Formul: commission_tl = brut × % + sabit · credit_amount_tl callback'te hazir gelir.

---

7. Merchant Panel (entegre siteler icin)

Entegre bahis/casino siteleri API Key + Secret ile panele girer:

https://onlykriptoevg.com/merchant/login.php

• Özet — toplam kasa, bekleyen çekimler
• Üye yatırımları (tarih, tutar, user_id, order)
• Çekim talepleri listesi
• Komisyon ve mutabakat ozeti
• CSV export

---

8. Durum sorgulama (opsiyonel)

GET/POST https://onlykriptoevg.com/api/payment-status.php?token=...&api_key=...&api_secret=...

---

Admin panelde yapmaniz gerekenler

• Her musteri icin merchant olustur (api_key + api_secret)
• Soguk cuzdan adreslerini tanimla
• Odemeleri takip et / onayla (veya blockchain otomasyonu ekle)