quickpos 1.0.4 → 1.0.6

package/example-papara.js

@@ -0,0 +1,112 @@
+const PaparaClient = require('./lib/papara');
+const express = require('express');
+const bodyParser = require('body-parser');
+const app = express();
+app.use(bodyParser.json());
+
+const papara = new PaparaClient({
+    apiKey: 'xxxx',
+    merchantSecretKey: 'xxxx'
+}, true);
+
+app.post('/callback', async (req, res) => {
+    try {
+        const result = await papara.handleCallback(req.body);
+        console.log(result);
+        /*
+        {
+            status: 'success',
+            orderId: '1234',
+            uuid: '39061b51-7688-4287-9f90-5b1aa4a25178',
+            amount: 1,
+            currency: 0,
+            paymentMethod: 0
+        }
+        */
+        res.send('OK');
+    } catch (error) {
+        res.status(400).send(error.message);
+    }
+});
+
+app.listen(80, () => console.log('Server started'));
+
+// Ödeme oluşturma örneği
+(async () => {
+    const payment = await papara.createPayment({
+        amount: 1,
+        nameSurname: 'Test Customer',
+        referenceId: '1234',
+        currency: 'USD', // TRY, USD, EUR
+        orderDescription: 'Test Payment',
+        notificationUrl: 'https://test.dalamangoldtaxi.net/callback',
+        redirectUrl: 'https://your-domain.com'
+    });
+    /*
+
+
+    {
+        data: {
+            merchant: {
+                id: '2f73fd0a-d480-4f6f-a2a3-4c663ffbc26d',
+                balances: [Array],
+                legalName: 'TEST2',
+                iconUrl: null,
+                brandName: 'TEST2',
+                allowedPaymentTypes: [Array],
+                allowingGuestCheckout: true,
+                allowingPaparaCheckout: false,
+                isCorporateCardsListOnPaparaAppEnabled: true,
+                atmDepositEnabled: false
+            },
+            userName: null,
+            relatedTransactions: [],
+            totalRefundedAmount: 0,
+            id: 'f825a55e-598c-411b-af80-a729fd3c13d1',
+            createdAt: '2025-01-03T21:59:38.1511487',
+            merchantId: '2f73fd0a-d480-4f6f-a2a3-4c663ffbc26d',
+            userId: null,
+            paymentMethod: 0,
+            paymentMethodDescription: null,
+            referenceId: '1234',
+            orderDescription: 'Test Payment',
+            status: 0,
+            statusDescription: null,
+            amount: 1,
+            fee: 0,
+            currency: 0,
+            currencyInfo: {
+            currencyEnum: 0,
+            symbol: '₺',
+            code: 'TRY',
+            number: 949,
+            preferredDisplayCode: 'TL',
+            name: 'Türk Lirası',
+            isCryptocurrency: false,
+            isInternationalMoneyTransferCurrency: false,
+            precision: 2,
+            iconUrl: 'https://dkto9gpxgolik.cloudfront.net/icons/currencies/try.svg',
+            flagUrl: 'https://dkto9gpxgolik.cloudfront.net/icons/currencies/try_flag.png',
+            currencyEnumIso: 949,
+            isMetalCurrency: false
+            },
+            notificationUrl: 'https://your-domain.com/callback',
+            failNotificationUrl: null,
+            notificationDone: false,
+            paymentUrl: 'https://test.papara.com/checkout/f825a55e-598c-411b-af80-a729fd3c13d1',
+            merchantSecretKey: null,
+            remainingRefundAmount: null,
+            returningRedirectUrl: 'https://your-domain.com?paymentId=f825a55e-598c-411b-af80-a729fd3c13d1&referenceId=1234&status=0&amount=1&paymentId=f825a55e-598c-411b-af80-a729fd3c13d1&referenceId=1234&status=0&amount=1',
+            errorCode: null,
+            errorMessage: null,
+            turkishNationalId: 0,
+            secureType: 1,
+            basketUrl: null
+        },
+        succeeded: true
+        }
+    */
+
+    // console.log(payment);
+    console.log(payment.data.paymentUrl);   
+})();

package/lib/papara.js

