115 lines
4.1 KiB
Markdown
115 lines
4.1 KiB
Markdown
# 🚀 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ı.*
|