📋 Table of Contents

• ✨ Features
• 🌍 Supported Payment Providers
• 📦 Installation
• 🚀 Quick Start
• 🛠️ Usage
• 📚 API Reference
• 🛣️ Roadmap
• 🤝 Contributing
• 📄 License

✨ Features

| Feature | Description | |---------|-------------| | 🔌 Multi-Provider Support | Integrate with 50+ payment gateways worldwide | | 🛡️ Secure Transactions | Enterprise-grade security for all payments | | ⚡ Fast Integration | Get started in minutes with simple setup | | 📊 Detailed Reporting | Comprehensive payment analytics and logs | | 🌐 Global Coverage | Support for traditional and crypto payments | | 🔧 Customizable | Tailored solutions for business needs | | 📱 Callback Handling | Automatic webhook processing | | 🧪 Well Tested | Extensive test coverage for reliability |

🌍 Supported Payment Providers

💳 Traditional Payment Systems

| Provider | Country | Status | |----------|---------|--------| | Midtrans | 🇮🇩 Indonesia | ✅ Active | | Tripay | 🇮🇩 Indonesia | ✅ Active | | Doku | 🇮🇩 Indonesia | ✅ Active | | PayID19 | 🇮🇩 Indonesia | ✅ Active | | Xendit | 🇮🇩 🇵🇭 Indonesia & Philippines | ✅ Active | | ToyyibPay | 🇲🇾 Malaysia | ✅ Active | | SenangPay | 🇲🇾 Malaysia | ✅ Active | | Zarinpal | 🇮🇷 Iran | ✅ Active | | Paytm | 🇮🇳 India | ✅ Active | | Cashfree | 🇮🇳 India | ✅ Active | | PayU India | 🇮🇳 India | ✅ Active | | PayKun | 🇮🇳 India | ✅ Active | | Razorpay | 🇮🇳 India | ✅ Active | | Instamojo | 🇮🇳 India | ✅ Active | | PhonePe | 🇮🇳 India | ✅ Active | | PayU Latam | 🇲🇽 🇨🇴 🇵🇪 🇦🇷 Latin America | ✅ Active | | PicPay | 🇧🇷 Brazil | ✅ Active | | Cardcom | 🇮🇱 Israel | ✅ Active | | Paycom | 🇺🇿 Uzbekistan | ✅ Active | | Checkout.com | 🌐 Global | ✅ Active | | 2Checkout | 🌐 Global | ✅ Active | | İyzico | 🇹🇷 Turkey | ✅ Active | | PayTR | 🇹🇷 Turkey | ✅ Active | | PayTR EFT | 🇹🇷 Turkey | ✅ Active | | PayWant | 🇹🇷 Turkey | ✅ Active | | PaynKolay | 🇹🇷 Turkey | ✅ Active | | Shopier | 🇹🇷 Turkey | ✅ Active | | Shopier Card | 🇹🇷 Turkey | ✅ Active | | Papara | 🇹🇷 Turkey | ✅ Active | | EsnekPos | 🇹🇷 Turkey | ✅ Active | | Paydisini | 🇹🇷 Turkey | ✅ Active | | PayNetTR | 🇹🇷 Turkey | ✅ Active | | PayPal | 🌐 Global | ✅ Active | | Amazon Pay | 🌐 Global | ✅ Active | | Paddle | 🌐 Global SaaS | ✅ Active | | FedaPay | 🇧🇯 Benin | ✅ Active | | Konnect | 🇹🇳 Tunisia | ✅ Active | | PayMaya | 🇵🇭 Philippines | ✅ Active | | PayME | 🇻🇳 Vietnam | ✅ Active | | PrimePayments | 🇦🇪 UAE | ✅ Active | | YallaPay | 🇦🇪 UAE | ✅ Active | | NoonPayments | 🇦🇪 UAE | ✅ Active | | PayTabs | 🇦🇪 🇸🇦 🇴🇲 🇯🇴 🇪🇬 Middle East | ✅ Active | | URWay | 🇸🇦 Saudi Arabia | ✅ Active | | PayOP | 🌐 Global | ✅ Active | | Paymentwall | 🌐 Global | ✅ Active | | Payssion | 🌐 Global (300+ methods) | ✅ Active | | Paysend | 🌐 Global | ✅ Active | | Payoneer | 🌐 Global | ✅ Active | | ShurjoPay | 🇧🇩 Bangladesh | ✅ Active | | PaySpace | 🇿🇦 South Africa | ✅ Active | | Payriff | 🇦🇿 Azerbaijan | ✅ Active | | Epoint | 🇦🇿 Azerbaijan | ✅ Active | | ePay | 🇧🇬 Bulgaria | ✅ Active | | PayNet | 🇲🇩 Moldova | ✅ Active | | PortWallet | 🌐 Global | ✅ Active | | Omise | 🇹🇭 Thailand | ✅ Active | | YouCanPay | 🇲🇦 Morocco | ✅ Active | | YooKassa | 🇷🇺 Russia | ✅ Active | | FreeKassa | 🇷🇺 Russia | ✅ Active | | Unitpay | 🇷🇺 Russia | ✅ Active |

