npm - @crediblemark/buayar - Versions diffs - 0.7.0 → 0.8.0 - Mend

@crediblemark/buayar 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -30,32 +30,32 @@
 #### 🇮🇩 Indonesian (10)
-| Provider | Redirect | Direct API | Webhook | Client |
-|---|:---:|:---:|:---:|:---:|
-| Midtrans | ✅ Snap | ✅ Core API | SHA-512 | `MidtransClient` |
-| Duitku | ✅ | ✅ | MD5 | `DuitkuClient` |
-| iPaymu | ✅ | ✅ | HMAC-SHA256 | `IpaymuClient` |
-| Xendit | ✅ Invoice v2 | ✅ Payments v3 | Token | `XenditClient` |
-| DOKU Jokul | ✅ v1 | ✅ v2 | HMAC-SHA256 | `DokuClient` |
-| PrismaLink | ✅ | ✅ | SHA-256 | `PrismalinkClient` |
-| Faspay | ✅ | ✅ | SHA1(MD5) | `FaspayClient` |
-| Finpay | ✅ | ✅ | HMAC-SHA512 | `FinpayClient` |
-| Nicepay | ✅ | ✅ | SHA-256 | `NicepayClient` |
-| OY! Bisnis | ✅ | ✅ | Header Auth | `OyClient` |
+| Provider | Status | Redirect | Direct API | Webhook | Client |
+|---|:---:|:---:|:---:|:---:|:---:|
+| Midtrans | Tested | ✅ Snap | ✅ Core API | SHA-512 | `MidtransClient` |
+| Duitku | Tested | ✅ | ✅ | MD5 | `DuitkuClient` |
+| iPaymu | Tested | ✅ | ✅ | HMAC-SHA256 | `IpaymuClient` |
+| Xendit | Tested | ✅ Invoice v2 | ✅ Payments v3 | Token | `XenditClient` |
+| DOKU Jokul | Tested | ✅ v1 | ✅ v2 | HMAC-SHA256 | `DokuClient` |
+| PrismaLink | Tested | ✅ | ✅ | SHA-256 | `PrismalinkClient` |
+| Faspay | Tested | ✅ | ✅ | SHA1(MD5) | `FaspayClient` |
+| Finpay | Tested | ✅ | ✅ | HMAC-SHA512 | `FinpayClient` |
+| Nicepay | Tested | ✅ | ✅ | SHA-256 | `NicepayClient` |
+| OY! Bisnis | Tested | ✅ | ✅ | Header Auth | `OyClient` |
 #### 🌍 International (9)
-| Provider | Redirect | Direct API | Webhook | Client |
-|---|:---:|:---:|:---:|:---:|
-| Stripe | ✅ Checkout Sessions | ✅ Payment Intents | HMAC-SHA256 | `StripeClient` |
-| PayPal | ✅ Orders v2 | ✅ Capture | OAuth2 | `PaypalClient` |
-| Adyen | ✅ Sessions v68 | ✅ Payments v68 | HMAC-SHA256 | `AdyenClient` |
-| Checkout.com | ✅ Payment Links | ✅ Payments API | HMAC-SHA256 | `CheckoutComClient` |
-| Razorpay | ✅ Payment Links | ✅ Orders API | HMAC-SHA256 | `RazorpayClient` |
-| Square | ✅ Payment Links | ✅ Payments API | HMAC-SHA256 | `SquareClient` |
-| PayU | ✅ Orders v2.1 | ✅ Pay Methods | MD5/SHA-256 | `PayuClient` |
-| Braintree | ✅ Drop-in UI Token | ✅ Transaction API | SHA1 HMAC | `BraintreeClient` |
-| 2Checkout | ✅ REST v6.0 | ✅ REST v6.0 | IPN MD5 | `TwoCheckoutClient` |
+| Provider | Status | Redirect | Direct API | Webhook | Client |
+|---|:---:|:---:|:---:|:---:|:---:|
+| Stripe | Tested | ✅ Checkout Sessions | ✅ Payment Intents | HMAC-SHA256 | `StripeClient` |
+| PayPal | Tested | ✅ Orders v2 | ✅ Capture | OAuth2 | `PaypalClient` |
+| Adyen | Tested | ✅ Sessions v68 | ✅ Payments v68 | HMAC-SHA256 | `AdyenClient` |
+| Checkout.com | Tested | ✅ Payment Links | ✅ Payments API | HMAC-SHA256 | `CheckoutComClient` |
+| Razorpay | Tested | ✅ Payment Links | ✅ Orders API | HMAC-SHA256 | `RazorpayClient` |
+| Square | Tested | ✅ Payment Links | ✅ Payments API | HMAC-SHA256 | `SquareClient` |
+| PayU | Tested | ✅ Orders v2.1 | ✅ Pay Methods | MD5/SHA-256 | `PayuClient` |
+| Braintree | Tested | ✅ Drop-in UI Token | ✅ Transaction API | SHA1 HMAC | `BraintreeClient` |
+| 2Checkout | Tested | ✅ REST v6.0 | ✅ REST v6.0 | IPN MD5 | `TwoCheckoutClient` |
 ### ⚙️ Environment Variables
