quickpos 1.0.916 → 1.0.917

package/lib/paynkolay.js

@@ -0,0 +1,193 @@
+const crypto = require('crypto');
+const axios = require('axios');
+
+class Paynkolay {
+    /**
+     * @param {Object} config
+     * @param {string} config.sx - SX parametresi (Panelden alınır)
+     * @param {string} config.merchantSecretKey - Gizli Anahtar
+     * @param {string} config.merchantNo - Mağaza Numarası (Callback doğrulama için)
+     * @param {boolean} [config.isTest=true] - Test ortamı mı?
+     */
+    constructor(config) {
+        this.sx = config.sx;
+        this.merchantSecretKey = config.merchantSecretKey;
+        this.merchantNo = config.merchantNo;
+        
+        // Postman'deki host bilgisine göre
+        this.baseUrl = config.isTest 
+            ? 'https://paynkolaytest.nkolayislem.com.tr' 
+            : 'https://paynkolay.nkolayislem.com.tr';
+    }
+
+    /**
+     * Link ile Ödeme Oluşturma (/Vpos/by-link-create)
+     * Postman'deki 'Link Oluştur' script'ine göre hazırlanmıştır.
+     */
+    async createPaymentLink(params) {
+        try {
+            const endpoint = '/Vpos/by-link-create';
+            
+            // Zorunlu alanlar için varsayılan değerler ve kontroller
+            const rnd = params.rnd || Date.now().toString();
+            const clientRefCode = params.clientRefCode || ('REF-' + rnd);
+            const customerKey = params.customerKey || ""; // Kart saklama yoksa boş
+            const amount = parseFloat(params.amount).toFixed(2); // 1000.00 formatı
+
+            // 1. HASH OLUŞTURMA (Postman Script'ine göre)
+            // Sıralama: sx|clientRefCode|amount|successUrl|failUrl|rnd|customerKey|merchantSecretKey
+            const hashString = [
+                this.sx,
+                clientRefCode,
+                amount,
+                params.successUrl,
+                params.failUrl,
+                rnd,
+                customerKey,
+                this.merchantSecretKey
+            ].join("|");
+
+            const hashDatav2 = this.generateHash(hashString);
+
+            // 2. FORM DATA HAZIRLAMA
+            const data = new URLSearchParams();
+            data.append('sx', this.sx);
+            data.append('clientRefCode', clientRefCode);
+            data.append('amount', amount);
+            data.append('successUrl', params.successUrl);
+            data.append('failUrl', params.failUrl);
+            data.append('rnd', rnd);
+            data.append('hashDatav2', hashDatav2);
+            data.append('use3D', params.use3D || 'true');
+            data.append('currencyCode', params.currencyCode || '949'); // 949 = TL
+            data.append('transactionType', 'SALES');
+            
+            // Opsiyonel (Link Detayları)
+            if (params.instalments) data.append('instalments', params.instalments);
+            if (params.second) data.append('second', params.second); // Link süresi (saniye)
+            if (params.cardHolderIP) data.append('cardHolderIP', params.cardHolderIP);
+            
+            // Link Sayfası Görünen Bilgiler
+            data.append('detail', 'true');
+            data.append('inputNamesurname', params.inputNamesurname || '');
+            data.append('inputDescription', params.inputDescription || '');
+            data.append('inputEmail', params.inputEmail || '');
+            data.append('inputAddress', params.inputAddress || '');
+            data.append('inputTckn', params.inputTckn || '');
+            data.append('inputPhone', params.inputPhone || '');
+
+            // 3. İSTEK GÖNDERME
+            const response = await axios.post(`${this.baseUrl}${endpoint}`, data, {
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded'
+                }
+            });
+
+            return response.data;
+
+        } catch (error) {
+            throw new Error(`Paynkolay Link Oluşturma Hatası: ${error.message}`);
+        }
+    }
+
+    /**
+     * Link Silme (/Vpos/by-link-url-remove)
+     */
+    async removePaymentLink(qParam) {
+        try {
+            const endpoint = '/Vpos/by-link-url-remove';
+
+            // HASH OLUŞTURMA (Link Sil Script'ine göre)
+            // Sıralama: sx|q|merchantSecretKey
+            const hashString = [
+                this.sx,
+                qParam, // Bu değer genelde referans kodudur
+                this.merchantSecretKey
+            ].join("|");
+
+            const hashDatav2 = this.generateHash(hashString);
+
+            const data = new URLSearchParams();
+            data.append('sx', this.sx);
+            data.append('q', qParam);
+            data.append('hashDatav2', hashDatav2);
+
+            const response = await axios.post(`${this.baseUrl}${endpoint}`, data, {
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded'
+                }
+            });
+
+            return response.data;
+
+        } catch (error) {
+            throw new Error(`Paynkolay Link Silme Hatası: ${error.message}`);
+        }
+    }
+
+    /**
+     * Callback (Bildirim) Doğrulama
+     * Ödeme sonrası Paynkolay'ın successUrl'e gönderdiği veriyi doğrular.
+     */
+    handleCallback(params) {
+        const {
+            RESPONSE_CODE,
+            MERCHANT_NO,
+            REFERENCE_CODE,
+            AUTH_CODE,
+            USE_3D,
+            RND,
+            INSTALLMENT,
+            AUTHORIZATION_AMOUNT,
+            CURRENCY_CODE,
+            hashDataV2
+        } = params;
+
+        // 1. İşlem Başarılı mı kontrolü
+        if (RESPONSE_CODE !== "2" && RESPONSE_CODE !== 2) {
+            return { status: false, message: 'İşlem başarısız (RESPONSE_CODE != 2)' };
+        }
+
+        // 2. Hash Hesaplama (Dokümantasyondaki 'Response Hash Testi' sırası)
+        // MERCHANT_NO | REFERENCE_CODE | AUTH_CODE | RESPONSE_CODE | USE_3D | RND | INSTALLMENT | AUTHORIZATION_AMOUNT | CURRENCY_CODE | MERCHANT_SECRET_KEY
+        
+        const hashString = [
+            MERCHANT_NO,
+            REFERENCE_CODE,
+            AUTH_CODE,
+            RESPONSE_CODE,
+            USE_3D, // Gelen değer string "true" veya "false" olabilir, olduğu gibi kullanılmalı
+            RND,
+            INSTALLMENT,
+            AUTHORIZATION_AMOUNT,
+            CURRENCY_CODE,
+            this.merchantSecretKey
+        ].join("|");
+
+        const calculatedHash = this.generateHash(hashString);
+
+        if (calculatedHash === hashDataV2) {
+            return { 
+                status: 'success', 
+                message: 'Doğrulama Başarılı',
+                amount: AUTHORIZATION_AMOUNT,
+                orderId: params.CLIENT_REFERENCE_CODE || REFERENCE_CODE
+            };
+        } else {
+            console.error("Hash String (Local):", hashString);
+            console.error("Calculated:", calculatedHash);
+            console.error("Received:", hashDataV2);
+            return { status: false, message: 'Hash uyuşmazlığı (Güvenlik Hatası)' };
+        }
+    }
+
+    /**
+     * SHA-512 Base64 Helper
+     */
+    generateHash(str) {
+        // UTF-8 encoding önemlidir (CryptoJS.SHA512 davranışı)
+        return crypto.createHash('sha512').update(str, 'utf8').digest('base64');
+    }
+}
+
+module.exports = Paynkolay;