₿ Cryptocurrency Payment Systems

| Provider | Features | Status | |----------|----------|--------| | Plisio | BTC, ETH, USDT +20 cryptos | ✅ Active | | CoinPayments | 2000+ cryptocurrencies | ✅ Active | | Cryptomus | Multi-crypto support | ✅ Active | | Payeer | Crypto & fiat | ✅ Active | | Anypay | Crypto solutions | ✅ Active | | NowPayments | 150+ cryptos | ✅ Active | | Heleket | Crypto gateway | ✅ Active | | BitPay | BTC & crypto | ✅ Active | | CoinGate | 70+ cryptos | ✅ Active | | Volet | Crypto & fiat gateway | ✅ Active | | Coinbase Commerce | Crypto gateway | ✅ Active | | Perfect Money | E-currency | ✅ Active |

📦 Installation

npm install quickpos

Requirements:

• Node.js 18+
• npm or yarn

🚀 Quick Start

const QuickPos = require('quickpos');

const quickPos = new QuickPos({
  providers: {
    paytr: {
      merchantId: 'your-merchant-id',
      merchantKey: 'your-merchant-key',
      merchantSalt: 'your-merchant-salt',
      mode: 'test', // or 'live'
    }
  },
});

// Create a payment
const payment = await quickPos.paytr.createPayment({
  name: 'Premium Plan',
  amount: 29.99,
  currency: 'USD',
  callback_link: 'https://yourapp.com/callback',
  callback_id: 'order-123',
});

console.log('Payment URL:', payment.data.url);

🛠️ Usage

Basic Setup

const express = require('express');
const QuickPos = require('quickpos');

const app = express();
app.use(express.json());

const quickPos = new QuickPos({
  providers: {
    // Configure your providers here
    paypal: { /* config */ },
    stripe: { /* config */ },
  },
});

// Add middleware
app.use(quickPos.middleware());