@@ -93,30 +93,31 @@ buayar.supports("xendit", "checkBalance"); // true
 buayar.supportsMethod("qris", "stripe");   // true
 ```
-#### Provider-Specific Variables
-| Variable | Provider | Description |
-| :--- | :--- | :--- |
-| `MIDTRANS_SERVER_KEY` | Midtrans | Server Key |
-| `MIDTRANS_CLIENT_KEY` | Midtrans | Client Key (frontend) |
-| `DUITKU_API_KEY` / `DUITKU_MERCHANT_CODE` | Duitku | API Key & Merchant Code |
-| `IPAYMU_API_KEY` / `IPAYMU_VA` | iPaymu | API Key & VA number |
-| `XENDIT_SECRET_KEY` / `XENDIT_WEBHOOK_TOKEN` | Xendit | Secret Key & Webhook Token |
-| `DOKU_CLIENT_ID` / `DOKU_SECRET_KEY` | DOKU | Client ID & Secret Key |
-| `PRISMALINK_MERCHANT_ID` / `PRISMALINK_SECRET_KEY` | PrismaLink | Merchant ID & Secret Key |
-| `FASPAY_MERCHANT_ID` / `FASPAY_USER_ID` / `FASPAY_PASSWORD` | Faspay | Merchant ID, User ID & Password |
-| `FINPAY_MERCHANT_ID` / `FINPAY_MERCHANT_KEY` | Finpay | Merchant ID & Key |
-| `NICEPAY_IMID` / `NICEPAY_KEY` | Nicepay | iMid & Merchant Key |
-| `OY_USERNAME` / `OY_API_KEY` | OY! Bisnis | Username & API Key |
-| `STRIPE_SECRET_KEY` / `STRIPE_WEBHOOK_SECRET` / `STRIPE_PUBLIC_KEY` | Stripe | Secret, Webhook Secret, Publishable Key |
-| `PAYPAL_CLIENT_ID` / `PAYPAL_CLIENT_SECRET` / `PAYPAL_WEBHOOK_ID` | PayPal | OAuth2 Credentials & Webhook ID |
-| `ADYEN_API_KEY` / `ADYEN_MERCHANT_ACCOUNT` / `ADYEN_HMAC_KEY` | Adyen | API Key, Merchant Account & HMAC Key |
-| `CHECKOUTCOM_SECRET_KEY` / `CHECKOUTCOM_PUBLIC_KEY` / `CHECKOUTCOM_WEBHOOK_SECRET` | Checkout.com | Secret, Public Key & Webhook Secret |
-| `RAZORPAY_KEY_ID` / `RAZORPAY_KEY_SECRET` / `RAZORPAY_WEBHOOK_SECRET` | Razorpay | Key ID, Key Secret & Webhook Secret |
-| `SQUARE_ACCESS_TOKEN` / `SQUARE_APPLICATION_ID` / `SQUARE_LOCATION_ID` | Square | Access Token, App ID & Location ID |
-| `PAYU_POS_ID` / `PAYU_MD5_KEY` / `PAYU_OAUTH_CLIENT_ID` / `PAYU_OAUTH_CLIENT_SECRET` | PayU | POS ID, MD5 Key & OAuth2 Credentials |
-| `BRAINTREE_MERCHANT_ID` / `BRAINTREE_PUBLIC_KEY` / `BRAINTREE_PRIVATE_KEY` | Braintree | Merchant ID, Public & Private Key |
-| `TWOCHECKOUT_MERCHANT_CODE` / `TWOCHECKOUT_SECRET_KEY` / `TWOCHECKOUT_SECRET_WORD` | 2Checkout | Merchant Code, Secret Key & IPN Word |
+#### Universal Credential Mapping (`BUAYAR_*`)
+You don't need provider-specific variable names. Simply use unified **`BUAYAR_*`** variables:
+| Provider | `BUAYAR_PROVIDER` | `BUAYAR_API_KEY` | `BUAYAR_MERCHANT_CODE` | `BUAYAR_CLIENT_KEY` / Extra |
+| :--- | :--- | :--- | :--- | :--- |
+| **Midtrans** | `midtrans` | Server Key | *(optional)* | Client Key |
+| **Duitku** | `duitku` | API Key | Merchant Code | *(not needed)* |
+| **iPaymu** | `ipaymu` | API Key | Virtual Account (VA) | *(not needed)* |
+| **Xendit** | `xendit` | Secret Key | *(optional)* | Webhook Token (`BUAYAR_WEBHOOK_SECRET`) |
+| **DOKU Jokul** | `doku` | Secret Key | Client ID / Merchant ID | Client ID |
+| **PrismaLink** | `prismalink` | Secret Key | Merchant ID | *(not needed)* |
+| **Faspay** | `faspay` | Password | Merchant ID | User ID |
+| **Finpay** | `finpay` | Merchant Key | Merchant ID | *(not needed)* |
+| **Nicepay** | `nicepay` | Server Key | I-MID | *(not needed)* |
+| **OY! Bisnis** | `oy` | API Key | Username | Username |
+| **Stripe** | `stripe` | Secret Key | *(not needed)* | Publishable Key / Webhook Secret |
+| **PayPal** | `paypal` | Client Secret | Client ID | Client ID |
+| **Adyen** | `adyen` | API Key | Merchant Account | Client Key / HMAC Key |
+| **Checkout.com** | `checkoutcom` | Secret Key | *(not needed)* | Public Key / Webhook Secret |
+| **Razorpay** | `razorpay` | Key Secret | Key ID | Key ID |
+| **Square** | `square` | Access Token | App ID | Location ID (`BUAYAR_PROJECT_ID`) |
+| **PayU** | `payu` | MD5 Key | POS ID | POS ID |
+| **Braintree** | `braintree` | Private Key | Merchant ID | Public Key |
+| **2Checkout** | `twocheckout` | Secret Key | Merchant Code | Secret Word (`BUAYAR_WEBHOOK_SECRET`) |
 ### 📖 Usage
@@ -225,7 +226,7 @@ BUAYAR_WEBHOOK_SECRET=whsec_...
 * **Midtrans** — Snap API (Redirect/Popup) & Core API Direct Charge. Verifikasi SHA-512. `MidtransClient`.
 * **Duitku** — Redirect Checkout & Direct Inquiry API. Verifikasi MD5. `DuitkuClient` (Disbursement, Inquiry Rekening, Saldo).
-* **iPaymu** — Redirect & Direct Payment API v2. Verifikasi HMAC-SHA256. `IpaymuClient` (Cek Saldo, Cek Transaksi).
+* **iPaymu** `[Tested]` — Redirect & Direct Payment API v2. Verifikasi HMAC-SHA256. `IpaymuClient` (Cek Saldo, Cek Transaksi, Histori, Bank List, Dynamic Methods, COD).
 * **Xendit** — Invoice v2 & Payment Requests v3. Webhook Token. `XenditClient` (Saldo, Expire Invoice, Disbursement).
 * **DOKU Jokul** — Checkout v1 & Direct API v2. HMAC-SHA256 + Digest. `DokuClient`.
 * **PrismaLink** — Checkout Page & Direct API. SHA-256. `PrismalinkClient`.
@@ -266,33 +267,31 @@ BUAYAR_CALLBACK_URL=https://myapp.com/api/payment/webhook
 BUAYAR_RETURN_URL=https://myapp.com/payment/finish
 ```