package/lib/paywant.js

@@ -0,0 +1,137 @@
+const crypto = require('crypto');
+const axios = require('axios');
+
+class Paywant {
+  /**
+   * Paywant Kurucu Metodu
+   * @param {Object} config
+   * @param {string} config.apiKey - Paywant API Anahtarı
+   * @param {string} config.apiSecret - Paywant Gizli Anahtar
+   */
+  constructor(config) {
+    if (!config.apiKey || !config.apiSecret) {
+      throw new Error('Paywant: apiKey ve apiSecret zorunludur.');
+    }
+    this.apiKey = config.apiKey;
+    this.apiSecret = config.apiSecret;
+    this.baseUrl = 'https://secure.paywant.com';
+  }
+
+  /**
+   * Ödeme Linki Oluşturma (/payment/token)
+   * @param {Object} params
+   */
+  async createPayment(params) {
+    try {
+      // Zorunlu alan kontrolü
+      const required = ['userID', 'userEmail', 'userAccountName', 'userIp', 'productData'];
+      for (const field of required) {
+        if (!params[field]) throw new Error(`Paywant: ${field} alanı zorunludur.`);
+      }
+
+      // 1. Hash Oluşturma (Dokümantasyona Göre)
+      // Sıralama: userName|userEmail|userID + ApiKey
+      const hashString = `${params.userAccountName}|${params.userEmail}|${params.userID}${this.apiKey}`;
+      const hash = this.generateHash(hashString);
+
+      // 2. API'ye Gönderilecek Veri
+      const payload = {
+        apiKey: this.apiKey,
+        userAccountName: params.userAccountName,
+        userEmail: params.userEmail,
+        userID: parseInt(params.userID), // int64 olmalı
+        userIPAddress: params.userIp,
+        hash: hash,
+        proApi: true, // Ürün verisini biz gönderiyoruz
+        productData: {
+          name: params.productData.name, // Ürün adı
+          amount: parseFloat(params.productData.amount), // Tutar (100.00 gibi)
+          extraData: params.productData.extraData || '', // Sipariş No vb.
+          paymentChannel: params.productData.paymentChannel || '0', // 0 = Hepsi
+          commissionType: params.productData.commissionType || '1' // 1: Müşteri, 2: Mağaza öder
+        }
+      };
+
+      // 3. İsteği Gönder
+      const response = await axios.post(`${this.baseUrl}/payment/token`, payload, {
+        headers: {
+          'Content-Type': 'application/json'
+        }
+      });
+
+      const result = response.data;
+
+      if (result.status === true) {
+        // Başarılı ise ödeme linkini döndür
+        return {
+          status: 'success',
+          link: result.message // Örn: https://secure.paywant.com/common/TOKEN
+        };
+      } else {
+        // Paywant'tan dönen hata
+        throw new Error(result.message || 'Paywant ödeme oluşturulamadı.');
+      }
+
+    } catch (error) {
+      if (error.response) {
+        throw new Error(`Paywant API Hatası: ${JSON.stringify(error.response.data)}`);
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * IPN (Bildirim) Doğrulama
+   * Paywant'tan gelen POST isteğini doğrular.
+   * @param {Object} reqBody - Express request body
+   */
+  handleCallback(reqBody) {
+    const {
+      transactionID,
+      extraData,
+      userID,
+      userAccountName,
+      status,
+      paymentChannel,
+      paymentTotal,
+      netProfit,
+      hash
+    } = reqBody;
+
+    if (!hash) throw new Error('Hash parametresi eksik.');
+
+    // Dokümantasyondaki IPN Hash Formülü:
+    // transactionID|extraData|userID|userAccountName|status|paymentChannel|paymentTotal|netProfit + ApiKey
+    const hashString = `${transactionID}|${extraData}|${userID}|${userAccountName}|${status}|${paymentChannel}|${paymentTotal}|${netProfit}${this.apiKey}`;
+    
+    const generatedHash = this.generateHash(hashString);
+
+    if (hash === generatedHash) {
+      // Status 100 = Başarılı
+      if (parseInt(status) === 100) {
+        return {
+          status: 'success',
+          orderId: extraData, // Genelde sipariş no extraData'ya konur
+          transactionId: transactionID,
+          amount: parseFloat(paymentTotal),
+          netAmount: parseFloat(netProfit)
+        };
+      } else {
+        return { success: false, message: 'Ödeme başarısız veya beklemede.' };
+      }
+    } else {
+      throw new Error('Hash uyuşmazlığı (Bad Hash)');
+    }
+  }
+
+  /**
+   * HMAC-SHA256 Hash Üretici (Base64)
+   */
+  generateHash(data) {
+    return crypto.createHmac('sha256', this.apiSecret)
+      .update(data)
+      .digest('base64');
+  }
+}
+
+module.exports = Paywant;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quickpos",
-  "version": "1.0.916",
+  "version": "1.0.917",
   "main": "app.js",
   "scripts": {
     "test": "node test.js"

package/readme.md

@@ -75,7 +75,11 @@
 | **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 |