@crediblemark/buayar 0.1.5 → 0.1.6

package/README.md

@@ -10,13 +10,16 @@ Dengan SDK ini, Anda cukup menulis kode satu kali menggunakan struktur API yang
 ---
 
 ## 🚀 Fitur Utama
-
+ 
 - 🔄 **Unified API**: Satu antarmuka (interface) terpadu untuk semua provider payment gateway.
+- ⚡ **Direct Payment Support**: Otomatis mendeteksi `paymentMethod` dan beralih ke Direct Inquiry API (v2/inquiry) Duitku untuk mengembalikan `vaNumber`, `qrString` (EMVCo), dan `paymentCode` secara instan tanpa redirect eksternal.
+- 🏷️ **Pre-Categorization (Accordion Ready)**: Menyediakan pengelompokan pembayaran bawaan (`Virtual Account`, `QRIS`, `E-Wallet`, `Retail / Gerai`, `Lainnya`) langsung dari API response untuk memudahkan implementasi UI accordion.
+- 🎨 **Headless SDK Philosophy**: Dirancang murni sebagai core logic & data manager tanpa overhead UI/styling. Memberikan kebebasan penuh bagi pengembang untuk mendesain UI/Tailwind/dark mode di tingkat aplikasi.
 - 🛡️ **Tipe Data Kuat (TypeScript)**: Dilengkapi dengan deklarasi tipe data lengkap untuk mencegah *runtime error*.
 - 🇮🇩 **Dukungan Lokal**: Siap digunakan untuk transaksi di Indonesia (seperti Duitku).
 - ⚙️ **Modular & Dapat Diperluas**: Memungkinkan penambahan provider baru dengan mewarisi kelas base yang disediakan.
 - 🔒 **Otomatisasi Signature**: Keamanan transaksi terjamin dengan pembuatan *hash* signature (MD5, SHA-256) otomatis secara internal.
-
+ 
 ---
 
 ## 📦 Instalasi