-#### Kamus Variabel Lengkap Spesifik Provider
-| Variabel `.env` | Provider | Keterangan |
-| :--- | :--- | :--- |
-| `MIDTRANS_SERVER_KEY` / `MIDTRANS_CLIENT_KEY` | Midtrans | Server Key & Client Key |
-| `DUITKU_API_KEY` / `DUITKU_MERCHANT_CODE` | Duitku | API Key & Merchant Code |
-| `IPAYMU_API_KEY` / `IPAYMU_VA` | iPaymu | API Key & Nomor VA Merchant |
-| `XENDIT_SECRET_KEY` / `XENDIT_WEBHOOK_TOKEN` | Xendit | Secret Key & Webhook Token |
-| `DOKU_CLIENT_ID` / `DOKU_SECRET_KEY` | DOKU | Client ID & Secret Key |
-| `PRISMALINK_MERCHANT_ID` / `PRISMALINK_SECRET_KEY` | PrismaLink | Merchant ID & Secret Key |
-| `FASPAY_MERCHANT_ID` / `FASPAY_USER_ID` / `FASPAY_PASSWORD` | Faspay | Merchant ID, User ID & Password |
-| `FASPAY_MERCHANT_NAME` | Faspay | Nama display merchant di halaman Faspay |
-| `FINPAY_MERCHANT_ID` / `FINPAY_MERCHANT_KEY` | Finpay | Merchant ID & Merchant Key |
-| `NICEPAY_IMID` / `NICEPAY_KEY` | Nicepay | iMid & Merchant Key |
-| `OY_USERNAME` / `OY_API_KEY` | OY! Bisnis | Username & API Key |
-| `STRIPE_SECRET_KEY` / `STRIPE_WEBHOOK_SECRET` / `STRIPE_PUBLIC_KEY` | Stripe | Secret Key, Webhook Secret & Publishable Key |
-| `PAYPAL_CLIENT_ID` / `PAYPAL_CLIENT_SECRET` / `PAYPAL_WEBHOOK_ID` | PayPal | Client ID, Client Secret & Webhook ID |
-| `ADYEN_API_KEY` / `ADYEN_MERCHANT_ACCOUNT` / `ADYEN_HMAC_KEY` | Adyen | API Key, Merchant Account & HMAC Key |
-| `ADYEN_CLIENT_KEY` / `ADYEN_LIVE_URL_PREFIX` | Adyen | Client Key (frontend) & Live URL prefix (production) |
-| `CHECKOUTCOM_SECRET_KEY` / `CHECKOUTCOM_PUBLIC_KEY` / `CHECKOUTCOM_WEBHOOK_SECRET` | Checkout.com | Secret Key, Public Key & Webhook Secret |
-| `RAZORPAY_KEY_ID` / `RAZORPAY_KEY_SECRET` / `RAZORPAY_WEBHOOK_SECRET` | Razorpay | Key ID, Key Secret & Webhook Secret |
-| `SQUARE_ACCESS_TOKEN` / `SQUARE_APPLICATION_ID` / `SQUARE_LOCATION_ID` | Square | Access Token, App ID & Location ID |
-| `SQUARE_WEBHOOK_SIGNATURE_KEY` | Square | Signature Key untuk verifikasi webhook |
-| `PAYU_POS_ID` / `PAYU_MD5_KEY` | PayU | POS ID (Merchant ID) & MD5 Key untuk webhook |
-| `PAYU_OAUTH_CLIENT_ID` / `PAYU_OAUTH_CLIENT_SECRET` | PayU | OAuth2 Client ID & Secret untuk Bearer Token |
-| `BRAINTREE_MERCHANT_ID` / `BRAINTREE_PUBLIC_KEY` / `BRAINTREE_PRIVATE_KEY` | Braintree | Merchant ID, Public Key & Private Key |
-| `TWOCHECKOUT_MERCHANT_CODE` / `TWOCHECKOUT_SECRET_KEY` / `TWOCHECKOUT_SECRET_WORD` | 2Checkout | Merchant Code, Secret Key & Secret Word (IPN) |
+#### Pemetaan Kredensial ke Variabel Universal `BUAYAR_*`
+Anda **tidak perlu** membuat nama variabel khusus per provider. Cukup gunakan set variabel seragam **`BUAYAR_*`**. Tabel berikut menunjukkan data apa dari dashboard masing-masing payment gateway yang perlu Anda masukkan ke variabel `BUAYAR_*`:
+| Provider | `BUAYAR_PROVIDER` | `BUAYAR_API_KEY` | `BUAYAR_MERCHANT_CODE` | `BUAYAR_CLIENT_KEY` / Tambahan |
+| :--- | :--- | :--- | :--- | :--- |
+| **Midtrans** | `midtrans` | Server Key | *(opsional)* | Client Key |
+| **Duitku** | `duitku` | API Key | Merchant Code | *(tidak perlu)* |
+| **iPaymu** | `ipaymu` | API Key | Nomor Virtual Account (VA) | *(tidak perlu)* |
+| **Xendit** | `xendit` | Secret Key | *(opsional)* | Webhook Token (`BUAYAR_WEBHOOK_SECRET`) |
+| **DOKU Jokul** | `doku` | Secret Key | Client ID / Merchant ID | Client ID |
+| **PrismaLink** | `prismalink` | Secret Key | Merchant ID | *(tidak perlu)* |
+| **Faspay** | `faspay` | Password | Merchant ID | User ID |
+| **Finpay** | `finpay` | Merchant Key | Merchant ID | *(tidak perlu)* |
+| **Nicepay** | `nicepay` | Server Key | I-MID | *(tidak perlu)* |
+| **OY! Bisnis** | `oy` | API Key | Username | Username |
+| **Stripe** | `stripe` | Secret Key | *(tidak perlu)* | Publishable Key / Webhook Secret |
+| **PayPal** | `paypal` | Client Secret | Client ID | Client ID |
+| **Adyen** | `adyen` | API Key | Merchant Account | Client Key / HMAC Key |
+| **Checkout.com** | `checkoutcom` | Secret Key | *(tidak perlu)* | Public Key / Webhook Secret |
+| **Razorpay** | `razorpay` | Key Secret | Key ID | Key ID |
+| **Square** | `square` | Access Token | App ID | Location ID (`BUAYAR_PROJECT_ID`) |
+| **PayU** | `payu` | MD5 Key | POS ID | POS ID |
+| **Braintree** | `braintree` | Private Key | Merchant ID | Public Key |
+| **2Checkout** | `twocheckout` | Secret Key | Merchant Code | Secret Word (`BUAYAR_WEBHOOK_SECRET`) |
 ### 📖 Panduan Penggunaan

package/dist/cli/index.js CHANGED Viewed

@@ -484,7 +484,7 @@ function printScaffoldSummary(result) {
 }
 // src/cli/index.ts