// Create payment endpoint
app.post('/create-payment', async (req, res) => {
  try {
    const result = await quickPos.paypal.createPayment({
      amount: req.body.amount,
      currency: req.body.currency,
      name: req.body.productName,
    });
    res.json(result);
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
});

// Handle callbacks
app.post('/payment-callback/:provider', quickPos.handleCallback(), (req, res) => {
  console.log('Payment result:', req.paymentResult);
  res.send('OK');
});

app.listen(3000, () => console.log('Server running on port 3000'));

Advanced Configuration

const quickPos = new QuickPos({
  providers: {
    paytr: {
      merchantId: process.env.PAYTR_MERCHANT_ID,
      merchantKey: process.env.PAYTR_MERCHANT_KEY,
      merchantSalt: process.env.PAYTR_MERCHANT_SALT,
      mode: process.env.NODE_ENV === 'production' ? 'live' : 'test',
    },
    cryptomus: {
      apiKey: process.env.CRYPTOMUS_API_KEY,
      merchantId: process.env.CRYPTOMUS_MERCHANT_ID,
    },
  },
  options: {
    timeout: 30000,
    retryAttempts: 3,
  },
});

📚 API Reference

QuickPos Class

Constructor

new QuickPos(config)

Parameters:

• config.providers (Object): Provider configurations
• config.options (Object, optional): Global options

Methods

createPayment(provider, data)

Creates a new payment with specified provider.

Parameters:

• provider (string): Provider name
• data (Object): Payment data

Returns: Promise

handleCallback(provider)

Middleware for handling payment callbacks.

Parameters:

• provider (string): Provider name

Returns: Express middleware function

🛣️ Roadmap

🎯 Upcoming Features

• [ ] 🏦 New Payment Providers: Stripe, Square, Adyen
• [ ] 🌐 Multi-Language Support: i18n integration
• [ ] 💸 Multi-Currency Support: Automatic conversion
• [ ] 📱 Mobile SDK: React Native & Flutter support
• [ ] 🔍 Advanced Analytics: Real-time dashboards
• [ ] 🤖 AI-Powered Routing: Smart provider selection
• [ ] 📝 Enhanced Documentation: Interactive API docs

✅ Completed Integrations

| Provider | Status | Date | |----------|--------|------| | PayTR | ✅ | v1.0.0 | | Shopier | ✅ | v1.0.1 | | Cryptomus | ✅ | v1.0.2 | | Payeer | ✅ | v1.0.3 | | Papara | ✅ | v1.0.4 | | İyzico | ✅ | v1.0.5 | | Anypay | ✅ | v1.1.0 | | EsnekPos | ✅ | v1.1.1 | | PayMaya | ✅ | v1.1.2 | | FedaPay | ✅ | v1.1.3 | | Heleket | ✅ | v1.1.4 | | Paydisini | ✅ | v1.1.5 | | PayPal | ✅ | v1.2.0 | | Paymentwall | ✅ | v1.2.1 | | Konnect | ✅ | v1.2.2 | | PayME | ✅ | v1.2.3 | | PrimePayments | ✅ | v1.2.4 | | YallaPay | ✅ | v1.2.5 | | NowPayments | ✅ | v1.2.6 | | NoonPayments | ✅ | v1.2.7 | | PayOP | ✅ | v1.2.8 | | Midtrans | ✅ | v1.2.9 | | Plisio | ✅ | v1.3.0 | | Tripay | ✅ | v1.3.0 | | And 30+ more... | ✅ | Ongoing |

🤝 Contributing

We welcome contributions! Here's how you can help:

Ways to Contribute

• 🐛 Report Bugs: Open issues for bugs you find
• 💡 Suggest Features: Share your ideas for new features
• 🔧 Code Contributions: Submit pull requests
• 📖 Documentation: Help improve docs
• 🧪 Testing: Add test cases

Development Setup

# Fork and clone the repository
git clone https://github.com/your-username/QuickPos.git
cd QuickPos

# Install dependencies
npm install

# Run tests
npm test

# Start development
npm run dev

Guidelines

• Follow the existing code style
• Add tests for new features
• Update documentation
• Use conventional commits

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Built with ❤️ by QuickPanel.NET

Empowering businesses with seamless payment solutions worldwide

⭐ Star us on GitHub • 🐛 Report Issues • 📧 Contact

🇹🇷 Türkçe Dokümantasyon

Özellikler

• 🔌 Çoklu Sağlayıcı Desteği: 50+ ödeme ağ geçidi
• 🛡️ Güvenli İşlemler: Kurumsal düzey güvenlik
• ⚡ Hızlı Entegrasyon: Dakikalar içinde başlayın
• 📊 Detaylı Raporlama: Kapsamlı analizler

Kurulum

npm install quickpos

Hızlı Başlangıç

const QuickPos = require('quickpos');

const quickPos = new QuickPos({
  providers: {
    paytr: {
      merchantId: 'merchant-id',
      merchantKey: 'merchant-key',
      merchantSalt: 'merchant-salt',
      mode: 'test',
    }
  },
});

const odeme = await quickPos.paytr.createPayment({
  name: 'Premium Paket',
  amount: 29.99,
  currency: 'TRY',
  callback_link: 'https://uygulamaniz.com/callback',
  callback_id: 'siparis-123',
});

Daha fazla detay için yukarıdaki İngilizce dokümantasyonu inceleyin.