@crediblemark/buayar 0.8.0 → 0.8.2

package/dist/index.js

@@ -288,16 +288,20 @@ var CANONICAL_TO_IPAYMU = {
   danamon_va: { paymentMethod: "va", paymentChannel: "danamon" },
   bsi_va: { paymentMethod: "va", paymentChannel: "bsi" },
   bag_va: { paymentMethod: "va", paymentChannel: "bag" },
+  btn_va: { paymentMethod: "va", paymentChannel: "btn" },
   muamalat_va: { paymentMethod: "va", paymentChannel: "bmi" },
   bmi_va: { paymentMethod: "va", paymentChannel: "bmi" },
   qris: { paymentMethod: "qris", paymentChannel: "mpm" },
   gopay_qris: { paymentMethod: "qris", paymentChannel: "mpm" },
   shopeepay_qris: { paymentMethod: "qris", paymentChannel: "mpm" },
+  dana: { paymentMethod: "ewallet", paymentChannel: "dana" },
+  shopeepay: { paymentMethod: "ewallet", paymentChannel: "shopeepay" },
   alfamart: { paymentMethod: "cstore", paymentChannel: "alfamart" },
   indomaret: { paymentMethod: "cstore", paymentChannel: "indomaret" },
   credit_card: { paymentMethod: "cc", paymentChannel: "cc" },
   akulaku: { paymentMethod: "paylater", paymentChannel: "akulaku" },
-  kredivo: { paymentMethod: "paylater", paymentChannel: "kredivo" }
+  kredivo: { paymentMethod: "paylater", paymentChannel: "kredivo" },
+  cod: { paymentMethod: "cod", paymentChannel: "cod" }
 };
 var CANONICAL_TO_XENDIT = {
   bca_va: { type: "VIRTUAL_ACCOUNT", channel_code: "BCA" },
@@ -482,6 +486,9 @@ function toIpaymuPaymentMethod(code) {
   if (lower.includes("alfa") || lower.includes("indo")) {
     return { paymentMethod: "cstore", paymentChannel: lower };
   }
+  if (lower.includes("dana") || lower.includes("shopee") || lower.includes("ovo") || lower.includes("gopay") || lower.includes("linkaja")) {
+    return { paymentMethod: "ewallet", paymentChannel: lower };
+  }
   return { paymentMethod: lower };
 }
 function toXenditPaymentMethod(code) {
@@ -1715,8 +1722,8 @@ var MidtransProvider = class extends BasePaymentProvider {
 // src/providers/ipaymu/signature.ts
 function generateIpaymuSignature(method, va, apiKey, body) {
   const timestamp = Date.now().toString();
-  const bodyString = body ? typeof body === "string" ? body : JSON.stringify(body) : "";
-  const bodyHash = body ? sha256(bodyString).toLowerCase() : "";
+  const bodyString = body ? typeof body === "string" ? body : JSON.stringify(body) : "{}";
+  const bodyHash = sha256(bodyString).toLowerCase();
   const stringToSign = `${method.toUpperCase()}:${va}:${bodyHash}:${apiKey}`;
   const signature = hmacSha256(stringToSign, apiKey);
   return { signature, timestamp };
@@ -1751,6 +1758,7 @@ var IpaymuProvider = class extends BasePaymentProvider {
     const redirectUrl = returnUrl || config.returnUrl || "https://localhost/return";
     const feeDirection = params.feeDirection || params.extra?.feeDirection || config.extra?.feeDirection;
     const escrow = params.escrow !== void 0 ? params.escrow : params.extra?.escrow !== void 0 ? params.extra?.escrow : config.extra?.escrow;
+    const subAccount = params.subAccountId || params.extra?.subAccountId || params.extra?.account || params.extra?.childAccount || params.account || config.extra?.account;
     let payload;
     if (isDirect) {
       payload = {
@@ -1767,6 +1775,7 @@ var IpaymuProvider = class extends BasePaymentProvider {
         ...ipaymuMethod.paymentChannel ? { paymentChannel: ipaymuMethod.paymentChannel } : {},
         ...feeDirection ? { feeDirection } : {},
         ...escrow !== void 0 ? { escrow } : {},
+        ...subAccount ? { account: subAccount } : {},
         ...params.providerParams
       };
     } else {
@@ -1789,6 +1798,7 @@ var IpaymuProvider = class extends BasePaymentProvider {
         buyerPhone: customer.phone || "081234567890",
         ...feeDirection ? { feeDirection } : {},
         ...escrow !== void 0 ? { escrow } : {},
+        ...subAccount ? { account: subAccount } : {},
         ...params.providerParams
       };
     }
@@ -1836,13 +1846,23 @@ var IpaymuProvider = class extends BasePaymentProvider {
           if (ipaymuMethod?.paymentMethod === "va") {
             res.vaNumber = resData.PaymentNo;
             res.vaBank = ipaymuMethod.paymentChannel;
+            res.mode = "va";
           } else if (ipaymuMethod?.paymentMethod === "cstore") {
             res.paymentCode = resData.PaymentNo;
+            res.mode = "retail";
           }
         }
         if (resData.QrString || resData.QrImage) {
           res.qrString = resData.QrString;
           res.qrCodeUrl = resData.QrImage || resData.QrTemplate;
+          res.mode = "qris";
+        }
+        if (ipaymuMethod?.paymentMethod === "ewallet") {
+          res.mode = "ewallet";
+          if (resData.Url) {
+            res.deeplink = resData.Url;
+            res.paymentUrl = resData.Url;
+          }
         }
         if (resData.Expired) {
           res.expiresAt = new Date(resData.Expired);
@@ -1891,221 +1911,110 @@ var IpaymuProvider = class extends BasePaymentProvider {
     const va = config.merchantCode || config.merchantId || "";
     const apiKey = config.apiKey || "";
     const sandbox = !!config.sandbox;
-    if (va && apiKey) {
-      try {
-        const url = `${this.getBaseUrl(sandbox)}/payment-method-list`;
-        const payload = { account: va };
-        const { signature, timestamp } = generateIpaymuSignature("POST", va, apiKey, payload);
-        const response = await fetch(url, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/json",
-            "Accept": "application/json",
-            "va": va,
-            "signature": signature,
-            "timestamp": timestamp
-          },
-          body: JSON.stringify(payload)
-        });
-        const data = await response.json().catch(() => null);
-        if (response.ok && data?.Data && Array.isArray(data.Data)) {
-          const methods = [];
-          const categories2 = {};
-          for (const group of data.Data) {
-            const groupCode = (group.Code || "").toLowerCase();
-            const groupName = group.Name || group.Description || "Lainnya";
-            const channels = group.Channels || [];
-            let category = "Lainnya";
-            if (groupCode === "va") category = "Virtual Account";
-            else if (groupCode === "cstore") category = "Retail / Gerai";
-            else if (groupCode === "qris") category = "QRIS";
-            else if (groupCode === "cc") category = "Kartu Kredit";
-            else if (groupCode === "paylater") category = "Paylater / Cicilan";
-            else if (groupCode === "cod") category = "COD";
-            else category = groupName;
-            for (const ch of channels) {
-              const chCode = (ch.Code || "").toLowerCase();
-              let canonicalCode = chCode;
-              if (groupCode === "va") {
-                canonicalCode = chCode === "bag" ? "bag_va" : chCode === "bmi" ? "muamalat_va" : `${chCode}_va`;
-              } else if (groupCode === "cc") {
-                canonicalCode = "credit_card";
-              }
-              let totalFee = "-";
-              if (ch.TransactionFee) {
-                if (ch.TransactionFee.ActualFeeType === "PERCENT") {
-                  totalFee = `${ch.TransactionFee.ActualFee}%`;
-                } else if (ch.TransactionFee.ActualFee !== void 0) {
-                  totalFee = `IDR ${Number(ch.TransactionFee.ActualFee).toLocaleString()}`;
-                }
+    if (!va || !apiKey) {
+      return {
+        success: false,
+        provider: "ipaymu",
+        methods: [],
+        categories: {},
+        error: "Missing iPaymu credentials (BUAYAR_MERCHANT_CODE/VA or BUAYAR_API_KEY)",
+        rawResponse: null
+      };
+    }
+    try {
+      const url = `${this.getBaseUrl(sandbox)}/payment-channels`;
+      const { signature, timestamp } = generateIpaymuSignature("GET", va, apiKey);
+      const response = await fetch(url, {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json",
+          "va": va,
+          "signature": signature,
+          "timestamp": timestamp
+        }
+      });
+      const data = await response.json().catch(() => null);
+      if (response.ok && data?.Data && Array.isArray(data.Data)) {
+        const methods = [];
+        const categories = {};
+        for (const group of data.Data) {
+          const groupCode = (group.Code || "").toLowerCase();
+          const groupName = group.Name || group.Description || "Lainnya";
+          const channels = group.Channels || [];
+          let category = "Lainnya";
+          if (groupCode === "va") category = "Virtual Account";
+          else if (groupCode === "cstore") category = "Retail / Gerai";
+          else if (groupCode === "qris") category = "QRIS";
+          else if (groupCode === "cc") category = "Kartu Kredit";
+          else if (groupCode === "paylater") category = "Paylater / Cicilan";
+          else if (groupCode === "cod") category = "COD";
+          else if (groupCode === "ewallet" || groupCode === "ewallet-asia") category = "E-Wallet";
+          else if (groupCode === "debitonline") category = "Debit Online";
+          else category = groupName;
+          for (const ch of channels) {
+            const chCode = (ch.Code || "").toLowerCase();
+            let canonicalCode = chCode;
+            if (groupCode === "va") {
+              canonicalCode = chCode === "bag" ? "bag_va" : chCode === "bmi" ? "muamalat_va" : `${chCode}_va`;
+            } else if (groupCode === "cc") {
+              canonicalCode = "credit_card";
+            } else if (groupCode === "qris") {
+              canonicalCode = "qris";
+            }
+            let totalFee = "-";
+            if (ch.TransactionFee) {
+              if (ch.TransactionFee.ActualFeeType === "PERCENT") {
+                totalFee = `${ch.TransactionFee.ActualFee}%`;
+              } else if (ch.TransactionFee.ActualFee !== void 0) {
+                totalFee = `IDR ${Number(ch.TransactionFee.ActualFee).toLocaleString()}`;
               }
-              const pm = {
-                paymentMethod: canonicalCode,
-                code: canonicalCode,
-                paymentName: ch.Name || ch.Description || canonicalCode,
-                paymentImage: `https://my.ipaymu.com/images/banks/${chCode}.png`,
-                totalFee,
-                category,
-                extra: {
-                  healthStatus: ch.HealthStatus,
-                  instructionsDoc: ch.PaymentInstructionsDoc,
-                  feeDetail: ch.TransactionFee
-                }
-              };
-              methods.push(pm);
-              if (!categories2[category]) categories2[category] = [];
-              categories2[category].push(pm);
             }
-          }
-          if (methods.length > 0) {
-            return {
-              success: true,
-              provider: "ipaymu",
-              methods,
-              categories: categories2,
-              rawResponse: data
+            const pm = {
+              paymentMethod: canonicalCode,
+              code: canonicalCode,
+              paymentName: ch.Name || ch.Description || canonicalCode,
+              paymentImage: ch.Logo || `https://my.ipaymu.com/images/banks/${chCode}.png`,
+              totalFee,
+              category,
+              extra: {
+                healthStatus: ch.HealthStatus,
+                featureStatus: ch.FeatureStatus,
+                instructionsDoc: ch.PaymentInstructionsDoc,
+                feeDetail: ch.TransactionFee
+              }
             };
+            methods.push(pm);
+            if (!categories[category]) categories[category] = [];
+            categories[category].push(pm);
           }
         }
-      } catch (err) {
-      }
-    }
-    const staticMethods = [
-      {
-        paymentMethod: "bca_va",
-        code: "bca_va",
-        paymentName: "BCA Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/bca.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "mandiri_va",
-        code: "mandiri_va",
-        paymentName: "Mandiri Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/mandiri.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "bni_va",
-        code: "bni_va",
-        paymentName: "BNI Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/bni.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "bri_va",
-        code: "bri_va",
-        paymentName: "BRI Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/bri.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "cimb_va",
-        code: "cimb_va",
-        paymentName: "CIMB Niaga Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/cimb.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "permata_va",
-        code: "permata_va",
-        paymentName: "Permata Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/permata.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "danamon_va",
-        code: "danamon_va",
-        paymentName: "Danamon Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/danamon.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "bsi_va",
-        code: "bsi_va",
-        paymentName: "BSI Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/bsi.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "bag_va",
-        code: "bag_va",
-        paymentName: "Bank Artha Graha Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/bag.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "muamalat_va",
-        code: "muamalat_va",
-        paymentName: "Bank Muamalat Virtual Account",
-        paymentImage: "https://my.ipaymu.com/images/banks/bmi.png",
-        totalFee: "IDR 3,500",
-        category: "Virtual Account"
-      },
-      {
-        paymentMethod: "qris",
-        code: "qris",
-        paymentName: "QRIS (GoPay, ShopeePay, DANA, OVO, LinkAja)",
-        paymentImage: "https://my.ipaymu.com/images/banks/qris.png",
-        totalFee: "0.7%",
-        category: "QRIS"
-      },
-      {
-        paymentMethod: "alfamart",
-        code: "alfamart",
-        paymentName: "Alfamart",
-        paymentImage: "https://my.ipaymu.com/images/banks/alfamart.png",
-        totalFee: "IDR 5,000",
-        category: "Retail / Gerai"
-      },
-      {
-        paymentMethod: "indomaret",
-        code: "indomaret",
-        paymentName: "Indomaret",
-        paymentImage: "https://my.ipaymu.com/images/banks/indomaret.png",
-        totalFee: "IDR 5,000",
-        category: "Retail / Gerai"
-      },
-      {
-        paymentMethod: "credit_card",
-        code: "credit_card",
-        paymentName: "Credit / Debit Card (Visa, Mastercard)",
-        paymentImage: "https://my.ipaymu.com/images/banks/cc.png",
-        totalFee: "2.9% + IDR 2,000",
-        category: "Kartu Kredit"
-      },
-      {
-        paymentMethod: "akulaku",
-        code: "akulaku",
-        paymentName: "Akulaku Paylater",
-        paymentImage: "https://my.ipaymu.com/images/banks/akulaku.png",
-        totalFee: "1.7%",
-        category: "Paylater / Cicilan"
-      }
-    ];
-    const categories = {};
-    for (const item of staticMethods) {
-      if (!categories[item.category]) {
-        categories[item.category] = [];
+        return {
+          success: true,
+          provider: "ipaymu",
+          methods,
+          categories,
+          rawResponse: data
+        };
       }
-      categories[item.category].push(item);
+      return {
+        success: false,
+        provider: "ipaymu",
+        methods: [],
+        categories: {},
+        error: data?.Message || data?.message || `Failed to fetch payment channels (HTTP ${response.status})`,
+        rawResponse: data
+      };
+    } catch (err) {
+      return {
+        success: false,
+        provider: "ipaymu",
+        methods: [],
+        categories: {},
+        error: err.message || "Failed to fetch iPaymu payment channels",
+        rawResponse: null
+      };
     }
-    return {
-      success: true,
-      provider: "ipaymu",
-      methods: staticMethods,
-      categories,
-      rawResponse: staticMethods
-    };
   }
   async checkTransaction(params, config) {
     const { merchantOrderId } = params;
@@ -8376,13 +8285,19 @@ var IpaymuClient = class {
     return this.request("POST", "/transaction", { transactionId });
   }
   /**
-   * Ambil daftar channel pembayaran aktif milik merchant
+   * Ambil daftar channel pembayaran aktif milik merchant (Official v2: GET /payment-channels)
    */
   async getPaymentMethods() {
-    return this.request("POST", "/payment-method-list", { account: this.va });
+    return this.request("GET", "/payment-channels");
+  }
+  /**
+   * Alias untuk getPaymentMethods (Official v2)
+   */
+  async getPaymentChannels() {
+    return this.request("GET", "/payment-channels");
   }
   /**
-   * Ambil riwayat transaksi merchant berpaginasi
+   * Ambil riwayat transaksi merchant berpaginasi (Official v2: POST /history)
    */
   async getHistory(params) {
     const payload = {
@@ -8394,42 +8309,111 @@ var IpaymuClient = class {
     return this.request("POST", "/history", payload);
   }
   /**
-   * Ambil daftar seluruh bank di Indonesia
+   * Ambil daftar seluruh bank di Indonesia (Official v2: POST /banklist)
    */
   async getBankList() {
     return this.request("POST", "/banklist", { account: this.va });
   }
   /**
-   * Ambil jangkauan area pengiriman COD
+   * Cari jangkauan area pengiriman COD (Official v2: GET /cod/area?area=keyword)
    */
-  async getCodArea(postalCode) {
-    const payload = { account: this.va };
-    if (postalCode) payload.postalCode = postalCode;
-    return this.request("POST", "/cod/getarea", payload);
+  async getCodArea(area) {
+    const query = { area };
+    return this.request("GET", `/cod/area?area=${encodeURIComponent(area)}`, query);
   }
   /**
-   * Hitung tarif ongkir pengiriman COD
+   * Hitung tarif ongkir pengiriman COD (Official v2: POST /cod/shipping-calculate)
    */
   async getCodRate(params) {
-    return this.request("POST", "/cod/getrate", { account: this.va, ...params });
+    const { pickupArea, deliveryArea, ...rest } = params;
+    const pickupId = params.pickup_area_id !== void 0 ? params.pickup_area_id : pickupArea;
+    const destId = params.destination_area_id !== void 0 ? params.destination_area_id : deliveryArea;
+    const payload = {
+      ...rest,
+      pickup_area_id: pickupId !== void 0 ? String(pickupId) : void 0,
+      destination_area_id: destId !== void 0 ? String(destId) : void 0,
+      amount: params.amount || 0
+    };
+    return this.request("POST", "/cod/shipping-calculate", payload);
   }
   /**
-   * Request pickup kurir COD
+   * Request pickup kurir COD (Official v2: POST /cod/pickup)
    */
   async getCodPickup(params) {
-    return this.request("POST", "/cod/pickup", { account: this.va, ...params });
+    const { transactionId, ...rest } = params;
+    const payload = {
+      ...rest,
+      transaction_id: params.transaction_id || transactionId
+    };
+    return this.request("POST", "/cod/pickup", payload);
   }
   /**
-   * Ambil nomor resi / AWB pengiriman COD
+   * Unduh label pengiriman / AWB COD (Official v2: GET /cod/download-label/:transaction_id)
    */
   async getCodAwb(transactionId) {
-    return this.request("POST", "/cod/getawb", { account: this.va, transactionId });
+    return this.request("GET", `/cod/download-label/${transactionId}`);
+  }
+  /**
+   * Lacak status pengiriman kurir COD berdasarkan no resi / AWB (Official v2: POST /cod/tracking)
+   */
+  async getCodTracking(params) {
+    const payload = typeof params === "string" ? { awb: params } : {
+      awb: params.awb,
+      transaction_id: params.transaction_id || params.transactionId
+    };
+    return this.request("POST", "/cod/tracking", payload);
+  }
+  // ==========================================
+  // Public Area Lookup API (docs.ipaymu.com/en/docs/area-api)
+  // Read-only endpoint untuk provinsi, kota/kabupaten, kecamatan, dan kelurahan
+  // ==========================================
+  /**
+   * Ambil daftar seluruh provinsi di Indonesia
+   */
+  async getAreasProvince() {
+    const res = await fetch("https://my.ipaymu.com/api/areas/province");
+    return res.json();
+  }
+  /**
+   * Ambil daftar kota / kabupaten berdasarkan ID provinsi
+   */
+  async getAreasCity(provinceId) {
+    const res = await fetch(`https://my.ipaymu.com/api/areas/city/${provinceId}`);
+    return res.json();
+  }
+  /**
+   * Ambil daftar kecamatan berdasarkan ID kota / kabupaten
+   */
+  async getAreasDistrict(cityId) {
+    const res = await fetch(`https://my.ipaymu.com/api/areas/district/${cityId}`);
+    return res.json();
   }
   /**
-   * Lacak status pengiriman kurir berdasarkan no resi / AWB
+   * Ambil daftar kelurahan berdasarkan ID kecamatan
+   */
+  async getAreasVillage(districtId) {
+    const res = await fetch(`https://my.ipaymu.com/api/areas/village/${districtId}`);
+    return res.json();
+  }
+  // ==========================================
+  // Split Payment — Single Register API
+  // https://ipaymu.com/en/split-payment/
+  // ==========================================
+  /**
+   * Daftarkan agen / reseller / mitra baru untuk Split Payment (Single Register API: POST /api/v2/register)
+   * Mengembalikan VA child account yang siap digunakan untuk parameter `subAccountId` saat membuat transaksi.
    */
-  async getCodTracking(awb) {
-    return this.request("POST", "/cod/tracking", { account: this.va, awb });
+  async registerUser(params) {
+    const { name, email, phone, password, ...rest } = params;
+    const payload = {
+      ...rest,
+      account: this.va,
+      name,
+      email,
+      phone,
+      password: password || "Password123!"
+    };
+    return this.request("POST", "/register", payload);
   }
 };