@crediblemark/buayar 0.8.0 → 0.8.1

package/dist/index.mjs

@@ -1551,8 +1551,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 };
@@ -1587,6 +1587,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 = {
@@ -1603,6 +1604,7 @@ var IpaymuProvider = class extends BasePaymentProvider {
         ...ipaymuMethod.paymentChannel ? { paymentChannel: ipaymuMethod.paymentChannel } : {},
         ...feeDirection ? { feeDirection } : {},
         ...escrow !== void 0 ? { escrow } : {},
+        ...subAccount ? { account: subAccount } : {},
         ...params.providerParams
       };
     } else {
@@ -1625,6 +1627,7 @@ var IpaymuProvider = class extends BasePaymentProvider {
         buyerPhone: customer.phone || "081234567890",
         ...feeDirection ? { feeDirection } : {},
         ...escrow !== void 0 ? { escrow } : {},
+        ...subAccount ? { account: subAccount } : {},
         ...params.providerParams
       };
     }
@@ -1727,221 +1730,106 @@ 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 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()}`;
               }
-              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;
@@ -8212,13 +8100,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");
   }
   /**
-   * Ambil riwayat transaksi merchant berpaginasi
+   * Alias untuk getPaymentMethods (Official v2)
+   */
+  async getPaymentChannels() {
+    return this.request("GET", "/payment-channels");
+  }
+  /**
+   * Ambil riwayat transaksi merchant berpaginasi (Official v2: POST /history)
    */
   async getHistory(params) {
     const payload = {
@@ -8230,42 +8124,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();
   }
   /**
-   * Lacak status pengiriman kurir berdasarkan no resi / AWB
+   * Ambil daftar kota / kabupaten berdasarkan ID provinsi
    */
-  async getCodTracking(awb) {
-    return this.request("POST", "/cod/tracking", { account: this.va, awb });
+  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();
+  }
+  /**
+   * 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 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);
   }
 };
 

package/docs/guide.md

@@ -373,25 +373,25 @@ Rangkuman kemampuan ekstra tiap provider:
 
 | Provider | Status | Getter | Kemampuan ekstra |
 | :--- | :---: | :--- | :--- |
-| Midtrans | Tested | `getMidtransClient()` | cancel/refund/expire/approve/deny/capture, GoPay tokenization, Subscription, Payment Link, IRIS balance |
-| Duitku | Tested | `getDuitkuClient()` | balance, listBanks, inquiryBankAccount, disburse, checkDisbursementStatus |
-| iPaymu | Tested | `getIpaymuClient()` | balance, checkTransaction, getHistory, getBankList, getPaymentMethods, COD logistics (getArea, getRate, getPickup, getAwb, getTracking) |
-| Xendit | Tested | `getXenditClient()` | balance, expireInvoice, createDisbursement |
-| DOKU | Tested | `getDokuClient()` | checkTransaction |
-| PrismaLink | Tested | `getPrismalinkClient()` | checkTransaction |
-| Faspay | Tested | `getFaspayClient()` | cancelTransaction, checkTransaction |
-| Finpay | Tested | `getFinpayClient()` | checkTransaction |
-| Nicepay | Tested | `getNicepayClient()` | cancelTransaction, checkTransaction |
-| OY! Bisnis | Tested | `getOyClient()` | checkTransaction, balance, remit (transfer dana) |
-| Stripe | Tested | `getStripeClient()` | balance, createRefund, retrieveCheckoutSession, retrievePaymentIntent |
-| PayPal | Tested | `getPaypalClient()` | captureOrder, getOrder, refundCapture, checkBalance, verifyWebhookSignature |
-| Adyen | Tested | `getAdyenClient()` | capturePayment, cancelPayment, refundPayment, getPaymentDetails, getAvailablePaymentMethods |
-| Checkout.com | Tested | `getCheckoutComClient()` | balance, refundPayment, voidPayment, getPaymentDetails, listPaymentLinks |
-| Razorpay | Tested | `getRazorpayClient()` | capturePayment, createRefund, checkBalance, fetchPayment, listPayments |
-| Square | Tested | `getSquareClient()` | retrieveBalance, refundPayment, cancelPayment, getPayment, listLocations |
-| PayU | Tested | `getPayuClient()` | cancelOrder, getOrder, refundOrder |
-| Braintree | Tested | `getBraintreeClient()` | getClientToken, findTransaction, refundTransaction, voidTransaction |
-| 2Checkout | Tested | `getTwoCheckoutClient()` | getOrder, listOrders, getSubscription, refundOrder |
+| Midtrans | - | `getMidtransClient()` | cancel/refund/expire/approve/deny/capture, GoPay tokenization, Subscription, Payment Link, IRIS balance |
+| Duitku | - | `getDuitkuClient()` | balance, listBanks, inquiryBankAccount, disburse, checkDisbursementStatus |
+| [iPaymu](ipaymu.md) | Tested | `getIpaymuClient()` | balance, checkTransaction, getHistory, getBankList, getPaymentMethods/getPaymentChannels, Split Payment (registerUser / subAccountId), COD logistics (getArea, getRate, getPickup, getAwb, getTracking), Public Area API (Province, City, District, Village). *Lihat [panduan lengkap iPaymu](ipaymu.md)* |
+| Xendit | - | `getXenditClient()` | balance, expireInvoice, createDisbursement |
+| DOKU | - | `getDokuClient()` | checkTransaction |
+| PrismaLink | - | `getPrismalinkClient()` | checkTransaction |
+| Faspay | - | `getFaspayClient()` | cancelTransaction, checkTransaction |
+| Finpay | - | `getFinpayClient()` | checkTransaction |
+| Nicepay | - | `getNicepayClient()` | cancelTransaction, checkTransaction |
+| OY! Bisnis | - | `getOyClient()` | checkTransaction, balance, remit (transfer dana) |
+| Stripe | - | `getStripeClient()` | balance, createRefund, retrieveCheckoutSession, retrievePaymentIntent |
+| PayPal | - | `getPaypalClient()` | captureOrder, getOrder, refundCapture, checkBalance, verifyWebhookSignature |
+| Adyen | - | `getAdyenClient()` | capturePayment, cancelPayment, refundPayment, getPaymentDetails, getAvailablePaymentMethods |
+| Checkout.com | - | `getCheckoutComClient()` | balance, refundPayment, voidPayment, getPaymentDetails, listPaymentLinks |
+| Razorpay | - | `getRazorpayClient()` | capturePayment, createRefund, checkBalance, fetchPayment, listPayments |
+| Square | - | `getSquareClient()` | retrieveBalance, refundPayment, cancelPayment, getPayment, listLocations |
+| PayU | - | `getPayuClient()` | cancelOrder, getOrder, refundOrder |
+| Braintree | - | `getBraintreeClient()` | getClientToken, findTransaction, refundTransaction, voidTransaction |
+| 2Checkout | - | `getTwoCheckoutClient()` | getOrder, listOrders, getSubscription, refundOrder |
 
 ---