@@ -0,0 +1,145 @@
+const axios = require('axios');
+
+class PaparaClient {
+    constructor(config) {
+        const requiredFields = ['apiKey', 'merchantSecretKey'];
+        for (let field of requiredFields) {
+            if (!config[field]) throw new Error(`Missing required field: ${field}`);
+        }
+
+        this.URL = config?.test ? 'https://merchant-api.test.papara.com' : 'https://merchant.papara.com';
+        console.log(this.URL);
+        this.merchantSecretKey = config.merchantSecretKey;
+        this.client = axios.create({
+            baseURL: this.URL,
+            headers: {
+                'ApiKey': config.apiKey,
+                'Content-Type': 'application/json'
+            }
+        });
+
+        this.client.interceptors.response.use(response => {
+            return response;
+        }, error => {
+            if (error.response) {
+                throw new Error(`Papara API error: ${error.response.data.message}`);
+            }
+            throw new Error(`Papara API error: ${error.message}`);
+        });
+    }
+
+    async createPayment(options) {
+        try {
+            let currencys = {
+                'TRY': 0,
+                'USD': 1,
+                'EUR': 2
+            }
+
+            const response = await this.client.post('/payments', {
+                amount: Number(options.amount),
+                nameSurname: options.nameSurname,
+                referenceId: options.referenceId,
+                currency: currencys[options.currency],
+                orderDescription: options.orderDescription,
+                notificationUrl: options.notificationUrl,
+                redirectUrl: options.redirectUrl
+            });
+            return response.data;
+        } catch (error) {
+            throw new Error(`Payment creation error: ${error.message}`);
+        }
+    }
+
+    async getAccount() {
+        try {
+            const response = await this.client.get('/account');
+            return response.data;
+        } catch (error) {
+            throw new Error(`Account info error: ${error.message}`);
+        }
+    }
+
+    async getAccountLedger(options) {
+        try {
+            const response = await this.client.post('/account/ledgers', {
+                startDate: options.startDate,
+                endDate: options.endDate,
+                page: options.page || 1,
+                pageSize: options.pageSize || 50
+            });
+            return response.data;
+        } catch (error) {
+            throw new Error(`Account ledger error: ${error.message}`);
+        }
+    }
+
+    async getPaymentStatus(paymentId) {
+        try {
+            const response = await this.client.get(`/payments?id=${paymentId}`);
+            return response.data;
+        } catch (error) {
+            throw new Error(`Payment status error: ${error.message}`);
+        }
+    }
+
+    async handleCallback(callbackData) {
+        try {
+            const verification = await this.verifyPaymentCallback(callbackData);
+            
+            if (!verification.status) {
+                throw new Error(verification.error.message);
+            }
+
+            return {
+                status: 'success',
+                orderId: verification.data.referenceId,
+                uuid: verification.data.id,
+                amount: parseFloat(verification.data.amount),
+                currency: verification.data.currency,
+                paymentMethod: verification.data.paymentMethod
+            };
+        } catch (error) {
+            throw new Error(`Error in Papara callback handling: ${error.message}`);
+        }
+    }
+
+    async verifyPaymentCallback(data) {
+        try {
+            if (data.status !== 1) {
+                return {
+                    status: false,
+                    error: {
+                        code: data?.errorCode,
+                        message: data?.errorMessage || 'Payment failed'
+                    }
+                };
+            }
+            
+            if (data.merchantSecretKey !== this.merchantSecretKey) {
+                return {
+                    status: false,
+                    error: {
+                        code: 401,
+                        message: 'Invalid merchant secret key'
+                    }
+                };
+            }
+
+            return {
+                status: true,
+                data: data
+            };
+        } catch (error) {
+            return {
+                status: false,
+                error: {
+                    code: 500,
+                    message: error.message
+                }
+            };
+        }
+    }
+}
+
+module.exports = PaparaClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quickpos",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "main": "app.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -25,7 +25,8 @@
     "paypal",
     "shopier",
     "cryptomus",
-    "payeer"
+    "payeer",
+    "papara"
   ],
   "repository": {
     "type": "git",

package/readme.md

@@ -1,6 +1,6 @@
 # 💳 QuickPos 🚀
 
-QuickPos, farklı ödeme sağlayıcılarını destekleyen güçlü bir ödeme entegrasyon modülüdür. Şu anda PayTR, Shopier, Cryptomus, Payeer sağlayıcısını desteklemektedir ve gelecekte birçok yeni sağlayıcı ile özellik eklemeyi planlamaktadır. Yol haritamıza göz atarak gelecek özellikleri keşfedebilirsiniz.
+QuickPos, farklı ödeme sağlayıcılarını destekleyen güçlü bir ödeme entegrasyon modülüdür. Şu anda PayTR, Shopier, Cryptomus, Payeer, Papara sağlayıcısını desteklemektedir ve gelecekte birçok yeni sağlayıcı ile özellik eklemeyi planlamaktadır. Yol haritamıza göz atarak gelecek özellikleri keşfedebilirsiniz.
 
 ---
 
@@ -136,6 +136,7 @@ const quickPos = new QuickPos({
 - Shopier
 - Cryptomus
 - Payeer
+- Papara
 
 ---
 
@@ -154,6 +155,7 @@ const quickPos = new QuickPos({
 - [x] Shopier entegrasyonu
 - [x] Cryptomus entegrasyonu
 - [x] Payeer entegrasyonu
+- [x] Papara entegrasyonu
 - [ ] İyzico entegrasyonu
 - [ ] Vallet entegrasyonu
 - [ ] Shipy entegrasyonu