Files
Pay2Gateway/README.md

4.1 KiB
Raw Permalink Blame History

🚀 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 (App Router)
  • Veritabanı: PostgreSQL (Direct connectivity via pg)
  • Blockchain:
  • Styling: Modern Vanilla CSS & Tailwind (Hibrit)
  • İkon Seti: Lucide React & Cryptocurrency-Icons (GitHub CDN)

🚀 Hızlı Kuruluk

1. Depoyu Klonlayın

git clone https://github.com/mstfyldz/Pay2Gateway.git
cd Pay2Gateway

2. Bağımlılıkları Yükleyin

npm install

3. Ortam Değişkenlerini Yapılandırın

.env dosyasını oluşturun:

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

{
  "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ı.