---
## ๐ Table of Contents
- [โจ Features](#-features)
- [๐ Supported Payment Providers](#-supported-payment-providers)
- [๐ฆ Installation](#-installation)
- [๐ Quick Start](#-quick-start)
- [๐ ๏ธ Usage](#๏ธ-usage)
- [๐ API Reference](#-api-reference)
- [๐ฃ๏ธ Roadmap](#๏ธ-roadmap)
- [๐ค Contributing](#-contributing)
- [๐ License](#-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
```bash
npm install quickpos
```
**Requirements:**
- Node.js 18+
- npm or yarn
---
## ๐ Quick Start
```javascript
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
```javascript
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
```javascript
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
```javascript
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
```bash
# 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](LICENSE) file for details.
---
**Built with โค๏ธ by [QuickPanel.NET](https://quickpanel.net)**
*Empowering businesses with seamless payment solutions worldwide*
[โญ Star us on GitHub](https://github.com/codedByCan/QuickPos) โข [๐ Report Issues](https://github.com/codedByCan/QuickPos/issues) โข [๐ง Contact](mailto:support@quickpanel.net)
---
## ๐น๐ท 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
```bash
npm install quickpos
```
### Hฤฑzlฤฑ Baลlangฤฑรง
```javascript
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. 