-var VERSION = "0.7.0";
+var VERSION = "0.8.0";
 function parseArgs(argv) {
   const flags = [];
   const rest = [];

package/dist/index.d.mts CHANGED Viewed

@@ -1,4 +1,4 @@
-type CanonicalPaymentMethod = "bca_va" | "mandiri_va" | "bni_va" | "bri_va" | "permata_va" | "cimb_va" | "danamon_va" | "bsi_va" | "seabank_va" | "muamalat_va" | "artajasa_va" | "qris" | "gopay_qris" | "shopeepay_qris" | "nobu_qris" | "gopay" | "shopeepay" | "ovo" | "dana" | "linkaja" | "jenius" | "alfamart" | "indomaret" | "pos" | "credit_card" | "kredivo" | "akulaku" | "indodana" | string;
+type CanonicalPaymentMethod = "bca_va" | "mandiri_va" | "bni_va" | "bri_va" | "permata_va" | "cimb_va" | "danamon_va" | "bsi_va" | "seabank_va" | "muamalat_va" | "bag_va" | "artajasa_va" | "qris" | "gopay_qris" | "shopeepay_qris" | "nobu_qris" | "gopay" | "shopeepay" | "ovo" | "dana" | "linkaja" | "jenius" | "alfamart" | "indomaret" | "pos" | "credit_card" | "kredivo" | "akulaku" | "indodana" | string;
 interface CustomerDetails {
     name: string;
@@ -24,8 +24,34 @@ interface CreateInvoiceParams {
      * Contoh: 'idr', 'usd', 'sgd'
      */
     currency?: string;
+    /**
+     * Pilihan pembebanan biaya transaksi (didukung iPaymu dll).
+     * 'MERCHANT' = biaya transaksi dipotong dari omset merchant (default).
+     * 'BUYER' = biaya transaksi ditambahkan ke total tagihan pembeli.
+     */
+    feeDirection?: "MERCHANT" | "BUYER";
+    /**
+     * Mengaktifkan sistem Escrow (Rekening Bersama) jika didukung provider.
+     */
+    escrow?: boolean;
+    /**
+     * Rincian item produk (opsional, untuk multi-item cart / logistik).
+     */
+    items?: Array<{
+        id?: string;
+        name: string;
+        price: number;
+        quantity: number;
+        description?: string;
+        weight?: number;
+        length?: number;
+        width?: number;
+        height?: number;
+    }>;
     /** Parameter kustom tambahan untuk provider spesifik (opsional) */
     providerParams?: any;
+    /** Konfigurasi atau data kustom tambahan untuk provider (opsional) */
+    extra?: Record<string, any>;
 }
 interface MandiriBillInfo {
     billerCode?: string;
@@ -159,15 +185,16 @@ interface PaymentMethodItem {
     /** Status ketersediaan channel */
     isOnline: boolean;
     /** Kategori grup untuk Accordion UI */
-    category: "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" | string;
 }
 interface PaymentMethod {
     paymentMethod: string;
     paymentName: string;
     paymentImage: string;
     totalFee: string;
-    category: "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" | string;
     code?: string;
+    extra?: any;
     feeDetail?: {
         flat: number;
         percent: number;
@@ -628,7 +655,55 @@ declare class IpaymuClient {
     /**
      * Cek detail transaksi iPaymu
      */
-    checkTransaction(transactionId: string): Promise<any>;
+    checkTransaction(transactionId: string | number): Promise<any>;
+    /**
+     * Ambil daftar channel pembayaran aktif milik merchant
+     */
+    getPaymentMethods(): Promise<any>;
+    /**
+     * Ambil riwayat transaksi merchant berpaginasi
+     */
+    getHistory(params?: {
+        page?: number;
+        limit?: number;
+        status?: number;
+        date?: string;
+        start_date?: string;
+        end_date?: string;
+        bulkId?: string[];
+    }): Promise<any>;
+    /**
+     * Ambil daftar seluruh bank di Indonesia
+     */
+    getBankList(): Promise<any>;
+    /**
+     * Ambil jangkauan area pengiriman COD
+     */
+    getCodArea(postalCode?: string): Promise<any>;
+    /**
+     * Hitung tarif ongkir pengiriman COD
+     */
+    getCodRate(params: {
+        pickupArea: string;
+        deliveryArea: string;
+        weight: number;
+        height?: number;
+        length?: number;
+        width?: number;
+        [key: string]: any;
+    }): Promise<any>;
+    /**
+     * Request pickup kurir COD
+     */
+    getCodPickup(params: any): Promise<any>;
+    /**
+     * Ambil nomor resi / AWB pengiriman COD
+     */
+    getCodAwb(transactionId: string | number): Promise<any>;
+    /**
+     * Lacak status pengiriman kurir berdasarkan no resi / AWB
+     */
+    getCodTracking(awb: string): Promise<any>;
 }
 interface XenditDisbursementParams {

package/dist/index.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-type CanonicalPaymentMethod = "bca_va" | "mandiri_va" | "bni_va" | "bri_va" | "permata_va" | "cimb_va" | "danamon_va" | "bsi_va" | "seabank_va" | "muamalat_va" | "artajasa_va" | "qris" | "gopay_qris" | "shopeepay_qris" | "nobu_qris" | "gopay" | "shopeepay" | "ovo" | "dana" | "linkaja" | "jenius" | "alfamart" | "indomaret" | "pos" | "credit_card" | "kredivo" | "akulaku" | "indodana" | string;
+type CanonicalPaymentMethod = "bca_va" | "mandiri_va" | "bni_va" | "bri_va" | "permata_va" | "cimb_va" | "danamon_va" | "bsi_va" | "seabank_va" | "muamalat_va" | "bag_va" | "artajasa_va" | "qris" | "gopay_qris" | "shopeepay_qris" | "nobu_qris" | "gopay" | "shopeepay" | "ovo" | "dana" | "linkaja" | "jenius" | "alfamart" | "indomaret" | "pos" | "credit_card" | "kredivo" | "akulaku" | "indodana" | string;
 interface CustomerDetails {
     name: string;
@@ -24,8 +24,34 @@ interface CreateInvoiceParams {
      * Contoh: 'idr', 'usd', 'sgd'
      */
     currency?: string;
+    /**
+     * Pilihan pembebanan biaya transaksi (didukung iPaymu dll).
+     * 'MERCHANT' = biaya transaksi dipotong dari omset merchant (default).
+     * 'BUYER' = biaya transaksi ditambahkan ke total tagihan pembeli.
+     */
+    feeDirection?: "MERCHANT" | "BUYER";
+    /**
+     * Mengaktifkan sistem Escrow (Rekening Bersama) jika didukung provider.
+     */
+    escrow?: boolean;
+    /**
+     * Rincian item produk (opsional, untuk multi-item cart / logistik).
+     */
+    items?: Array<{
+        id?: string;
+        name: string;
+        price: number;
+        quantity: number;
+        description?: string;
+        weight?: number;
+        length?: number;
+        width?: number;
+        height?: number;
+    }>;
     /** Parameter kustom tambahan untuk provider spesifik (opsional) */
     providerParams?: any;
+    /** Konfigurasi atau data kustom tambahan untuk provider (opsional) */
+    extra?: Record<string, any>;
 }
 interface MandiriBillInfo {
     billerCode?: string;
@@ -159,15 +185,16 @@ interface PaymentMethodItem {
     /** Status ketersediaan channel */
     isOnline: boolean;
     /** Kategori grup untuk Accordion UI */
-    category: "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" | string;
 }
 interface PaymentMethod {
     paymentMethod: string;
     paymentName: string;
     paymentImage: string;
     totalFee: string;
-    category: "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" | string;
     code?: string;
+    extra?: any;
     feeDetail?: {
         flat: number;
         percent: number;
@@ -628,7 +655,55 @@ declare class IpaymuClient {
     /**
      * Cek detail transaksi iPaymu
      */
-    checkTransaction(transactionId: string): Promise<any>;
+    checkTransaction(transactionId: string | number): Promise<any>;
+    /**
+     * Ambil daftar channel pembayaran aktif milik merchant
+     */
+    getPaymentMethods(): Promise<any>;
+    /**
+     * Ambil riwayat transaksi merchant berpaginasi
+     */
+    getHistory(params?: {
+        page?: number;
+        limit?: number;
+        status?: number;
+        date?: string;
+        start_date?: string;
+        end_date?: string;
+        bulkId?: string[];
+    }): Promise<any>;
+    /**
+     * Ambil daftar seluruh bank di Indonesia
+     */
+    getBankList(): Promise<any>;
+    /**
+     * Ambil jangkauan area pengiriman COD
+     */
+    getCodArea(postalCode?: string): Promise<any>;
+    /**
+     * Hitung tarif ongkir pengiriman COD
+     */
+    getCodRate(params: {
+        pickupArea: string;
+        deliveryArea: string;
+        weight: number;
+        height?: number;
+        length?: number;
+        width?: number;
+        [key: string]: any;
+    }): Promise<any>;
+    /**
+     * Request pickup kurir COD
+     */
+    getCodPickup(params: any): Promise<any>;
+    /**
+     * Ambil nomor resi / AWB pengiriman COD
+     */
+    getCodAwb(transactionId: string | number): Promise<any>;
+    /**
+     * Lacak status pengiriman kurir berdasarkan no resi / AWB
+     */
+    getCodTracking(awb: string): Promise<any>;
 }
 interface XenditDisbursementParams {

package/dist/index.js CHANGED Viewed

@@ -287,6 +287,9 @@ var CANONICAL_TO_IPAYMU = {
   permata_va: { paymentMethod: "va", paymentChannel: "permata" },
   danamon_va: { paymentMethod: "va", paymentChannel: "danamon" },
   bsi_va: { paymentMethod: "va", paymentChannel: "bsi" },
+  bag_va: { paymentMethod: "va", paymentChannel: "bag" },
+  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" },
@@ -1744,35 +1747,48 @@ var IpaymuProvider = class extends BasePaymentProvider {
     const baseUrl = this.getBaseUrl(sandbox);
     const endpoint = isDirect ? "/payment/direct" : "/payment";
     const url = `${baseUrl}${endpoint}`;
+    const notifyUrl = callbackUrl || config.callbackUrl || "https://localhost/callback";
+    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;
     let payload;
     if (isDirect) {
       payload = {
         name: customer.name,
         email: customer.email,
-        phone: customer.phone || "",
+        phone: customer.phone || "081234567890",
         amount: integerAmount,
-        notifyUrl: callbackUrl || config.callbackUrl || "",
+        notifyUrl,
         expired: 24,
         expiredType: "hours",
         comments: productDetails,
         referenceId: orderId,
         paymentMethod: ipaymuMethod.paymentMethod,
         ...ipaymuMethod.paymentChannel ? { paymentChannel: ipaymuMethod.paymentChannel } : {},
+        ...feeDirection ? { feeDirection } : {},
+        ...escrow !== void 0 ? { escrow } : {},
         ...params.providerParams
       };
     } else {
+      const hasItems = params.items && params.items.length > 0;
+      const product = hasItems ? params.items.map((i) => i.name) : [productDetails.length > 50 ? productDetails.substring(0, 47) + "..." : productDetails];
+      const qty = hasItems ? params.items.map((i) => i.quantity) : [1];
+      const price = hasItems ? params.items.map((i) => Math.round(i.price)) : [integerAmount];
+      const description = hasItems ? params.items.map((i) => i.description || i.name) : [productDetails];
       payload = {
-        product: [productDetails.length > 50 ? productDetails.substring(0, 47) + "..." : productDetails],
-        qty: [1],
-        price: [integerAmount],
-        description: [productDetails],
-        returnUrl: returnUrl || config.returnUrl || "",
-        notifyUrl: callbackUrl || config.callbackUrl || "",
-        cancelUrl: returnUrl || config.returnUrl || "",
+        product,
+        qty,
+        price,
+        description,
+        returnUrl: redirectUrl,
+        notifyUrl,
+        cancelUrl: redirectUrl,
         referenceId: orderId,
         buyerName: customer.name,
         buyerEmail: customer.email,
-        buyerPhone: customer.phone || "",
+        buyerPhone: customer.phone || "081234567890",
+        ...feeDirection ? { feeDirection } : {},
+        ...escrow !== void 0 ? { escrow } : {},
         ...params.providerParams
       };
     }
@@ -1812,8 +1828,8 @@ var IpaymuProvider = class extends BasePaymentProvider {
           provider: "ipaymu",
           orderId,
           amount: integerAmount,
-          reference: resData.TransactionId ? String(resData.TransactionId) : String(resData.SessionId || ""),
-          paymentUrl: resData.Url,
+          reference: resData.TransactionId ? String(resData.TransactionId) : String(resData.SessionId || resData.SessionID || ""),
+          paymentUrl: resData.Url || resData.url,
           rawResponse: data
         };
         if (resData.PaymentNo) {
@@ -1872,6 +1888,88 @@ var IpaymuProvider = class extends BasePaymentProvider {
     };
   }
   async getPaymentMethods(params, config) {
+    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()}`;
+                }
+              }
+              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
+            };
+          }
+        }
+      } catch (err) {
+      }
+    }
     const staticMethods = [
       {
         paymentMethod: "bca_va",
@@ -1937,6 +2035,22 @@ var IpaymuProvider = class extends BasePaymentProvider {
         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",
@@ -2038,11 +2152,14 @@ var IpaymuProvider = class extends BasePaymentProvider {
         };
       }
       const txData = data.Data || {};
-      const statusText = (txData.Status || txData.status || "").toString().toLowerCase();
-      const isPaid = statusText === "berhasil" || statusText === "success" || txData.StatusCode === 1;
-      const isPending = statusText === "pending" || txData.StatusCode === 0;
-      const isFailed = !isPaid && !isPending;
-      const isExpired = statusText === "expired";
+      const rawStatus = txData.Status !== void 0 ? txData.Status : txData.status;
+      const statusDesc = (txData.StatusDesc || "").toString().toLowerCase();
+      const paidStatus = (txData.PaidStatus || "").toString().toLowerCase();
+      const statusCode = txData.StatusCode !== void 0 ? Number(txData.StatusCode) : rawStatus !== void 0 ? Number(rawStatus) : void 0;
+      const isPaid = statusCode === 1 || paidStatus === "paid" || statusDesc.includes("berhasil") || statusDesc.includes("success");
+      const isPending = statusCode === 0 || paidStatus === "unpaid" || statusDesc.includes("menunggu") || statusDesc.includes("pending");
+      const isExpired = statusCode === 2 || statusDesc.includes("expired") || statusDesc.includes("kadaluarsa");
+      const isFailed = !isPaid && !isPending && !isExpired;
       const status = isPaid ? "paid" : isPending ? "pending" : isExpired ? "expired" : "failed";
       return {
         success: true,
@@ -8258,6 +8375,62 @@ var IpaymuClient = class {
   async checkTransaction(transactionId) {
     return this.request("POST", "/transaction", { transactionId });
   }
+  /**
+   * Ambil daftar channel pembayaran aktif milik merchant
+   */
+  async getPaymentMethods() {
+    return this.request("POST", "/payment-method-list", { account: this.va });
+  }
+  /**
+   * Ambil riwayat transaksi merchant berpaginasi
+   */
+  async getHistory(params) {
+    const payload = {
+      account: this.va,
+      page: params?.page || 1,
+      limit: params?.limit || 10,
+      ...params
+    };
+    return this.request("POST", "/history", payload);
+  }
+  /**
+   * Ambil daftar seluruh bank di Indonesia
+   */
+  async getBankList() {
+    return this.request("POST", "/banklist", { account: this.va });
+  }
+  /**
+   * Ambil jangkauan area pengiriman COD
+   */
+  async getCodArea(postalCode) {
+    const payload = { account: this.va };
+    if (postalCode) payload.postalCode = postalCode;
+    return this.request("POST", "/cod/getarea", payload);
+  }
+  /**
+   * Hitung tarif ongkir pengiriman COD
+   */
+  async getCodRate(params) {
+    return this.request("POST", "/cod/getrate", { account: this.va, ...params });
+  }
+  /**
+   * Request pickup kurir COD
+   */
+  async getCodPickup(params) {
+    return this.request("POST", "/cod/pickup", { account: this.va, ...params });
+  }
+  /**
+   * Ambil nomor resi / AWB pengiriman COD
+   */
+  async getCodAwb(transactionId) {
+    return this.request("POST", "/cod/getawb", { account: this.va, transactionId });
+  }
+  /**
+   * Lacak status pengiriman kurir berdasarkan no resi / AWB
+   */
+  async getCodTracking(awb) {
+    return this.request("POST", "/cod/tracking", { account: this.va, awb });
+  }
 };
 // src/clients/xendit.ts

package/dist/index.mjs CHANGED Viewed

@@ -123,6 +123,9 @@ var CANONICAL_TO_IPAYMU = {
   permata_va: { paymentMethod: "va", paymentChannel: "permata" },
   danamon_va: { paymentMethod: "va", paymentChannel: "danamon" },
   bsi_va: { paymentMethod: "va", paymentChannel: "bsi" },
+  bag_va: { paymentMethod: "va", paymentChannel: "bag" },
+  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" },
@@ -1580,35 +1583,48 @@ var IpaymuProvider = class extends BasePaymentProvider {
     const baseUrl = this.getBaseUrl(sandbox);
     const endpoint = isDirect ? "/payment/direct" : "/payment";
     const url = `${baseUrl}${endpoint}`;
+    const notifyUrl = callbackUrl || config.callbackUrl || "https://localhost/callback";
+    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;
     let payload;
     if (isDirect) {
       payload = {
         name: customer.name,
         email: customer.email,
-        phone: customer.phone || "",
+        phone: customer.phone || "081234567890",
         amount: integerAmount,
-        notifyUrl: callbackUrl || config.callbackUrl || "",
+        notifyUrl,
         expired: 24,
         expiredType: "hours",
         comments: productDetails,
         referenceId: orderId,
         paymentMethod: ipaymuMethod.paymentMethod,
         ...ipaymuMethod.paymentChannel ? { paymentChannel: ipaymuMethod.paymentChannel } : {},
+        ...feeDirection ? { feeDirection } : {},
+        ...escrow !== void 0 ? { escrow } : {},
         ...params.providerParams
       };
     } else {
+      const hasItems = params.items && params.items.length > 0;
+      const product = hasItems ? params.items.map((i) => i.name) : [productDetails.length > 50 ? productDetails.substring(0, 47) + "..." : productDetails];
+      const qty = hasItems ? params.items.map((i) => i.quantity) : [1];
+      const price = hasItems ? params.items.map((i) => Math.round(i.price)) : [integerAmount];
+      const description = hasItems ? params.items.map((i) => i.description || i.name) : [productDetails];
       payload = {
-        product: [productDetails.length > 50 ? productDetails.substring(0, 47) + "..." : productDetails],
-        qty: [1],
-        price: [integerAmount],
-        description: [productDetails],
-        returnUrl: returnUrl || config.returnUrl || "",
-        notifyUrl: callbackUrl || config.callbackUrl || "",
-        cancelUrl: returnUrl || config.returnUrl || "",
+        product,
+        qty,
+        price,
+        description,
+        returnUrl: redirectUrl,
+        notifyUrl,
+        cancelUrl: redirectUrl,
         referenceId: orderId,
         buyerName: customer.name,
         buyerEmail: customer.email,
-        buyerPhone: customer.phone || "",
+        buyerPhone: customer.phone || "081234567890",
+        ...feeDirection ? { feeDirection } : {},
+        ...escrow !== void 0 ? { escrow } : {},
         ...params.providerParams
       };
     }
@@ -1648,8 +1664,8 @@ var IpaymuProvider = class extends BasePaymentProvider {
           provider: "ipaymu",
           orderId,
           amount: integerAmount,
-          reference: resData.TransactionId ? String(resData.TransactionId) : String(resData.SessionId || ""),
-          paymentUrl: resData.Url,
+          reference: resData.TransactionId ? String(resData.TransactionId) : String(resData.SessionId || resData.SessionID || ""),
+          paymentUrl: resData.Url || resData.url,
           rawResponse: data
         };
         if (resData.PaymentNo) {
@@ -1708,6 +1724,88 @@ var IpaymuProvider = class extends BasePaymentProvider {
     };
   }
   async getPaymentMethods(params, config) {
+    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()}`;
+                }
+              }
+              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
+            };
+          }
+        }
+      } catch (err) {
+      }
+    }
     const staticMethods = [
       {
         paymentMethod: "bca_va",
@@ -1773,6 +1871,22 @@ var IpaymuProvider = class extends BasePaymentProvider {
         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",
@@ -1874,11 +1988,14 @@ var IpaymuProvider = class extends BasePaymentProvider {
         };
       }
       const txData = data.Data || {};
-      const statusText = (txData.Status || txData.status || "").toString().toLowerCase();
-      const isPaid = statusText === "berhasil" || statusText === "success" || txData.StatusCode === 1;
-      const isPending = statusText === "pending" || txData.StatusCode === 0;
-      const isFailed = !isPaid && !isPending;
-      const isExpired = statusText === "expired";
+      const rawStatus = txData.Status !== void 0 ? txData.Status : txData.status;
+      const statusDesc = (txData.StatusDesc || "").toString().toLowerCase();
+      const paidStatus = (txData.PaidStatus || "").toString().toLowerCase();
+      const statusCode = txData.StatusCode !== void 0 ? Number(txData.StatusCode) : rawStatus !== void 0 ? Number(rawStatus) : void 0;
+      const isPaid = statusCode === 1 || paidStatus === "paid" || statusDesc.includes("berhasil") || statusDesc.includes("success");
+      const isPending = statusCode === 0 || paidStatus === "unpaid" || statusDesc.includes("menunggu") || statusDesc.includes("pending");
+      const isExpired = statusCode === 2 || statusDesc.includes("expired") || statusDesc.includes("kadaluarsa");
+      const isFailed = !isPaid && !isPending && !isExpired;
       const status = isPaid ? "paid" : isPending ? "pending" : isExpired ? "expired" : "failed";
       return {
         success: true,
@@ -8094,6 +8211,62 @@ var IpaymuClient = class {
   async checkTransaction(transactionId) {
     return this.request("POST", "/transaction", { transactionId });
   }
+  /**
+   * Ambil daftar channel pembayaran aktif milik merchant
+   */
+  async getPaymentMethods() {
+    return this.request("POST", "/payment-method-list", { account: this.va });
+  }
+  /**
+   * Ambil riwayat transaksi merchant berpaginasi
+   */
+  async getHistory(params) {
+    const payload = {
+      account: this.va,
+      page: params?.page || 1,
+      limit: params?.limit || 10,
+      ...params
+    };
+    return this.request("POST", "/history", payload);
+  }
+  /**
+   * Ambil daftar seluruh bank di Indonesia
+   */
+  async getBankList() {
+    return this.request("POST", "/banklist", { account: this.va });
+  }
+  /**
+   * Ambil jangkauan area pengiriman COD
+   */
+  async getCodArea(postalCode) {
+    const payload = { account: this.va };
+    if (postalCode) payload.postalCode = postalCode;
+    return this.request("POST", "/cod/getarea", payload);
+  }
+  /**
+   * Hitung tarif ongkir pengiriman COD
+   */
+  async getCodRate(params) {
+    return this.request("POST", "/cod/getrate", { account: this.va, ...params });
+  }
+  /**
+   * Request pickup kurir COD
+   */
+  async getCodPickup(params) {
+    return this.request("POST", "/cod/pickup", { account: this.va, ...params });
+  }
+  /**
+   * Ambil nomor resi / AWB pengiriman COD
+   */
+  async getCodAwb(transactionId) {
+    return this.request("POST", "/cod/getawb", { account: this.va, transactionId });
+  }
+  /**
+   * Lacak status pengiriman kurir berdasarkan no resi / AWB
+   */
+  async getCodTracking(awb) {
+    return this.request("POST", "/cod/tracking", { account: this.va, awb });
+  }
 };
 // src/clients/xendit.ts

package/docs/guide.md CHANGED Viewed

@@ -19,7 +19,8 @@ Panduan ini adalah **satu-satunya** panduan yang Anda butuhkan untuk mengintegra
 9. [Provider Dinamis & Autodetect](#-provider-dinamis--autodetect)
 10. [Cek Capability Provider (Portabilitas)](#-cek-capability-provider-portabilitas)
 11. [Fitur Khusus Provider (`<X>Client`)](#-fitur-khusus-provider-xclient)
-12. [Kamus Variabel `.env` per Provider](#-kamus-variabel-env-per-provider)
+12. [Panduan Pengisian Variabel Universal (`BUAYAR_*`) per Provider](#-panduan-pengisian-variabel-universal-buayar_-per-provider)
+13. [Daftar Canonical Payment Methods](#-daftar-canonical-payment-methods)
 ---
@@ -370,57 +371,59 @@ const balance = await xendit.checkBalance("CASH");
 Rangkuman kemampuan ekstra tiap provider:
-| Provider | Getter | Kemampuan ekstra |
-| :--- | :--- | :--- |
-| Midtrans | `getMidtransClient()` | cancel/refund/expire/approve/deny/capture, GoPay tokenization, Subscription, Payment Link, IRIS balance |
-| Duitku | `getDuitkuClient()` | balance, listBanks, inquiryBankAccount, disburse, checkDisbursementStatus |
-| iPaymu | `getIpaymuClient()` | balance, checkTransaction |
-| 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 |
+| 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 |
 ---
-## 📚 Kamus Variabel `.env` per Provider
-Anda hanya perlu mengisi kredensial provider yang **sedang aktif**. Gunakan variabel universal (`BUAYAR_*`) bila ingin kode benar-benar provider-agnostic, atau variabel spesifik di bawah.
-| Provider | Variabel `.env` |
-| :--- | :--- |
-| Midtrans | `MIDTRANS_SERVER_KEY`, `MIDTRANS_CLIENT_KEY` |
-| Duitku | `DUITKU_API_KEY`, `DUITKU_MERCHANT_CODE` |
-| iPaymu | `IPAYMU_API_KEY`, `IPAYMU_VA` |
-| Xendit | `XENDIT_SECRET_KEY`, `XENDIT_WEBHOOK_TOKEN` |
-| DOKU | `DOKU_CLIENT_ID`, `DOKU_SECRET_KEY` |
-| PrismaLink | `PRISMALINK_MERCHANT_ID`, `PRISMALINK_SECRET_KEY` |
-| Faspay | `FASPAY_MERCHANT_ID`, `FASPAY_USER_ID`, `FASPAY_PASSWORD`, `FASPAY_MERCHANT_NAME` |
-| Finpay | `FINPAY_MERCHANT_ID`, `FINPAY_MERCHANT_KEY` |
-| Nicepay | `NICEPAY_IMID`, `NICEPAY_KEY` |
-| OY! Bisnis | `OY_USERNAME`, `OY_API_KEY` |
-| Stripe | `STRIPE_SECRET_KEY`, `STRIPE_PUBLIC_KEY`, `STRIPE_WEBHOOK_SECRET` |
-| PayPal | `PAYPAL_CLIENT_ID`, `PAYPAL_CLIENT_SECRET`, `PAYPAL_WEBHOOK_ID` |
-| Adyen | `ADYEN_API_KEY`, `ADYEN_MERCHANT_ACCOUNT`, `ADYEN_CLIENT_KEY`, `ADYEN_HMAC_KEY`, `ADYEN_LIVE_URL_PREFIX` |
-| Checkout.com | `CHECKOUTCOM_SECRET_KEY`, `CHECKOUTCOM_PUBLIC_KEY`, `CHECKOUTCOM_WEBHOOK_SECRET` |
-| Razorpay | `RAZORPAY_KEY_ID`, `RAZORPAY_KEY_SECRET`, `RAZORPAY_WEBHOOK_SECRET` |
-| Square | `SQUARE_ACCESS_TOKEN`, `SQUARE_APPLICATION_ID`, `SQUARE_LOCATION_ID`, `SQUARE_WEBHOOK_SIGNATURE_KEY` |
-| PayU | `PAYU_POS_ID`, `PAYU_MD5_KEY`, `PAYU_OAUTH_CLIENT_ID`, `PAYU_OAUTH_CLIENT_SECRET` |
-| Braintree | `BRAINTREE_MERCHANT_ID`, `BRAINTREE_PUBLIC_KEY`, `BRAINTREE_PRIVATE_KEY` |
-| 2Checkout | `TWOCHECKOUT_MERCHANT_CODE`, `TWOCHECKOUT_SECRET_KEY`, `TWOCHECKOUT_SECRET_WORD` |
-Sandbox: otomatis terdeteksi dari `BUAYAR_SANDBOX`/`NODE_ENV`, atau set per-provider (mis. `STRIPE_SANDBOX=true`, `MIDTRANS_SANDBOX=true`).
+## 📚 Panduan Pengisian Variabel Universal (`BUAYAR_*`) per Provider
+Anda **tidak perlu** membuat nama variabel khusus per provider (seperti `IPAYMU_API_KEY`, `DUITKU_API_KEY`, dsb.). Cukup gunakan set variabel seragam **`BUAYAR_*`**.
+Tabel berikut menunjukkan data apa dari dashboard masing-masing payment gateway yang perlu Anda masukkan ke variabel `BUAYAR_*`:
+| Provider | `BUAYAR_PROVIDER` | `BUAYAR_API_KEY` | `BUAYAR_MERCHANT_CODE` | `BUAYAR_CLIENT_KEY` / Tambahan |
+| :--- | :--- | :--- | :--- | :--- |
+| **Midtrans** | `midtrans` | Server Key | *(opsional)* | Client Key |
+| **Duitku** | `duitku` | API Key | Merchant Code | *(tidak perlu)* |
+| **iPaymu** | `ipaymu` | API Key | Nomor Virtual Account (VA) | *(tidak perlu)* |
+| **Xendit** | `xendit` | Secret Key | *(opsional)* | Webhook Verification Token (`BUAYAR_WEBHOOK_SECRET`) |
+| **DOKU Jokul** | `doku` | Secret Key | Client ID / Merchant ID | Client ID |
+| **PrismaLink** | `prismalink` | Secret Key | Merchant ID | *(tidak perlu)* |
+| **Faspay** | `faspay` | Password | Merchant ID | User ID |
+| **Finpay** | `finpay` | Merchant Key | Merchant ID | *(tidak perlu)* |
+| **Nicepay** | `nicepay` | Server Key (Secret) | I-MID (Merchant ID) | *(tidak perlu)* |
+| **OY! Bisnis** | `oy` | API Key | Username | Username |
+| **Stripe** | `stripe` | Secret Key (`sk_...`) | *(tidak perlu)* | Publishable Key (`pk_...`) / Webhook Secret |
+| **PayPal** | `paypal` | Client Secret | Client ID | Client ID |
+| **Adyen** | `adyen` | API Key | Merchant Account Name | Client Key / HMAC Key (`BUAYAR_WEBHOOK_SECRET`) |
+| **Checkout.com** | `checkoutcom` | Secret Key (`sk_...`) | *(tidak perlu)* | Public Key (`pk_...`) / Webhook Secret |
+| **Razorpay** | `razorpay` | Key Secret | Key ID | Key ID |
+| **Square** | `square` | Access Token | Application ID | Location ID (`BUAYAR_PROJECT_ID`) |
+| **PayU** | `payu` | MD5 Key / Secret | POS ID | POS ID |
+| **Braintree** | `braintree` | Private Key | Merchant ID | Public Key |
+| **2Checkout** | `twocheckout` | Secret Key | Merchant Code | Secret Word (`BUAYAR_WEBHOOK_SECRET`) |
+> 💡 **Mode Sandbox:** Cukup tambahkan `BUAYAR_SANDBOX=true` (atau `false` saat production), SDK otomatis menyesuaikan URL endpoint API seluruh provider di atas tanpa perlu konfigurasi tambahan.
 ---
@@ -428,7 +431,7 @@ Sandbox: otomatis terdeteksi dari `BUAYAR_SANDBOX`/`NODE_ENV`, atau set per-prov
 | Kategori | Canonical Code |
 | :--- | :--- |
-| **Virtual Account** | `bca_va`, `mandiri_va`, `bni_va`, `bri_va`, `permata_va`, `cimb_va`, `danamon_va`, `bsi_va`, `seabank_va` |
+| **Virtual Account** | `bca_va`, `mandiri_va`, `bni_va`, `bri_va`, `permata_va`, `cimb_va`, `danamon_va`, `bsi_va`, `seabank_va`, `bag_va`, `muamalat_va` |
 | **QRIS** | `qris`, `gopay_qris`, `shopeepay_qris`, `nobu_qris` |
 | **E-Wallet** | `gopay`, `shopeepay`, `ovo`, `dana`, `linkaja`, `jenius` |
 | **Retail** | `alfamart`, `indomaret`, `pos` |

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@crediblemark/buayar",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Unified Payment Gateway SDK for Node.js & TypeScript — 19 providers (Midtrans, Xendit, Duitku, Stripe, PayPal, Adyen, Razorpay, Square, Checkout.com, PayU, Braintree, 2Checkout, DOKU, iPaymu, PrismaLink, Faspay, Finpay, Nicepay, OY!) with zero-code switching via .env",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",