# 🚀 Pay2Gateway: Hibrit Kripto & Geleneksel Ödeme Geçidi Altyapısı

Pay2Gateway, modern e-ticaret siteleri ve dijital platformlar için geliştirilmiş, **Next.js 15** ve **PostgreSQL** tabanlı, hibrit bir ödeme geçidi (Payment Gateway) çözümüdür. Sistem, geleneksel ödeme sağlayıcılarını (Stripe vb.) on-chain kripto ödemeleriyle birleştirerek firmalara tam otomatik ve esnek bir tahsilat altyapısı sunar.

---

## 🌟 Öne Çıkan Özellikler

### 🛡️ Kurumsal API Yönetimi (v1)
*   **API Key Yetkilendirme:** Firmalar (Merchants) için sunucu taraflı güvenli erişim.
*   **Checkout Sessions:** Fiyat manipülasyonunu engelleyen, tek kullanımlık güvenli ödeme oturumları.
*   **Gelişmiş Webhook'lar:** Ödeme tamamlandığında veya süpürme (sweep) işlemi gerçekleştiğinde otomatik JSON bildirimleri.

### ⛓️ Çoklu Zincir (Multi-Chain) Desteği
*   **Geniş Ağ Desteği:** 
    *   **EVM:** Ethereum, Polygon, BSC.
    *   **Solana:** Native SOL ve SPL tokenlar (USDC/USDT).
    *   **TRON (TRC20):** USDT ve TRX desteği.
    *   **BITCOIN:** Native BTC ödeme doğrulama.
*   **Otomatik Süpürme (Auto-Sweep):** Toplanan fonların ana platform ve merchant cüzdanlarına saniyeler içinde otomatik olarak aktarılması (Server-side split).
*   **Gelişmiş Doğrulama:** Her ağ için optimize edilmiş on-chain/API doğrulama mekanizmaları.

### 💰 Esnek Komisyon & Fiyatlandırma
*   **Merchant-Specific Fees:** Her firma için özel komisyon oranı (%Fee) belirleme imkanı.
*   **Zengin Token Listesi:** USDT, USDC, BTC, ETH, TRX, MATIC ve popüler altcoinler.
*   **Görsel Deneyim:** Dinamik coin logoları ve profesyonel checkout arayüzü.
*   **Binance API Entegrasyonu:** Gerçek zamanlı TRY/USD kuru ve anlık token fiyat dönüşümleri.

### 📊 Yönetim Panelleri
*   **Admin Dashboard:** Merkezi yönetim, firma ekleme/düzenleme, özel komisyon atama ve global istatistikler.
*   **Merchant Panel:** API anahtarı yönetimi, işlem geçmişi ve teknik entegrasyon rehberi.

---

## 🛠️ Teknoloji Yığını

*   **Frontend & API:** [Next.js 15](https://nextjs.org/) (App Router)
*   **Veritabanı:** PostgreSQL (Direct connectivity via `pg`)
*   **Blockchain:**
    *   [Ethers.js](https://docs.ethers.org/v6/) (EVM)
    *   [@solana/web3.js](https://solana-labs.github.io/solana-web3.js/) (Solana)
    *   [TronWeb](https://developers.tron.network/) (TRON)
*   **Styling:** Modern Vanilla CSS & Tailwind (Hibrit)
*   **İkon Seti:** Lucide React & Cryptocurrency-Icons (GitHub CDN)

---

## 🚀 Hızlı Kuruluk

### 1. Depoyu Klonlayın
```bash
git clone https://github.com/mstfyldz/Pay2Gateway.git
cd Pay2Gateway
```

### 2. Bağımlılıkları Yükleyin
```bash
npm install
```

### 3. Ortam Değişkenlerini Yapılandırın
`.env` dosyasını oluşturun:

```env
DATABASE_URL=postgres://user:pass@host:5432/db
NEXT_PUBLIC_BASE_URL=http://localhost:3000
NEXT_PUBLIC_USE_MOCK_PAYMENTS=true # Test için true kalsın

# Platform Cüzdanları (Süpürme Hedefi)
EVM_PLATFORM_ADDRESS=...
SOL_PLATFORM_ADDRESS=...
TRON_PLATFORM_ADDRESS=...

# Gaz Yakıt Cüzdanı
CRYPTO_GAS_TANK_KEY=0x...
TRON_GRID_API_KEY=...
```

---

## 📡 API Kullanımı (v1)

### Ödeme Oturumu Başlatma
URL: `POST /api/v1/checkout` | Headers: `x-api-key: YOUR_KEY`

```json
{
  "amount": 250.00,
  "currency": "TRY",
  "order_id": "OD_12345",
  "customer_name": "John Doe"
}
```

---

## 📂 Dosya Yapısı

*   `/lib/crypto-engine.ts` - On-chain ana motor (Doğrulama, Süpürme, Çoklu Ağ).
*   `/lib/crypto-config.json` - Ağlar, tokenlar ve dinamik logoların konfigürasyonu.
*   `/components/checkout` - Dinamik logo destekli premium ödeme bileşenleri.
*   `/scripts` - Veritabanı migrasyonları ve cüzdan yönetim araçları.

---

## 🔐 Güvenlik Politikası

1.  **İzole Cüzdanlar:** Her işlem için benzersiz geçici cüzdanlar üretilir.
2.  **Otomatik Bölüştürme:** Fonlar sunucu tarafında platform ve merchant arasında güvenle paylaştırılır.
3.  **Hassas Veri:** Cüzdan anahtarları ve kritik migration scriptleri repo dışı (`.gitignore`) tutulur.

---

⭐ **Pay2Gateway** - *Geleceğin Ödeme Altyapısı.*