vxgate 1.0.0 → 2.0.0

package/README.md

@@ -2,6 +2,13 @@
 
 Violetics Payment Gateway SDK — terima pembayaran QRIS via Orderkuota dengan 3 baris kode.
 
+## Get API Key
+
+1. Daftar di **[pg.vltcx.eu.cc/register](https://pg.vltcx.eu.cc/register)**
+2. Verifikasi akun kamu
+3. Buka **Dashboard → API Keys** → Generate key baru
+4. Copy key dengan format `vlt_xxx` — siap dipakai
+
 ## Install
 
 ```bash
@@ -82,15 +89,38 @@ const result = await pay.poll('ORDER-001', {
 
 ### `.createAndWait(paymentOpts, [pollOpts])` → `Promise<{payment, result}>`
 
-Shortcut: buat + poll sekaligus.
+Shortcut: buat + poll sekaligus. Return object `{ payment, result }` — `payment` berisi data QR dan `result` berisi status akhir.
 
 ```js
 const { payment, result } = await pay.createAndWait(
   { amount: 15000, referenceId: 'ORDER-001' },
   { intervalMs: 3000, timeoutMs: 300_000 }
 );
+
+// Data QR & order ada di `payment`:
+console.log(payment.qrisUrl);     // URL gambar QR → tampilkan ke customer
+console.log(payment.qrisString);  // string QRIS raw (untuk generate QR sendiri)
+console.log(payment.referenceId); // reference ID order
+console.log(payment.amount);      // nominal actual (bisa ada suffix unik)
+
+// Status pembayaran ada di `result`:
+console.log(result.paid);         // true jika lunas
+console.log(result.payerBrand);   // 'GOPAY' | 'OVO' | 'DANA' | ...
 ```
 
+> **Catatan:** `createAndWait` akan **menunggu** sampai pembayaran `paid` atau `expired`. QR sudah tersedia di `payment` segera setelah fungsi mulai polling — tapi kalau kamu perlu **menampilkan QR dulu** sebelum menunggu, gunakan `.create()` + `.poll()` secara terpisah:
+>
+> ```js
+> // Pattern: tampilkan QR dulu, baru poll
+> const payment = await pay.create({ amount: 15000 });
+> tampilkanQR(payment.qrisUrl); // langsung tampilkan ke user
+>
+> const result = await pay.poll(payment.referenceId, {
+>   onPoll: (n, status) => console.log(`[#${n}] ${status}`),
+> });
+> if (result.paid) console.log('Lunas!');
+> ```
+
 ### `.list([opts])` → `Promise<Transaction[]>`
 
 Daftar transaksi.
@@ -170,5 +200,7 @@ const { VioleticsPayment } = require('vxgate');
 
 ## Links
 
+- [Register](https://pg.vltcx.eu.cc/register) — daftar & dapatkan API key
 - [Documentation](https://pg.vltcx.eu.cc/docs)
 - [Dashboard](https://pg.vltcx.eu.cc/dashboard)
+- [GitHub](https://github.com/cv3inx/VXGate)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vxgate",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Violetics Payment Gateway SDK — QRIS payment via Orderkuota API",
   "keywords": ["qris", "payment", "orderkuota", "violetics", "indonesia", "payment-gateway"],
   "author": "Violetics",

package/src/index.js

@@ -42,7 +42,7 @@ const DEFAULT_BASE_URL = 'https://pg.vltcx.eu.cc/api';
  * @property {function} [onPoll]  (attempt: number, status: string) => void
  */
 
-class VioleticsPayment {
+class VXGatePayment {
   /**
    * @param {string} apiKey   - Violetics API Key (format: vlt_xxx)
    * @param {string} [baseUrl]
@@ -60,7 +60,7 @@ class VioleticsPayment {
     const res = await fetch(`${this._baseUrl}?${qs}`);
     const data = await res.json();
     if (!data.status && !data.success)
-      throw new VioleticsError(data.message ?? `HTTP ${res.status}`, res.status, data);
+      throw new VXGateError(data.message ?? `HTTP ${res.status}`, res.status, data);
     return data;
   }
 
@@ -72,7 +72,7 @@ class VioleticsPayment {
     });
     const data = await res.json();
     if (!data.status && !data.success)
-      throw new VioleticsError(data.message ?? `HTTP ${res.status}`, res.status, data);
+      throw new VXGateError(data.message ?? `HTTP ${res.status}`, res.status, data);
     return data;
   }
 
@@ -148,7 +148,7 @@ class VioleticsPayment {
       await new Promise(r => setTimeout(r, wait));
     }
 
-    throw new VioleticsTimeoutError(
+    throw new VXGateTimeoutError(
       `Polling timeout setelah ${timeoutMs / 1000}s`,
       referenceId,
       timeoutMs,
@@ -228,7 +228,7 @@ class VioleticsPayment {
       }
     }
     // Browser (Web Crypto — async, use verifyWebhookAsync instead)
-    throw new Error('Use VioleticsPayment.verifyWebhookAsync() in browser environments');
+    throw new Error('Use VXGatePayment.verifyWebhookAsync() in browser environments');
   }
 
   /**
@@ -250,23 +250,23 @@ class VioleticsPayment {
 
 // ── Custom errors ─────────────────────────────────────────────────────────
 
-class VioleticsError extends Error {
+class VXGateError extends Error {
   constructor(message, statusCode, response) {
     super(message);
-    this.name       = 'VioleticsError';
+    this.name       = 'VXGateError';
     this.statusCode = statusCode;
     this.response   = response;
   }
 }
 
-class VioleticsTimeoutError extends Error {
+class VXGateTimeoutError extends Error {
   constructor(message, referenceId, timeoutMs) {
     super(message);
-    this.name        = 'VioleticsTimeoutError';
+    this.name        = 'VXGateTimeoutError';
     this.referenceId = referenceId;
     this.timeoutMs   = timeoutMs;
   }
 }
 
-module.exports = { VioleticsPayment, VioleticsError, VioleticsTimeoutError };
-module.exports.default = VioleticsPayment;
+module.exports = { VXGatePayment, VXGateError, VXGateTimeoutError };
+module.exports.default = VXGatePayment;

package/src/index.mjs

@@ -1,3 +1,3 @@
 // ESM re-export wrapper
-export { VioleticsPayment, VioleticsError, VioleticsTimeoutError } from './index.js';
-export { VioleticsPayment as default } from './index.js';
+export { VXGatePayment, VXGateError, VXGateTimeoutError } from './index.js';
+export { VXGatePayment as default } from './index.js';