wahdx-api 1.0.0

package/README.md

@@ -0,0 +1,161 @@
+# wahdx-api
+
+Package untuk generate QRIS dan cek payment status secara realtime dengan API OrderKuota dari [https://api.wahdx.co](https://api.wahdx.co).
+
+## Fitur
+
+- Membaca dan ekstrak kode QR dari gambar
+- Generate kode QR dengan nominal tertentu
+- Cek status pembayaran secara realtime
+- Generate bukti transaksi (receipt)
+
+## Instalasi
+
+```bash
+npm install wahdx-api
+```
+
+## Konfigurasi
+
+Buat file `.env` di root project Anda:
+
+```
+WAHDX_TOKENKEY=your_wahdx_token_key
+ORKUT_TOKEN_AUTH=your_orkut_token_auth
+ORKUT_USERNAME=your_orkut_username
+```
+
+## Penggunaan
+
+### Contoh Lengkap
+
+```javascript
+import QRISPayment from 'wahdx-api';
+import '@dotenvx/dotenvx/config';
+import fs from 'fs';
+
+// Konfigurasi
+const config = {
+    storeName: 'AHDX STORE',
+    defaultQrPath: 'QRIS.png', // Path ke QRIS static yang didownload di merchant orderkuota
+    tokenKey: process.env.WAHDX_TOKENKEY,
+    auth_token: process.env.ORKUT_TOKEN_AUTH,
+    auth_username: process.env.ORKUT_USERNAME
+};
+
+// Membuat instance QRISPayment
+const qrisPayment = new QRISPayment(config);
+
+async function main() {
+    try {
+        console.log('=== TEST REALTIME QRIS PAYMENT ===\n');
+        const randomAmount = Math.floor(Math.random() * 99) + 1; // Random 1-99
+        const amount = 100 + randomAmount; // Base 100 + random amount
+        const reference = 'REF' + Date.now();
+        
+        // Generate QR code
+        const { qrBuffer } = await qrisPayment.generateQRFromImage(amount);
+        
+        // Save QR code image
+        fs.writeFileSync(`qr-${amount}.png`, qrBuffer);
+        
+        console.log('=== TRANSACTION DETAILS ===');
+        console.log('Reference:', reference);
+        console.log('Amount:', amount);
+        console.log('QR Image:', `qr-${amount}.png`);
+        console.log('\nSilakan scan QR code dan lakukan pembayaran');
+        console.log('\nMenunggu pembayaran...\n');
+
+        // Check payment status with 5 minutes timeout
+        const startTime = Date.now();
+        const timeout = 5 * 60 * 1000;
+
+        while (Date.now() - startTime < timeout) {
+            const result = await qrisPayment.checkPayment(reference, amount);
+            
+            if (result.success && result.data.status === 'PAID') {
+                console.log('✓ Pembayaran berhasil!');
+                if (result.receipt) {
+                    console.log('✓ Bukti transaksi:', result.receipt.filePath);
+                }
+                return;
+            }
+
+            await new Promise(resolve => setTimeout(resolve, 10000));   // delay 10 detik
+            console.log('Menunggu pembayaran...');
+        }
+
+        throw new Error('Timeout: Pembayaran tidak diterima dalam 5 menit');
+        
+    } catch (error) {
+        console.error('Error:', error.message);
+    }
+}
+
+main();
+```
+
+### API Reference
+
+#### Inisialisasi
+
+```javascript
+import QRISPayment from 'wahdx-api';
+
+const config = {
+    storeName: 'NAMA TOKO',
+    defaultQrPath: 'path/to/qris/template.png',
+    tokenKey: 'your_wahdx_token_key',
+    auth_token: 'your_orkut_token_auth',
+    auth_username: 'your_orkut_username'
+};
+
+const qrisPayment = new QRISPayment(config);
+```
+
+#### Generate QR dari Template
+
+```javascript
+const amount = 10000; // Rp 10.000
+// Menggunakan default QR yang sudah diatur
+const { qrString, qrBuffer } = await qrisPayment.generateQRFromImage(amount);
+// Atau dengan path QR spesifik
+// const { qrString, qrBuffer } = await qrisPayment.generateQRFromImage(amount, 'path/to/qris/template.png');
+
+// Simpan QR ke file
+fs.writeFileSync('qr-output.png', qrBuffer);
+```
+
+#### Cek Status Pembayaran
+
+```javascript
+const reference = 'REF' + Date.now();
+const amount = 10000;
+
+const result = await qrisPayment.checkPayment(reference, amount);
+console.log(result);
+/*
+Output jika berhasil:
+{
+  success: true,
+  data: {
+    status: 'PAID',
+    amount: 10000,
+    reference: 'REF1234567890',
+    ...
+  },
+  receipt: {
+    filePath: 'path/to/receipt.pdf',
+    ...
+  }
+}
+*/
+```
+
+## Persyaratan Sistem
+
+- Node.js >= 20.18.3
+
+## Lisensi
+
+MIT 

package/dist/index.js

@@ -0,0 +1,61 @@
+import QRISGenerator from './qr-generator.js';
+import PaymentChecker from './payment-checker.js';
+import ReceiptGenerator from './receipt-generator.js';
+
+class QRISPayment {
+    constructor(config = {}) {
+        this.qrGenerator = new QRISGenerator(config);
+        this.paymentChecker = new PaymentChecker(config);
+        this.receiptGenerator = new ReceiptGenerator(config);
+    }
+
+    /**
+     * Membaca QR code dari file gambar dan mengekstrak baseQrString
+     * @param {string} imagePath - Path ke file gambar QR
+     * @returns {Promise<string>} - Promise yang menghasilkan baseQrString
+     */
+    async readQRCode(imagePath) {
+        return await this.qrGenerator.readQRFromImage(imagePath);
+    }
+
+    /**
+     * Generate QR dengan nominal tertentu
+     * @param {number} amount - Nominal pembayaran
+     * @returns {Promise<{qrString: string, qrBuffer: Buffer}>}
+     */
+    async generateQR(amount) {
+        const qrString = this.qrGenerator.generateQrString(amount);
+        const qrBuffer = await this.qrGenerator.generateQRWithLogo(qrString);
+        return {
+            qrString,
+            qrBuffer
+        };
+    }
+
+    /**
+     * Membaca QR dari file gambar dan langsung menghasilkan QR baru dengan nominal
+     * @param {number} amount - Nominal pembayaran
+     * @param {string} qrImagePath - Path ke gambar QR (opsional)
+     * @returns {Promise<{qrString: string, qrBuffer: Buffer}>}
+     */
+    async generateQRFromImage(amount, qrImagePath = null) {
+        return await this.qrGenerator.generateQRFromImage(amount, qrImagePath);
+    }
+
+    async checkPayment(reference, amount) {
+        const result = await this.paymentChecker.checkPaymentStatus(reference, amount);
+        if (result.success && result.data.status === 'PAID') {
+            const receipt = await this.receiptGenerator.generateReceipt(result.data);
+            result.receipt = receipt;
+        }
+        
+        return result;
+    }
+
+    async generateReceipt(transactionData) {
+        return await this.receiptGenerator.generateReceipt(transactionData);
+    }
+}
+
+// Mengekspor kelas utama
+export default QRISPayment;

package/dist/payment-checker.js

@@ -0,0 +1,90 @@
+import axios from 'axios';
+
+class PaymentChecker {
+    constructor(config) {
+        if (!config.tokenKey || !config.auth_username || !config.auth_token) {
+            throw new Error('tokenKey, auth_username, dan auth_token harus diisi');
+        }
+        this.config = {
+            tokenKey: config.tokenKey,
+            auth_username: config.auth_username,
+            auth_token: config.auth_token
+        };
+    }
+    
+    async checkPaymentStatus(reference, amount) {
+        try {
+            if (!reference || !amount || amount <= 0) {
+                throw new Error('Reference dan amount harus diisi dengan benar');
+            }
+            
+            const response = await axios.post(
+                'https://api.wahdx.co/api/mutasi-orkut-v2',
+                {
+                    username_orkut: this.config.auth_username,
+                    token_orkut: this.config.auth_token
+                },
+                {
+                    headers: {
+                        'tokenKey': this.config.tokenKey,
+                        'Content-Type': 'application/json'
+                    }
+                }
+            );
+            
+            if (!response.data || !response.data.status || !response.data.data) {
+                throw new Error('Response tidak valid dari server');
+            }
+            
+            const transactions = response.data.data;
+            
+            const matchingTransactions = transactions.filter(tx => {
+                const txAmount = parseInt(tx.amount);
+                const txDate = new Date(tx.date);
+                const now = new Date();
+                const timeDiff = now - txDate;
+                
+                return txAmount === amount && 
+                       tx.qris === "static" &&
+                       tx.type === "CR" &&
+                       timeDiff <= 5 * 60 * 1000;
+            });
+
+            if (matchingTransactions.length > 0) {
+                const latestTransaction = matchingTransactions.reduce((latest, current) => {
+                    const currentDate = new Date(current.date);
+                    const latestDate = new Date(latest.date);
+                    return currentDate > latestDate ? current : latest;
+                });
+                
+                return {
+                    success: true,
+                    data: {
+                        status: 'PAID',
+                        amount: parseInt(latestTransaction.amount),
+                        reference: latestTransaction.issuer_reff,
+                        date: latestTransaction.date,
+                        brand_name: latestTransaction.brand_name,
+                        buyer_reff: latestTransaction.buyer_reff
+                    }
+                };
+            }
+            
+            return {
+                success: true,
+                data: {
+                    status: 'UNPAID',
+                    amount: amount,
+                    reference: reference
+                }
+            };
+        } catch (error) {
+            return {
+                success: false,
+                error: 'Gagal cek status pembayaran: ' + error.message
+            };
+        }
+    }
+}
+
+export default PaymentChecker;

package/dist/qr-generator.js

@@ -0,0 +1,202 @@
+import QRCode from 'qrcode';
+import { createCanvas, loadImage } from 'canvas';
+import fs from 'fs';
+import sharp from 'sharp';
+import jsQR from 'jsqr';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+class QRISGenerator {
+    constructor(config = {}) {
+        this.config = {
+            baseQrString: config.baseQrString || '',
+            logoPath: config.logoPath || null,
+            defaultQrPath: config.defaultQrPath || 'QRIS.png'
+        };
+    }
+
+    /**
+     * Membaca QR code dari gambar dan mengekstrak baseQrString
+     * @param {string} imagePath - Path relatif atau absolut ke file gambar QR
+     * @returns {Promise<string>} - Promise yang menghasilkan baseQrString
+     */
+    async readQRFromImage(imagePath) {
+        try {
+            // Konversi path relatif ke absolut jika diperlukan
+            const absolutePath = path.isAbsolute(imagePath) 
+                ? imagePath 
+                : path.resolve(process.cwd(), imagePath);
+            
+            // Periksa apakah file ada
+            if (!fs.existsSync(absolutePath)) {
+                throw new Error(`File tidak ditemukan: ${absolutePath}`);
+            }
+            
+            // Baca gambar menggunakan Sharp
+            const image = sharp(absolutePath);
+            const metadata = await image.metadata();
+            const { width, height } = metadata;
+            
+            // Konversi ke raw pixel data
+            const rawData = await image
+                .raw()
+                .toBuffer();
+            
+            // Format data untuk jsQR
+            const imageData = new Uint8ClampedArray(width * height * 4);
+            
+            for (let i = 0; i < rawData.length; i += 3) { // RGB format
+                const pixelIndex = (i / 3) * 4; // Convert RGB index to RGBA index
+                imageData[pixelIndex] = rawData[i];     // R
+                imageData[pixelIndex + 1] = rawData[i + 1]; // G
+                imageData[pixelIndex + 2] = rawData[i + 2]; // B
+                imageData[pixelIndex + 3] = 255;            // A (full opacity)
+            }
+            
+            // Dekode QR code menggunakan jsQR
+            const code = jsQR(imageData, width, height);
+            
+            if (code) {
+                // Simpan baseQrString yang dibaca ke config
+                this.config.baseQrString = code.data;
+                return code.data;
+            } else {
+                throw new Error('QR code tidak terdeteksi dalam gambar');
+            }
+        } catch (error) {
+            console.error('Error saat membaca QR code:', error);
+            throw error;
+        }
+    }
+
+    /**
+     * Membaca QR code dari file default (biasanya QRIS.png)
+     * @returns {Promise<string>} - Promise yang menghasilkan baseQrString
+     */
+    async readDefaultQR() {
+        try {
+            // Path default ke file QRIS.png
+            const defaultPath = path.resolve(process.cwd(), this.config.defaultQrPath);
+            return await this.readQRFromImage(defaultPath);
+        } catch (error) {
+            console.error(`Error saat membaca gambar default (${this.config.defaultQrPath}):`, error);
+            throw error;
+        }
+    }
+
+    async generateQRWithLogo(qrString) {
+        try {
+            if (!qrString) {
+                throw new Error('qrString tidak boleh kosong');
+            }
+            const canvas = createCanvas(500, 500);
+            const ctx = canvas.getContext('2d');
+            await QRCode.toCanvas(canvas, qrString, {
+                errorCorrectionLevel: 'H',
+                margin: 2,
+                width: 500,
+                color: {
+                    dark: '#000000',
+                    light: '#ffffff'
+                }
+            });
+            if (this.config.logoPath && fs.existsSync(this.config.logoPath)) {
+                const logo = await loadImage(this.config.logoPath);
+                const logoSize = canvas.width * 0.2;
+                const logoPosition = (canvas.width - logoSize) / 2;
+
+                ctx.fillStyle = '#FFFFFF';
+                ctx.fillRect(logoPosition - 5, logoPosition - 5, logoSize + 10, logoSize + 10);
+                ctx.drawImage(logo, logoPosition, logoPosition, logoSize, logoSize);
+            }
+            return canvas.toBuffer('image/png');
+        } catch (error) {
+            throw new Error('Gagal generate QR: ' + error.message);
+        }
+    }
+
+    /**
+     * Membaca QR dari file kemudian generate QR baru dengan nominal
+     * @param {number} amount - Nominal pembayaran
+     * @param {string} qrImagePath - Path ke gambar QR (opsional)
+     * @returns {Promise<{qrString: string, qrBuffer: Buffer}>}
+     */
+    async generateQRFromImage(amount, qrImagePath = null) {
+        try {
+            // Jika path gambar disediakan, baca dari path tersebut
+            if (qrImagePath) {
+                await this.readQRFromImage(qrImagePath);
+            } 
+            // Jika tidak ada path dan baseQrString kosong, gunakan default
+            else if (!this.config.baseQrString) {
+                await this.readDefaultQR();
+            }
+            
+            // Generate QR string dengan nominal
+            const qrString = this.generateQrString(amount);
+            
+            // Generate QR image
+            const qrBuffer = await this.generateQRWithLogo(qrString);
+            
+            return {
+                qrString,
+                qrBuffer
+            };
+        } catch (error) {
+            throw new Error('Gagal generate QR dari gambar: ' + error.message);
+        }
+    }
+
+    generateQrString(amount) {
+        try {
+            if (!amount || amount <= 0) {
+                throw new Error('Nominal harus lebih besar dari 0');
+            }
+            
+            if (!this.config.baseQrString) {
+                throw new Error('BaseQrString tidak tersedia. Gunakan readQRFromImage terlebih dahulu atau berikan baseQrString pada config.');
+            }
+            
+            if (!this.config.baseQrString.includes("5802ID")) {
+                throw new Error("Format QRIS tidak valid");
+            }
+            
+            const finalAmount = Math.floor(amount);
+            const qrisBase = this.config.baseQrString.slice(0, -4).replace("010211", "010212");
+            const nominalStr = finalAmount.toString();
+            const nominalTag = `54${nominalStr.length.toString().padStart(2, '0')}${nominalStr}`;
+            const insertPosition = qrisBase.indexOf("5802ID");
+            const qrisWithNominal = qrisBase.slice(0, insertPosition) + nominalTag + qrisBase.slice(insertPosition);
+            const checksum = this.calculateCRC16(qrisWithNominal);
+            
+            return qrisWithNominal + checksum;
+        } catch (error) {
+            throw new Error('Gagal generate string QRIS: ' + error.message);
+        }
+    }
+
+    calculateCRC16(str) {
+        try {
+            if (!str) {
+                throw new Error('String tidak boleh kosong');
+            }
+
+            let crc = 0xFFFF;
+            for (let i = 0; i < str.length; i++) {
+                crc ^= str.charCodeAt(i) << 8;
+                for (let j = 0; j < 8; j++) {
+                    crc = (crc & 0x8000) ? ((crc << 1) ^ 0x1021) : (crc << 1);
+                }
+                crc &= 0xFFFF;
+            }
+            return crc.toString(16).toUpperCase().padStart(4, '0');
+        } catch (error) {
+            throw new Error('Gagal kalkulasi CRC16: ' + error.message);
+        }
+    }
+}
+
+export default QRISGenerator;

package/dist/receipt-generator.js

@@ -0,0 +1,130 @@
+import PDFDocument from 'pdfkit';
+import fs from 'fs';
+import moment from 'moment';
+import path from 'path';
+
+class ReceiptGenerator {
+    constructor(config) {
+        this.config = config;
+    }
+
+    async generateReceipt(transactionData) {
+        return new Promise((resolve, reject) => {
+            try {
+                const doc = new PDFDocument({
+                    size: [300, 450],
+                    margin: 20,
+                    layout: 'portrait'
+                });
+
+                const fileName = `receipt_${transactionData.reference}_${Date.now()}.pdf`;
+                const filePath = `receipts/${fileName}`;
+                if (!fs.existsSync('receipts')) {
+                    fs.mkdirSync('receipts');
+                }
+                const writeStream = fs.createWriteStream(filePath);
+                doc.pipe(writeStream);
+
+                if (this.config.logoPath && fs.existsSync(this.config.logoPath)) {
+                    const logoWidth = 40;
+                    const logoHeight = 40;
+                    const logoX = 20 + (260 - logoWidth) / 2;
+                    const logoY = 10;
+                    doc.image(this.config.logoPath, logoX, logoY, { width: logoWidth, height: logoHeight });
+                    doc.y = logoY + logoHeight + 4;
+                } else {
+                    doc.moveDown(0.5);
+                }
+
+                doc.fontSize(14)
+                   .fillColor('black')
+                   .font('Helvetica-Bold');
+                const headerText = 'QRIS PAYMENT RECEIPT';
+                const headerWidth = doc.widthOfString(headerText);
+                doc.text(headerText, 20 + (260 - headerWidth) / 2, doc.y, { width: headerWidth });
+
+                doc.fontSize(9)
+                   .font('Helvetica');
+                const merchantText = this.config.storeName || 'STORE NAME';
+                const merchantWidth = doc.widthOfString(merchantText);
+                doc.text(merchantText, 20 + (260 - merchantWidth) / 2, doc.y, { width: merchantWidth });
+
+                doc.moveDown(0.3);
+                const lineY = doc.y;
+                doc.moveTo(20, lineY)
+                   .lineTo(280, lineY)
+                   .strokeColor('#888').stroke();
+
+                doc.moveDown(0.5);
+                doc.fontSize(9)
+                   .font('Helvetica-Bold');
+                const detailsTitle = 'TRANSACTION DETAILS';
+                const detailsTitleWidth = doc.widthOfString(detailsTitle);
+                doc.text(detailsTitle, 20 + (260 - detailsTitleWidth) / 2, doc.y, { width: detailsTitleWidth });
+                doc.moveDown(0.2);
+
+                const formattedDate = moment(transactionData.date).format('DD/MM/YYYY HH:mm:ss');
+                const details = [
+                    ['Reference', transactionData.reference],
+                    ['Date', formattedDate],
+                    ['Amount', `Rp ${transactionData.amount.toLocaleString('id-ID')}`],
+                    ['Status', transactionData.status],
+                    ['Payment Method', transactionData.brand_name || '-'],
+                    ['Buyer Reference', transactionData.buyer_reff || '-']
+                ];
+
+                const tableWidth = 240;
+                const startX = (300 - tableWidth) / 2;
+                const labelWidth = 100;
+                const valueWidth = 130;
+                let y = doc.y + 5;
+
+                details.forEach(([label, value], idx) => {
+                    doc.font('Helvetica-Bold')
+                       .fontSize(9)
+                       .fillColor('black')
+                       .text(label, startX, y, { width: labelWidth, align: 'left' });
+                    doc.font('Helvetica')
+                       .fontSize(9)
+                       .fillColor('black')
+                       .text(value, startX + labelWidth, y, { width: valueWidth, align: 'right' });
+
+                    y += 14;
+                    doc.moveTo(startX, y)
+                       .lineTo(startX + labelWidth + valueWidth, y)
+                       .strokeColor('#e0e0e0').stroke();
+                    y += 2;
+                });
+
+                y += 6;
+                doc.moveTo(20, y)
+                   .lineTo(280, y)
+                   .strokeColor('#888').stroke();
+
+                y += 12;
+                doc.text('Thank you for your payment!', 0, y, { align: 'right', width: 260 });
+                y += 12;
+                doc.text(`Receipt No: ${transactionData.reference}`, 0, y, { align: 'right', width: 260 });
+
+                doc.end();
+
+                writeStream.on('finish', () => {
+                    resolve({
+                        success: true,
+                        filePath: filePath,
+                        fileName: fileName
+                    });
+                });
+
+                writeStream.on('error', (error) => {
+                    reject(error);
+                });
+
+            } catch (error) {
+                reject(error);
+            }
+        });
+    }
+}
+
+export default ReceiptGenerator;

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "wahdx-api",
+  "version": "1.0.0",
+  "description": "Package untuk generate QRIS dan cek payment status secara realtime dengan API OrderKuota dari https://api.wahdx.co",
+  "main": "dist/index.js",
+  "author": "wahdalo",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wahdalo/wahdx-api"
+  },
+  "keywords": [
+    "payment",
+    "rest-api",
+    "payment-gateway"
+  ],
+  "scripts": {
+    "test": "node tes.js",
+    "start": "node dist/index.js",
+    "build": "node scripts/build.js",
+    "prepublishOnly": "npm run build",
+    "pack": "npm pack --dry-run"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@dotenvx/dotenvx": "^1.47.5",
+    "axios": "^1.10.0",
+    "canvas": "^3.1.2",
+    "jsqr": "^1.4.0",
+    "moment": "^2.29.4",
+    "pdfkit": "^0.13.0",
+    "qrcode": "^1.5.4",
+    "sharp": "^0.32.6"
+  },
+  "engines": {
+    "node": ">=20.18.3"
+  }
+}