@@ -218,11 +221,26 @@ interface InvoiceResponse {
   success: boolean;
   paymentUrl?: string;
   reference?: string;
+  vaNumber?: string;       // Nomor Virtual Account (untuk metode Bank VA)
+  qrString?: string;       // EMVCo QRIS payload mentah (untuk scan langsung)
+  qrCodeUrl?: string;      // Image URL QRIS dari Duitku
+  paymentCode?: string;    // Kode pembayaran retail (Indomaret/Alfamart)
   rawResponse: any;
   error?: string;
 }
 ```
 
+### `PaymentMethod`
+```typescript
+interface PaymentMethod {
+  paymentMethod: string;
+  paymentName: string;
+  paymentImage: string;
+  totalFee: string;
+  category: "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Lainnya";
+}
+```
+
 ### `VerifyCallbackResult`
 ```typescript
 interface VerifyCallbackResult {
@@ -236,6 +254,19 @@ interface VerifyCallbackResult {
 
 ---
 
+## 🛠️ Utilitas Tambahan
+
+### `getPaymentMethodCategory(code, name)`
+Mengkategorikan kode dan nama metode pembayaran Duitku ke kategori terstandarisasi untuk UI Accordion.
+```typescript
+import { getPaymentMethodCategory } from "@crediblemark/buayar";
+
+const cat = getPaymentMethodCategory("BT", "Permata VA"); 
+// Output: "Virtual Account"
+```
+
+---
+
 ## 📄 Lisensi
 
 Proyek ini dilisensikan di bawah **MIT License**. Hak Cipta © 2026 Rasyiqi Crediblemark.

package/dist/index.d.mts

@@ -9,11 +9,21 @@ interface CreateInvoiceParams {
     };
     returnUrl: string;
     callbackUrl: string;
+    /** Specific Duitku payment method code (e.g. "BCA", "I1", "OV"). If omitted, all methods are available via Duitku's redirect page. */
+    paymentMethod?: string;
 }
 interface InvoiceResponse {
     success: boolean;
     paymentUrl?: string;
     reference?: string;
+    /** Virtual Account number (for bank VA methods) */
+    vaNumber?: string;
+    /** QRIS string for display in a QR code */
+    qrString?: string;
+    /** Duitku-hosted QR code image URL */
+    qrCodeUrl?: string;
+    /** Generic payment code (for retail/minimarket methods like Indomaret) */
+    paymentCode?: string;
     rawResponse: any;
     error?: string;
 }
@@ -29,19 +39,64 @@ interface ProviderConfig {
     apiKey: string;
     sandbox: boolean;
 }
+interface GetPaymentMethodsParams {
+    /** Transaction amount (integer, no decimal) */
+    amount: number;
+}
+interface PaymentMethod {
+    /** Provider-specific method code, e.g. "BT", "I1", "OL" */
+    paymentMethod: string;
+    /** Human-readable name, e.g. "BCA Virtual Account" */
+    paymentName: string;
+    /** URL to payment method logo/image */
+    paymentImage: string;
+    /** Total transaction fee in IDR (string from API) */
+    totalFee: string;
+    /** Categorized payment channel (Virtual Account, QRIS, E-Wallet, Retail / Gerai, Kartu Kredit, Paylater / Cicilan, Lainnya) */
+    category: "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
+}
+interface GetPaymentMethodsResult {
+    success: boolean;
+    methods: PaymentMethod[];
+    error?: string;
+    rawResponse: any;
+}
+interface CheckTransactionParams {
+    /** The merchant order ID used when creating the invoice */
+    merchantOrderId: string;
+}
+interface CheckTransactionResult {
+    success: boolean;
+    orderId: string;
+    reference: string;
+    amount: number;
+    /** "00" = success/paid, "01" = pending, "02" = failed/expired */
+    statusCode: string;
+    status: "paid" | "pending" | "failed";
+    statusMessage: string;
+    error?: string;
+    rawResponse: any;
+}
 
 declare abstract class BasePaymentProvider {
     abstract readonly name: string;
     abstract createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     abstract verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    abstract getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    abstract checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 
 declare class DuitkuProvider extends BasePaymentProvider {
     readonly name = "duitku";
+    private getBaseUrl;
     createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 
+declare function getPaymentMethodCategory(code: string, name?: string): "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
+
 declare class PaymentManager {
     private providers;
     constructor();
@@ -49,7 +104,9 @@ declare class PaymentManager {
     getProvider(name: string): BasePaymentProvider;
     createInvoice(providerName: string, params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(providerName: string, body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(providerName: string, params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(providerName: string, params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 declare const paymentManager: PaymentManager;
 
-export { BasePaymentProvider, type CreateInvoiceParams, DuitkuProvider, type InvoiceResponse, PaymentManager, type ProviderConfig, type VerifyCallbackResult, paymentManager };
+export { BasePaymentProvider, type CheckTransactionParams, type CheckTransactionResult, type CreateInvoiceParams, DuitkuProvider, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, PaymentManager, type PaymentMethod, type ProviderConfig, type VerifyCallbackResult, getPaymentMethodCategory, paymentManager };

package/dist/index.d.ts

@@ -9,11 +9,21 @@ interface CreateInvoiceParams {
     };
     returnUrl: string;
     callbackUrl: string;
+    /** Specific Duitku payment method code (e.g. "BCA", "I1", "OV"). If omitted, all methods are available via Duitku's redirect page. */
+    paymentMethod?: string;
 }
 interface InvoiceResponse {
     success: boolean;
     paymentUrl?: string;
     reference?: string;
+    /** Virtual Account number (for bank VA methods) */
+    vaNumber?: string;
+    /** QRIS string for display in a QR code */
+    qrString?: string;
+    /** Duitku-hosted QR code image URL */
+    qrCodeUrl?: string;
+    /** Generic payment code (for retail/minimarket methods like Indomaret) */
+    paymentCode?: string;
     rawResponse: any;
     error?: string;
 }
@@ -29,19 +39,64 @@ interface ProviderConfig {
     apiKey: string;
     sandbox: boolean;
 }
+interface GetPaymentMethodsParams {
+    /** Transaction amount (integer, no decimal) */
+    amount: number;
+}
+interface PaymentMethod {
+    /** Provider-specific method code, e.g. "BT", "I1", "OL" */
+    paymentMethod: string;
+    /** Human-readable name, e.g. "BCA Virtual Account" */
+    paymentName: string;
+    /** URL to payment method logo/image */
+    paymentImage: string;
+    /** Total transaction fee in IDR (string from API) */
+    totalFee: string;
+    /** Categorized payment channel (Virtual Account, QRIS, E-Wallet, Retail / Gerai, Kartu Kredit, Paylater / Cicilan, Lainnya) */
+    category: "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
+}
+interface GetPaymentMethodsResult {
+    success: boolean;
+    methods: PaymentMethod[];
+    error?: string;
+    rawResponse: any;
+}
+interface CheckTransactionParams {
+    /** The merchant order ID used when creating the invoice */
+    merchantOrderId: string;
+}
+interface CheckTransactionResult {
+    success: boolean;
+    orderId: string;
+    reference: string;
+    amount: number;
+    /** "00" = success/paid, "01" = pending, "02" = failed/expired */
+    statusCode: string;
+    status: "paid" | "pending" | "failed";
+    statusMessage: string;
+    error?: string;
+    rawResponse: any;
+}
 
 declare abstract class BasePaymentProvider {
     abstract readonly name: string;
     abstract createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     abstract verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    abstract getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    abstract checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 
 declare class DuitkuProvider extends BasePaymentProvider {
     readonly name = "duitku";
+    private getBaseUrl;
     createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 
+declare function getPaymentMethodCategory(code: string, name?: string): "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
+
 declare class PaymentManager {
     private providers;
     constructor();
@@ -49,7 +104,9 @@ declare class PaymentManager {
     getProvider(name: string): BasePaymentProvider;
     createInvoice(providerName: string, params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(providerName: string, body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(providerName: string, params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(providerName: string, params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 declare const paymentManager: PaymentManager;
 
-export { BasePaymentProvider, type CreateInvoiceParams, DuitkuProvider, type InvoiceResponse, PaymentManager, type ProviderConfig, type VerifyCallbackResult, paymentManager };
+export { BasePaymentProvider, type CheckTransactionParams, type CheckTransactionResult, type CreateInvoiceParams, DuitkuProvider, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, PaymentManager, type PaymentMethod, type ProviderConfig, type VerifyCallbackResult, getPaymentMethodCategory, paymentManager };

package/dist/index.js

@@ -33,6 +33,7 @@ __export(index_exports, {
   BasePaymentProvider: () => BasePaymentProvider,
   DuitkuProvider: () => DuitkuProvider,
   PaymentManager: () => PaymentManager,
+  getPaymentMethodCategory: () => getPaymentMethodCategory,
   paymentManager: () => paymentManager
 });
 module.exports = __toCommonJS(index_exports);
@@ -44,13 +45,30 @@ var import_crypto = __toESM(require("crypto"));
 var BasePaymentProvider = class {
 };
 
+// src/utils.ts
+function getPaymentMethodCategory(code, name = "") {
+  const c = code.toUpperCase();
+  const n = name.toUpperCase();
+  if (c.includes("QR") || n.includes("QRIS")) return "QRIS";
+  if (c.includes("VA") || n.includes("VA") || n.includes("VIRTUAL ACCOUNT") || ["I1", "BT", "A1", "M2", "V1", "B1", "AG", "NC", "BR", "S1", "BS", "MY"].some((p) => c.startsWith(p.slice(0, 2)))) return "Virtual Account";
+  if (["OV", "GO", "SH", "DA", "LA", "OL", "SL", "GP", "OP", "DN", "JA", "JN", "JP"].some((p) => c.startsWith(p.slice(0, 2))) || n.includes("OVO") || n.includes("DANA") || n.includes("GOPAY") || n.includes("LINKAJA") || n.includes("SHOPEEPAY") || n.includes("JENIUS")) return "E-Wallet";
+  if (c.startsWith("FT") || c.startsWith("AL") || n.includes("INDOMARET") || n.includes("ALFAMART") || n.includes("RETAIL")) return "Retail / Gerai";
+  if (c.startsWith("VC") || n.includes("CREDIT CARD") || n.includes("KARTU KREDIT")) return "Kartu Kredit";
+  if (n.includes("PAYLATER") || n.includes("INDODANA") || n.includes("AKULAKU") || n.includes("KREDIVO")) return "Paylater / Cicilan";
+  return "Lainnya";
+}
+
 // src/providers/duitku.ts
 var DuitkuProvider = class extends BasePaymentProvider {
   name = "duitku";
+  getBaseUrl(sandbox) {
+    return sandbox ? "https://api-sandbox.duitku.com" : "https://api-prod.duitku.com";
+  }
   async createInvoice(params, config) {
     const { orderId, amount, productDetails, customer, returnUrl, callbackUrl } = params;
     const { merchantCode, apiKey, sandbox } = config;
-    const url = sandbox ? "https://api-sandbox.duitku.com/api/merchant/createInvoice" : "https://api-prod.duitku.com/api/merchant/createInvoice";
+    const isDirectInquiry = !!params.paymentMethod;
+    const url = isDirectInquiry ? sandbox ? "https://sandbox.duitku.com/webapi/api/merchant/v2/inquiry" : "https://passport.duitku.com/webapi/api/merchant/v2/inquiry" : `${this.getBaseUrl(sandbox)}/api/merchant/createInvoice`;
     const integerAmount = Math.round(amount);
     const rawPayloadSignature = merchantCode + orderId + integerAmount.toString() + apiKey;
     const payloadSignature = import_crypto.default.createHash("md5").update(rawPayloadSignature).digest("hex");
@@ -67,19 +85,23 @@ var DuitkuProvider = class extends BasePaymentProvider {
       signature: payloadSignature,
       callbackUrl,
       returnUrl,
-      expiryPeriod: 1440
+      expiryPeriod: 1440,
       // 24 hours expiry
+      ...params.paymentMethod ? { paymentMethod: params.paymentMethod } : {}
     };
     try {
+      const headers = {
+        "Content-Type": "application/json",
+        "Accept": "application/json"
+      };
+      if (!isDirectInquiry) {
+        headers["x-duitku-signature"] = headerSignature;
+        headers["x-duitku-timestamp"] = timestamp;
+        headers["x-duitku-merchantcode"] = merchantCode;
+      }
       const response = await fetch(url, {
         method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "Accept": "application/json",
-          "x-duitku-signature": headerSignature,
-          "x-duitku-timestamp": timestamp,
-          "x-duitku-merchantcode": merchantCode
-        },
+        headers,
         body: JSON.stringify(payload)
       });
       const text = await response.text();
@@ -100,6 +122,10 @@ var DuitkuProvider = class extends BasePaymentProvider {
           success: true,
           paymentUrl: data.paymentUrl,
           reference: data.reference,
+          vaNumber: data.vaNumber,
+          qrString: data.qrString,
+          qrCodeUrl: data.qrCodeUrl,
+          paymentCode: data.paymentCode,
           rawResponse: data
         };
       } else {
@@ -135,6 +161,149 @@ var DuitkuProvider = class extends BasePaymentProvider {
       rawPayload: body
     };
   }
+  async getPaymentMethods(params, config) {
+    const { amount } = params;
+    const { merchantCode, apiKey, sandbox } = config;
+    const url = sandbox ? "https://sandbox.duitku.com/webapi/api/merchant/paymentmethod/getpaymentmethod" : "https://passport.duitku.com/webapi/api/merchant/paymentmethod/getpaymentmethod";
+    const integerAmount = Math.round(amount);
+    const datetime = (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, 19);
+    const stringToSign = merchantCode + integerAmount.toString() + datetime;
+    const signature = import_crypto.default.createHmac("sha256", apiKey).update(stringToSign).digest("hex");
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          merchantcode: merchantCode,
+          amount: integerAmount,
+          datetime,
+          signature
+        })
+      });
+      const text = await response.text();
+      let data = null;
+      try {
+        data = JSON.parse(text);
+      } catch (e) {
+      }
+      if (!response.ok || !data) {
+        return {
+          success: false,
+          methods: [],
+          rawResponse: data,
+          error: data?.responseMessage || `HTTP error! Status: ${response.status}`
+        };
+      }
+      if (data.responseCode === "00") {
+        const rawMethods = data.paymentFee || [];
+        const methods = rawMethods.map((m) => ({
+          paymentMethod: m.paymentMethod,
+          paymentName: m.paymentName,
+          paymentImage: m.paymentImage,
+          totalFee: m.totalFee,
+          category: getPaymentMethodCategory(m.paymentMethod, m.paymentName)
+        }));
+        return {
+          success: true,
+          methods,
+          rawResponse: data
+        };
+      } else {
+        return {
+          success: false,
+          methods: [],
+          rawResponse: data,
+          error: data.responseMessage || `Duitku Error: ${data.responseCode}`
+        };
+      }
+    } catch (e) {
+      return {
+        success: false,
+        methods: [],
+        rawResponse: null,
+        error: e.message || "Failed to get payment methods from Duitku"
+      };
+    }
+  }
+  async checkTransaction(params, config) {
+    const { merchantOrderId } = params;
+    const { merchantCode, apiKey, sandbox } = config;
+    const url = sandbox ? "https://api-sandbox.duitku.com/api/merchant/transactionStatus" : "https://api-prod.duitku.com/api/merchant/transactionStatus";
+    const timestamp = Date.now().toString();
+    const rawHeaderSignature = merchantCode + timestamp + apiKey;
+    const headerSignature = import_crypto.default.createHash("sha256").update(rawHeaderSignature).digest("hex");
+    const rawBodySignature = merchantCode + merchantOrderId + apiKey;
+    const bodySignature = import_crypto.default.createHash("md5").update(rawBodySignature).digest("hex");
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json",
+          "x-duitku-signature": headerSignature,
+          "x-duitku-timestamp": timestamp,
+          "x-duitku-merchantcode": merchantCode
+        },
+        body: JSON.stringify({
+          merchantCode,
+          merchantOrderId,
+          signature: bodySignature
+        })
+      });
+      const text = await response.text();
+      let data = null;
+      try {
+        data = JSON.parse(text);
+      } catch (e) {
+      }
+      if (!response.ok || !data) {
+        return {
+          success: false,
+          orderId: merchantOrderId,
+          reference: "",
+          amount: 0,
+          statusCode: "",
+          status: "failed",
+          statusMessage: `HTTP error! Status: ${response.status}`,
+          error: `HTTP ${response.status}`,
+          rawResponse: data
+        };
+      }
+      const statusCode = data.statusCode || "";
+      let status;
+      if (statusCode === "00") {
+        status = "paid";
+      } else if (statusCode === "01") {
+        status = "pending";
+      } else {
+        status = "failed";
+      }
+      return {
+        success: true,
+        orderId: data.merchantOrderId || merchantOrderId,
+        reference: data.reference || "",
+        amount: data.amount ? Number(data.amount) : 0,
+        statusCode,
+        status,
+        statusMessage: data.statusMessage || "",
+        rawResponse: data
+      };
+    } catch (e) {
+      return {
+        success: false,
+        orderId: merchantOrderId,
+        reference: "",
+        amount: 0,
+        statusCode: "",
+        status: "failed",
+        statusMessage: "Network error",
+        error: e.message || "Failed to check transaction status",
+        rawResponse: null
+      };
+    }
+  }
 };
 
 // src/index.ts
@@ -161,6 +330,14 @@ var PaymentManager = class {
     const provider = this.getProvider(providerName);
     return provider.verifyCallback(body, config);
   }
+  async getPaymentMethods(providerName, params, config) {
+    const provider = this.getProvider(providerName);
+    return provider.getPaymentMethods(params, config);
+  }
+  async checkTransaction(providerName, params, config) {
+    const provider = this.getProvider(providerName);
+    return provider.checkTransaction(params, config);
+  }
 };
 var paymentManager = new PaymentManager();
 // Annotate the CommonJS export names for ESM import in node:
@@ -168,5 +345,6 @@ var paymentManager = new PaymentManager();
   BasePaymentProvider,
   DuitkuProvider,
   PaymentManager,
+  getPaymentMethodCategory,
   paymentManager
 });

package/dist/index.mjs

@@ -5,13 +5,30 @@ import crypto from "crypto";
 var BasePaymentProvider = class {
 };
 
+// src/utils.ts
+function getPaymentMethodCategory(code, name = "") {
+  const c = code.toUpperCase();
+  const n = name.toUpperCase();
+  if (c.includes("QR") || n.includes("QRIS")) return "QRIS";
+  if (c.includes("VA") || n.includes("VA") || n.includes("VIRTUAL ACCOUNT") || ["I1", "BT", "A1", "M2", "V1", "B1", "AG", "NC", "BR", "S1", "BS", "MY"].some((p) => c.startsWith(p.slice(0, 2)))) return "Virtual Account";
+  if (["OV", "GO", "SH", "DA", "LA", "OL", "SL", "GP", "OP", "DN", "JA", "JN", "JP"].some((p) => c.startsWith(p.slice(0, 2))) || n.includes("OVO") || n.includes("DANA") || n.includes("GOPAY") || n.includes("LINKAJA") || n.includes("SHOPEEPAY") || n.includes("JENIUS")) return "E-Wallet";
+  if (c.startsWith("FT") || c.startsWith("AL") || n.includes("INDOMARET") || n.includes("ALFAMART") || n.includes("RETAIL")) return "Retail / Gerai";
+  if (c.startsWith("VC") || n.includes("CREDIT CARD") || n.includes("KARTU KREDIT")) return "Kartu Kredit";
+  if (n.includes("PAYLATER") || n.includes("INDODANA") || n.includes("AKULAKU") || n.includes("KREDIVO")) return "Paylater / Cicilan";
+  return "Lainnya";
+}
+
 // src/providers/duitku.ts
 var DuitkuProvider = class extends BasePaymentProvider {
   name = "duitku";
+  getBaseUrl(sandbox) {
+    return sandbox ? "https://api-sandbox.duitku.com" : "https://api-prod.duitku.com";
+  }
   async createInvoice(params, config) {
     const { orderId, amount, productDetails, customer, returnUrl, callbackUrl } = params;
     const { merchantCode, apiKey, sandbox } = config;
-    const url = sandbox ? "https://api-sandbox.duitku.com/api/merchant/createInvoice" : "https://api-prod.duitku.com/api/merchant/createInvoice";
+    const isDirectInquiry = !!params.paymentMethod;
+    const url = isDirectInquiry ? sandbox ? "https://sandbox.duitku.com/webapi/api/merchant/v2/inquiry" : "https://passport.duitku.com/webapi/api/merchant/v2/inquiry" : `${this.getBaseUrl(sandbox)}/api/merchant/createInvoice`;
     const integerAmount = Math.round(amount);
     const rawPayloadSignature = merchantCode + orderId + integerAmount.toString() + apiKey;
     const payloadSignature = crypto.createHash("md5").update(rawPayloadSignature).digest("hex");
@@ -28,19 +45,23 @@ var DuitkuProvider = class extends BasePaymentProvider {
       signature: payloadSignature,
       callbackUrl,
       returnUrl,
-      expiryPeriod: 1440
+      expiryPeriod: 1440,
       // 24 hours expiry
+      ...params.paymentMethod ? { paymentMethod: params.paymentMethod } : {}
     };
     try {
+      const headers = {
+        "Content-Type": "application/json",
+        "Accept": "application/json"
+      };
+      if (!isDirectInquiry) {
+        headers["x-duitku-signature"] = headerSignature;
+        headers["x-duitku-timestamp"] = timestamp;
+        headers["x-duitku-merchantcode"] = merchantCode;
+      }
       const response = await fetch(url, {
         method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "Accept": "application/json",
-          "x-duitku-signature": headerSignature,
-          "x-duitku-timestamp": timestamp,
-          "x-duitku-merchantcode": merchantCode
-        },
+        headers,
         body: JSON.stringify(payload)
       });
       const text = await response.text();
@@ -61,6 +82,10 @@ var DuitkuProvider = class extends BasePaymentProvider {
           success: true,
           paymentUrl: data.paymentUrl,
           reference: data.reference,
+          vaNumber: data.vaNumber,
+          qrString: data.qrString,
+          qrCodeUrl: data.qrCodeUrl,
+          paymentCode: data.paymentCode,
           rawResponse: data
         };
       } else {
@@ -96,6 +121,149 @@ var DuitkuProvider = class extends BasePaymentProvider {
       rawPayload: body
     };
   }
+  async getPaymentMethods(params, config) {
+    const { amount } = params;
+    const { merchantCode, apiKey, sandbox } = config;
+    const url = sandbox ? "https://sandbox.duitku.com/webapi/api/merchant/paymentmethod/getpaymentmethod" : "https://passport.duitku.com/webapi/api/merchant/paymentmethod/getpaymentmethod";
+    const integerAmount = Math.round(amount);
+    const datetime = (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, 19);
+    const stringToSign = merchantCode + integerAmount.toString() + datetime;
+    const signature = crypto.createHmac("sha256", apiKey).update(stringToSign).digest("hex");
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          merchantcode: merchantCode,
+          amount: integerAmount,
+          datetime,
+          signature
+        })
+      });
+      const text = await response.text();
+      let data = null;
+      try {
+        data = JSON.parse(text);
+      } catch (e) {
+      }
+      if (!response.ok || !data) {
+        return {
+          success: false,
+          methods: [],
+          rawResponse: data,
+          error: data?.responseMessage || `HTTP error! Status: ${response.status}`
+        };
+      }
+      if (data.responseCode === "00") {
+        const rawMethods = data.paymentFee || [];
+        const methods = rawMethods.map((m) => ({
+          paymentMethod: m.paymentMethod,
+          paymentName: m.paymentName,
+          paymentImage: m.paymentImage,
+          totalFee: m.totalFee,
+          category: getPaymentMethodCategory(m.paymentMethod, m.paymentName)
+        }));
+        return {
+          success: true,
+          methods,
+          rawResponse: data
+        };
+      } else {
+        return {
+          success: false,
+          methods: [],
+          rawResponse: data,
+          error: data.responseMessage || `Duitku Error: ${data.responseCode}`
+        };
+      }
+    } catch (e) {
+      return {
+        success: false,
+        methods: [],
+        rawResponse: null,
+        error: e.message || "Failed to get payment methods from Duitku"
+      };
+    }
+  }
+  async checkTransaction(params, config) {
+    const { merchantOrderId } = params;
+    const { merchantCode, apiKey, sandbox } = config;
+    const url = sandbox ? "https://api-sandbox.duitku.com/api/merchant/transactionStatus" : "https://api-prod.duitku.com/api/merchant/transactionStatus";
+    const timestamp = Date.now().toString();
+    const rawHeaderSignature = merchantCode + timestamp + apiKey;
+    const headerSignature = crypto.createHash("sha256").update(rawHeaderSignature).digest("hex");
+    const rawBodySignature = merchantCode + merchantOrderId + apiKey;
+    const bodySignature = crypto.createHash("md5").update(rawBodySignature).digest("hex");
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json",
+          "x-duitku-signature": headerSignature,
+          "x-duitku-timestamp": timestamp,
+          "x-duitku-merchantcode": merchantCode
+        },
+        body: JSON.stringify({
+          merchantCode,
+          merchantOrderId,
+          signature: bodySignature
+        })
+      });
+      const text = await response.text();
+      let data = null;
+      try {
+        data = JSON.parse(text);
+      } catch (e) {
+      }
+      if (!response.ok || !data) {
+        return {
+          success: false,
+          orderId: merchantOrderId,
+          reference: "",
+          amount: 0,
+          statusCode: "",
+          status: "failed",
+          statusMessage: `HTTP error! Status: ${response.status}`,
+          error: `HTTP ${response.status}`,
+          rawResponse: data
+        };
+      }
+      const statusCode = data.statusCode || "";
+      let status;
+      if (statusCode === "00") {
+        status = "paid";
+      } else if (statusCode === "01") {
+        status = "pending";
+      } else {
+        status = "failed";
+      }
+      return {
+        success: true,
+        orderId: data.merchantOrderId || merchantOrderId,
+        reference: data.reference || "",
+        amount: data.amount ? Number(data.amount) : 0,
+        statusCode,
+        status,
+        statusMessage: data.statusMessage || "",
+        rawResponse: data
+      };
+    } catch (e) {
+      return {
+        success: false,
+        orderId: merchantOrderId,
+        reference: "",
+        amount: 0,
+        statusCode: "",
+        status: "failed",
+        statusMessage: "Network error",
+        error: e.message || "Failed to check transaction status",
+        rawResponse: null
+      };
+    }
+  }
 };
 
 // src/index.ts
@@ -122,11 +290,20 @@ var PaymentManager = class {
     const provider = this.getProvider(providerName);
     return provider.verifyCallback(body, config);
   }
+  async getPaymentMethods(providerName, params, config) {
+    const provider = this.getProvider(providerName);
+    return provider.getPaymentMethods(params, config);
+  }
+  async checkTransaction(providerName, params, config) {
+    const provider = this.getProvider(providerName);
+    return provider.checkTransaction(params, config);
+  }
 };
 var paymentManager = new PaymentManager();
 export {
   BasePaymentProvider,
   DuitkuProvider,
   PaymentManager,
+  getPaymentMethodCategory,
   paymentManager
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crediblemark/buayar",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Unified Payment Gateway SDK for Node.js and TypeScript supporting multiple providers",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",