@crediblemark/buayar 0.8.3 → 0.8.5

package/dist/cli/index.js

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

package/dist/index.d.mts

@@ -216,6 +216,39 @@ interface GetPaymentMethodsResult {
     error?: string;
     rawResponse: any;
 }
+/**
+ * Deskriptor saluran pembayaran kanonikal siap-render untuk UI.
+ * Dibangun dari {@link PaymentMethod} via `buildPaymentMethodDescriptors()` di
+ * `core/descriptor.ts` sehingga konsumen (frontend, snapshot, CLI) selalu
+ * mendapat bentuk seragam tanpa perlu mapping ulang per provider.
+ */
+interface PaymentMethodDescriptor {
+    /** Identifier uppercase yang dipakai sistem internal (mis. 'BCA_VA', 'QRIS', 'GOPAY') */
+    id: string;
+    /** Nama ramah pengguna */
+    name: string;
+    /** Tipe singkat untuk icon/badge rendering */
+    type: "qris" | "va" | "ewallet" | "retail" | "card" | "paylater" | "other";
+    /** Ikon emoji */
+    icon: string;
+    /** Badge teks (mis. "Instan Bebas Biaya") */
+    badge: string;
+    /** URL logo (opsional) */
+    image?: string;
+    /** Kategori resmi Buayar (Virtual Account, QRIS, E-Wallet, dll) */
+    category?: string;
+    /** Apakah channel tersedia (true) atau coming-soon (false) */
+    coming_soon?: boolean;
+    /** Fee admin (string deskriptif, mis. "0.7%" atau "IDR 4,000") */
+    totalFee?: string;
+}
+interface GetPaymentMethodDescriptorsResult {
+    success: boolean;
+    provider?: string;
+    descriptors: PaymentMethodDescriptor[];
+    error?: string;
+    generatedAt: string;
+}
 interface CheckTransactionParams {
     /** Merchant order ID saat pembuatan transaksi */
     merchantOrderId: string;
@@ -1309,6 +1342,13 @@ declare class Buayar {
      * Ambil daftar channel pembayaran aktif (Accordion-Ready)
      */
     getPaymentMethods(params?: GetPaymentMethodsParams, configOverride?: Partial<ProviderConfig>): Promise<GetPaymentMethodsResult>;
+    /**
+     * Ambil daftar channel pembayaran aktif dalam bentuk deskriptor kanonikal
+     * siap-render (id, name, type, icon, badge, image, category, totalFee).
+     * Wrapper di atas {@link Buayar.getPaymentMethods} + `buildPaymentMethodDescriptors`,
+     * sehingga konsumen UI/snapshot tidak perlu melakukan mapping ulang per provider.
+     */
+    getPaymentMethodDescriptors(params?: GetPaymentMethodsParams, configOverride?: Partial<ProviderConfig>): Promise<GetPaymentMethodDescriptorsResult>;
     /**
      * Cek status transaksi pembayaran berdasarkan Order ID
      */
@@ -1489,6 +1529,26 @@ declare function toStripePaymentMethod(code?: string): string | undefined;
  */
 declare function toCanonicalPaymentMethod(provider: string, code?: string): string;
 
+type PaymentMethodDescriptorType = PaymentMethodDescriptor["type"];
+/**
+ * Sandingkan kategori resmi Buayar menjadi tipe singkat UI.
+ * Kategori bisa berbeda antar provider, oleh karena itu mapping dilakukan
+ * di sini (sentral) agar konsumen tidak perlu tahu detail kategori per PG.
+ */
+declare function mapCategoryToDescriptorType(category: string, paymentMethod?: string): PaymentMethodDescriptorType;
+/**
+ * Bangun satu deskriptor kanonikal siap-render dari objek PaymentMethod.
+ *
+ * @param pm  Hasil mentah provider (lihat `PaymentMethod`).
+ * @param _providerName  Nama provider aktif (disimpan untuk keperluan lattice
+ *   masa depan; saat ini mapping kategori sudah generik).
+ */
+declare function buildPaymentMethodDescriptor(pm: PaymentMethod, _providerName?: string): PaymentMethodDescriptor;
+/**
+ * Bangun daftar deskriptor kanonikal dari hasil `getPaymentMethods()`.
+ */
+declare function buildPaymentMethodDescriptors(methods: PaymentMethod[], providerName?: string): PaymentMethodDescriptor[];
+
 declare function getDuitkuInquirySignatures(merchantCode: string, orderId: string, amount: number, apiKey: string): {
     payloadSignature: string;
     timestamp: string;
@@ -1893,4 +1953,4 @@ declare function safeCompare(a: string, b: string): boolean;
  */
 declare function getPaymentMethodCategory(code: string, name?: string): "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
 
-export { AdyenClient, AdyenProvider, BasePaymentProvider, BraintreeClient, BraintreeProvider, Buayar, type BuayarConfig, CANONICAL_TO_DOKU, CANONICAL_TO_DUITKU, CANONICAL_TO_FASPAY, CANONICAL_TO_FINPAY, CANONICAL_TO_IPAYMU, CANONICAL_TO_MIDTRANS, CANONICAL_TO_NICEPAY, CANONICAL_TO_OY, CANONICAL_TO_PRISMALINK, CANONICAL_TO_STRIPE, CANONICAL_TO_XENDIT, CORE_API_METHODS, type CanonicalPaymentMethod, type CheckBalanceResult, type CheckTransactionParams, type CheckTransactionResult, CheckoutComClient, CheckoutComProvider, type CreateInvoiceParams, type CustomerDetails, DUITKU_TO_CANONICAL, type DisburseParams, type DisburseResult, DokuClient, DokuProvider, DuitkuClient, type DuitkuDisbursementParams, DuitkuProvider, type EWalletResponse, FaspayClient, FaspayProvider, FinpayClient, FinpayProvider, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, IpaymuClient, IpaymuProvider, MIDTRANS_PROBE_PAYLOADS, MIDTRANS_STATIC_METHODS, type MandiriBillInfo, MidtransClient, MidtransProvider, NicepayClient, NicepayProvider, OyClient, OyProvider, PaymentManager, type PaymentMethod, type PaymentMethodItem, type PaymentMode, PaypalClient, PaypalProvider, PayuClient, PayuProvider, PrismalinkClient, PrismalinkProvider, type ProviderCapability, type ProviderConfig, type ProviderDescriptor, ProviderRegistry, type QrisResponse, RazorpayClient, RazorpayProvider, type RefundParams, type RefundResult, SnapApiError, SnapClient, type SnapClientOptions, SquareClient, SquareProvider, StripeClient, StripeProvider, TwoCheckoutClient, TwoCheckoutProvider, type VerifyCallbackResult, type VirtualAccountResponse, XenditClient, type XenditDisbursementParams, XenditProvider, buayar, buildBraintreeBasicAuth, buildCoreChargePayload, buildDefaultDescriptors, buildIpaymuCallbackString, buildPaypalBasicAuth, buildPayuBasicAuth, buildRazorpayBasicAuth, buildTwoCheckoutAuth, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, generateSnapAsymmetricSignature, generateSnapSymmetricSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, md5, minifyJson, normalizeIpaymuCallback, parseCoreChargeResponse, paymentManager, providerRegistry, resolveConfigFromEnv, safeCompare, serializePaypalParams, serializeStripeParams, sha256, sha256Hex, sha512, snapErrorHint, snapExternalId, snapTimestamp, snapUtcTimestamp, toCanonicalPaymentMethod, toDokuPaymentMethod, toDuitkuPaymentMethod, toFaspayPaymentMethod, toFinpayPaymentMethod, toIpaymuPaymentMethod, toNicepayPaymentMethod, toOyPaymentMethod, toPrismalinkPaymentMethod, toStripePaymentMethod, toXenditPaymentMethod, verifyAdyenWebhook, verifyBraintreeWebhook, verifyCheckoutComWebhook, verifyDokuWebhookSignature, verifyDuitkuCallbackSignature, verifyFaspaySignature, verifyFinpaySignature, verifyIpaymuCallback, verifyIpaymuCallbackSignature, verifyNicepayWebhook, verifyOyWebhook, verifyPaypalWebhookSimple, verifyPayuWebhook, verifyPrismalinkSignature, verifyRazorpayWebhook, verifySnapWebhookSignature, verifySquareWebhook, verifyStripeWebhook, verifyTwoCheckoutWebhook, verifyXenditWebhookToken };
+export { AdyenClient, AdyenProvider, BasePaymentProvider, BraintreeClient, BraintreeProvider, Buayar, type BuayarConfig, CANONICAL_TO_DOKU, CANONICAL_TO_DUITKU, CANONICAL_TO_FASPAY, CANONICAL_TO_FINPAY, CANONICAL_TO_IPAYMU, CANONICAL_TO_MIDTRANS, CANONICAL_TO_NICEPAY, CANONICAL_TO_OY, CANONICAL_TO_PRISMALINK, CANONICAL_TO_STRIPE, CANONICAL_TO_XENDIT, CORE_API_METHODS, type CanonicalPaymentMethod, type CheckBalanceResult, type CheckTransactionParams, type CheckTransactionResult, CheckoutComClient, CheckoutComProvider, type CreateInvoiceParams, type CustomerDetails, DUITKU_TO_CANONICAL, type DisburseParams, type DisburseResult, DokuClient, DokuProvider, DuitkuClient, type DuitkuDisbursementParams, DuitkuProvider, type EWalletResponse, FaspayClient, FaspayProvider, FinpayClient, FinpayProvider, type GetPaymentMethodDescriptorsResult, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, IpaymuClient, IpaymuProvider, MIDTRANS_PROBE_PAYLOADS, MIDTRANS_STATIC_METHODS, type MandiriBillInfo, MidtransClient, MidtransProvider, NicepayClient, NicepayProvider, OyClient, OyProvider, PaymentManager, type PaymentMethod, type PaymentMethodDescriptor, type PaymentMethodDescriptorType, type PaymentMethodItem, type PaymentMode, PaypalClient, PaypalProvider, PayuClient, PayuProvider, PrismalinkClient, PrismalinkProvider, type ProviderCapability, type ProviderConfig, type ProviderDescriptor, ProviderRegistry, type QrisResponse, RazorpayClient, RazorpayProvider, type RefundParams, type RefundResult, SnapApiError, SnapClient, type SnapClientOptions, SquareClient, SquareProvider, StripeClient, StripeProvider, TwoCheckoutClient, TwoCheckoutProvider, type VerifyCallbackResult, type VirtualAccountResponse, XenditClient, type XenditDisbursementParams, XenditProvider, buayar, buildBraintreeBasicAuth, buildCoreChargePayload, buildDefaultDescriptors, buildIpaymuCallbackString, buildPaymentMethodDescriptor, buildPaymentMethodDescriptors, buildPaypalBasicAuth, buildPayuBasicAuth, buildRazorpayBasicAuth, buildTwoCheckoutAuth, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, generateSnapAsymmetricSignature, generateSnapSymmetricSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, mapCategoryToDescriptorType, md5, minifyJson, normalizeIpaymuCallback, parseCoreChargeResponse, paymentManager, providerRegistry, resolveConfigFromEnv, safeCompare, serializePaypalParams, serializeStripeParams, sha256, sha256Hex, sha512, snapErrorHint, snapExternalId, snapTimestamp, snapUtcTimestamp, toCanonicalPaymentMethod, toDokuPaymentMethod, toDuitkuPaymentMethod, toFaspayPaymentMethod, toFinpayPaymentMethod, toIpaymuPaymentMethod, toNicepayPaymentMethod, toOyPaymentMethod, toPrismalinkPaymentMethod, toStripePaymentMethod, toXenditPaymentMethod, verifyAdyenWebhook, verifyBraintreeWebhook, verifyCheckoutComWebhook, verifyDokuWebhookSignature, verifyDuitkuCallbackSignature, verifyFaspaySignature, verifyFinpaySignature, verifyIpaymuCallback, verifyIpaymuCallbackSignature, verifyNicepayWebhook, verifyOyWebhook, verifyPaypalWebhookSimple, verifyPayuWebhook, verifyPrismalinkSignature, verifyRazorpayWebhook, verifySnapWebhookSignature, verifySquareWebhook, verifyStripeWebhook, verifyTwoCheckoutWebhook, verifyXenditWebhookToken };

package/dist/index.d.ts

@@ -216,6 +216,39 @@ interface GetPaymentMethodsResult {
     error?: string;
     rawResponse: any;
 }
+/**
+ * Deskriptor saluran pembayaran kanonikal siap-render untuk UI.
+ * Dibangun dari {@link PaymentMethod} via `buildPaymentMethodDescriptors()` di
+ * `core/descriptor.ts` sehingga konsumen (frontend, snapshot, CLI) selalu
+ * mendapat bentuk seragam tanpa perlu mapping ulang per provider.
+ */
+interface PaymentMethodDescriptor {
+    /** Identifier uppercase yang dipakai sistem internal (mis. 'BCA_VA', 'QRIS', 'GOPAY') */
+    id: string;
+    /** Nama ramah pengguna */
+    name: string;
+    /** Tipe singkat untuk icon/badge rendering */
+    type: "qris" | "va" | "ewallet" | "retail" | "card" | "paylater" | "other";
+    /** Ikon emoji */
+    icon: string;
+    /** Badge teks (mis. "Instan Bebas Biaya") */
+    badge: string;
+    /** URL logo (opsional) */
+    image?: string;
+    /** Kategori resmi Buayar (Virtual Account, QRIS, E-Wallet, dll) */
+    category?: string;
+    /** Apakah channel tersedia (true) atau coming-soon (false) */
+    coming_soon?: boolean;
+    /** Fee admin (string deskriptif, mis. "0.7%" atau "IDR 4,000") */
+    totalFee?: string;
+}
+interface GetPaymentMethodDescriptorsResult {
+    success: boolean;
+    provider?: string;
+    descriptors: PaymentMethodDescriptor[];
+    error?: string;
+    generatedAt: string;
+}
 interface CheckTransactionParams {
     /** Merchant order ID saat pembuatan transaksi */
     merchantOrderId: string;
@@ -1309,6 +1342,13 @@ declare class Buayar {
      * Ambil daftar channel pembayaran aktif (Accordion-Ready)
      */
     getPaymentMethods(params?: GetPaymentMethodsParams, configOverride?: Partial<ProviderConfig>): Promise<GetPaymentMethodsResult>;
+    /**
+     * Ambil daftar channel pembayaran aktif dalam bentuk deskriptor kanonikal
+     * siap-render (id, name, type, icon, badge, image, category, totalFee).
+     * Wrapper di atas {@link Buayar.getPaymentMethods} + `buildPaymentMethodDescriptors`,
+     * sehingga konsumen UI/snapshot tidak perlu melakukan mapping ulang per provider.
+     */
+    getPaymentMethodDescriptors(params?: GetPaymentMethodsParams, configOverride?: Partial<ProviderConfig>): Promise<GetPaymentMethodDescriptorsResult>;
     /**
      * Cek status transaksi pembayaran berdasarkan Order ID
      */
@@ -1489,6 +1529,26 @@ declare function toStripePaymentMethod(code?: string): string | undefined;
  */
 declare function toCanonicalPaymentMethod(provider: string, code?: string): string;
 
+type PaymentMethodDescriptorType = PaymentMethodDescriptor["type"];
+/**
+ * Sandingkan kategori resmi Buayar menjadi tipe singkat UI.
+ * Kategori bisa berbeda antar provider, oleh karena itu mapping dilakukan
+ * di sini (sentral) agar konsumen tidak perlu tahu detail kategori per PG.
+ */
+declare function mapCategoryToDescriptorType(category: string, paymentMethod?: string): PaymentMethodDescriptorType;
+/**
+ * Bangun satu deskriptor kanonikal siap-render dari objek PaymentMethod.
+ *
+ * @param pm  Hasil mentah provider (lihat `PaymentMethod`).
+ * @param _providerName  Nama provider aktif (disimpan untuk keperluan lattice
+ *   masa depan; saat ini mapping kategori sudah generik).
+ */
+declare function buildPaymentMethodDescriptor(pm: PaymentMethod, _providerName?: string): PaymentMethodDescriptor;
+/**
+ * Bangun daftar deskriptor kanonikal dari hasil `getPaymentMethods()`.
+ */
+declare function buildPaymentMethodDescriptors(methods: PaymentMethod[], providerName?: string): PaymentMethodDescriptor[];
+
 declare function getDuitkuInquirySignatures(merchantCode: string, orderId: string, amount: number, apiKey: string): {
     payloadSignature: string;
     timestamp: string;
@@ -1893,4 +1953,4 @@ declare function safeCompare(a: string, b: string): boolean;
  */
 declare function getPaymentMethodCategory(code: string, name?: string): "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
 
-export { AdyenClient, AdyenProvider, BasePaymentProvider, BraintreeClient, BraintreeProvider, Buayar, type BuayarConfig, CANONICAL_TO_DOKU, CANONICAL_TO_DUITKU, CANONICAL_TO_FASPAY, CANONICAL_TO_FINPAY, CANONICAL_TO_IPAYMU, CANONICAL_TO_MIDTRANS, CANONICAL_TO_NICEPAY, CANONICAL_TO_OY, CANONICAL_TO_PRISMALINK, CANONICAL_TO_STRIPE, CANONICAL_TO_XENDIT, CORE_API_METHODS, type CanonicalPaymentMethod, type CheckBalanceResult, type CheckTransactionParams, type CheckTransactionResult, CheckoutComClient, CheckoutComProvider, type CreateInvoiceParams, type CustomerDetails, DUITKU_TO_CANONICAL, type DisburseParams, type DisburseResult, DokuClient, DokuProvider, DuitkuClient, type DuitkuDisbursementParams, DuitkuProvider, type EWalletResponse, FaspayClient, FaspayProvider, FinpayClient, FinpayProvider, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, IpaymuClient, IpaymuProvider, MIDTRANS_PROBE_PAYLOADS, MIDTRANS_STATIC_METHODS, type MandiriBillInfo, MidtransClient, MidtransProvider, NicepayClient, NicepayProvider, OyClient, OyProvider, PaymentManager, type PaymentMethod, type PaymentMethodItem, type PaymentMode, PaypalClient, PaypalProvider, PayuClient, PayuProvider, PrismalinkClient, PrismalinkProvider, type ProviderCapability, type ProviderConfig, type ProviderDescriptor, ProviderRegistry, type QrisResponse, RazorpayClient, RazorpayProvider, type RefundParams, type RefundResult, SnapApiError, SnapClient, type SnapClientOptions, SquareClient, SquareProvider, StripeClient, StripeProvider, TwoCheckoutClient, TwoCheckoutProvider, type VerifyCallbackResult, type VirtualAccountResponse, XenditClient, type XenditDisbursementParams, XenditProvider, buayar, buildBraintreeBasicAuth, buildCoreChargePayload, buildDefaultDescriptors, buildIpaymuCallbackString, buildPaypalBasicAuth, buildPayuBasicAuth, buildRazorpayBasicAuth, buildTwoCheckoutAuth, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, generateSnapAsymmetricSignature, generateSnapSymmetricSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, md5, minifyJson, normalizeIpaymuCallback, parseCoreChargeResponse, paymentManager, providerRegistry, resolveConfigFromEnv, safeCompare, serializePaypalParams, serializeStripeParams, sha256, sha256Hex, sha512, snapErrorHint, snapExternalId, snapTimestamp, snapUtcTimestamp, toCanonicalPaymentMethod, toDokuPaymentMethod, toDuitkuPaymentMethod, toFaspayPaymentMethod, toFinpayPaymentMethod, toIpaymuPaymentMethod, toNicepayPaymentMethod, toOyPaymentMethod, toPrismalinkPaymentMethod, toStripePaymentMethod, toXenditPaymentMethod, verifyAdyenWebhook, verifyBraintreeWebhook, verifyCheckoutComWebhook, verifyDokuWebhookSignature, verifyDuitkuCallbackSignature, verifyFaspaySignature, verifyFinpaySignature, verifyIpaymuCallback, verifyIpaymuCallbackSignature, verifyNicepayWebhook, verifyOyWebhook, verifyPaypalWebhookSimple, verifyPayuWebhook, verifyPrismalinkSignature, verifyRazorpayWebhook, verifySnapWebhookSignature, verifySquareWebhook, verifyStripeWebhook, verifyTwoCheckoutWebhook, verifyXenditWebhookToken };
+export { AdyenClient, AdyenProvider, BasePaymentProvider, BraintreeClient, BraintreeProvider, Buayar, type BuayarConfig, CANONICAL_TO_DOKU, CANONICAL_TO_DUITKU, CANONICAL_TO_FASPAY, CANONICAL_TO_FINPAY, CANONICAL_TO_IPAYMU, CANONICAL_TO_MIDTRANS, CANONICAL_TO_NICEPAY, CANONICAL_TO_OY, CANONICAL_TO_PRISMALINK, CANONICAL_TO_STRIPE, CANONICAL_TO_XENDIT, CORE_API_METHODS, type CanonicalPaymentMethod, type CheckBalanceResult, type CheckTransactionParams, type CheckTransactionResult, CheckoutComClient, CheckoutComProvider, type CreateInvoiceParams, type CustomerDetails, DUITKU_TO_CANONICAL, type DisburseParams, type DisburseResult, DokuClient, DokuProvider, DuitkuClient, type DuitkuDisbursementParams, DuitkuProvider, type EWalletResponse, FaspayClient, FaspayProvider, FinpayClient, FinpayProvider, type GetPaymentMethodDescriptorsResult, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, IpaymuClient, IpaymuProvider, MIDTRANS_PROBE_PAYLOADS, MIDTRANS_STATIC_METHODS, type MandiriBillInfo, MidtransClient, MidtransProvider, NicepayClient, NicepayProvider, OyClient, OyProvider, PaymentManager, type PaymentMethod, type PaymentMethodDescriptor, type PaymentMethodDescriptorType, type PaymentMethodItem, type PaymentMode, PaypalClient, PaypalProvider, PayuClient, PayuProvider, PrismalinkClient, PrismalinkProvider, type ProviderCapability, type ProviderConfig, type ProviderDescriptor, ProviderRegistry, type QrisResponse, RazorpayClient, RazorpayProvider, type RefundParams, type RefundResult, SnapApiError, SnapClient, type SnapClientOptions, SquareClient, SquareProvider, StripeClient, StripeProvider, TwoCheckoutClient, TwoCheckoutProvider, type VerifyCallbackResult, type VirtualAccountResponse, XenditClient, type XenditDisbursementParams, XenditProvider, buayar, buildBraintreeBasicAuth, buildCoreChargePayload, buildDefaultDescriptors, buildIpaymuCallbackString, buildPaymentMethodDescriptor, buildPaymentMethodDescriptors, buildPaypalBasicAuth, buildPayuBasicAuth, buildRazorpayBasicAuth, buildTwoCheckoutAuth, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, generateSnapAsymmetricSignature, generateSnapSymmetricSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, mapCategoryToDescriptorType, md5, minifyJson, normalizeIpaymuCallback, parseCoreChargeResponse, paymentManager, providerRegistry, resolveConfigFromEnv, safeCompare, serializePaypalParams, serializeStripeParams, sha256, sha256Hex, sha512, snapErrorHint, snapExternalId, snapTimestamp, snapUtcTimestamp, toCanonicalPaymentMethod, toDokuPaymentMethod, toDuitkuPaymentMethod, toFaspayPaymentMethod, toFinpayPaymentMethod, toIpaymuPaymentMethod, toNicepayPaymentMethod, toOyPaymentMethod, toPrismalinkPaymentMethod, toStripePaymentMethod, toXenditPaymentMethod, verifyAdyenWebhook, verifyBraintreeWebhook, verifyCheckoutComWebhook, verifyDokuWebhookSignature, verifyDuitkuCallbackSignature, verifyFaspaySignature, verifyFinpaySignature, verifyIpaymuCallback, verifyIpaymuCallbackSignature, verifyNicepayWebhook, verifyOyWebhook, verifyPaypalWebhookSimple, verifyPayuWebhook, verifyPrismalinkSignature, verifyRazorpayWebhook, verifySnapWebhookSignature, verifySquareWebhook, verifyStripeWebhook, verifyTwoCheckoutWebhook, verifyXenditWebhookToken };

package/dist/index.js

@@ -94,6 +94,8 @@ __export(index_exports, {
   buildCoreChargePayload: () => buildCoreChargePayload,
   buildDefaultDescriptors: () => buildDefaultDescriptors,
   buildIpaymuCallbackString: () => buildIpaymuCallbackString,
+  buildPaymentMethodDescriptor: () => buildPaymentMethodDescriptor,
+  buildPaymentMethodDescriptors: () => buildPaymentMethodDescriptors,
   buildPaypalBasicAuth: () => buildPaypalBasicAuth,
   buildPayuBasicAuth: () => buildPayuBasicAuth,
   buildRazorpayBasicAuth: () => buildRazorpayBasicAuth,
@@ -114,6 +116,7 @@ __export(index_exports, {
   getPaymentMethodCategory: () => getPaymentMethodCategory,
   getXenditAuthHeader: () => getXenditAuthHeader,
   hmacSha256: () => hmacSha256,
+  mapCategoryToDescriptorType: () => mapCategoryToDescriptorType,
   md5: () => md5,
   minifyJson: () => minifyJson,
   normalizeIpaymuCallback: () => normalizeIpaymuCallback,
@@ -2030,6 +2033,10 @@ var IpaymuProvider = class extends BasePaymentProvider {
                 feeDetail: ch.TransactionFee
               }
             };
+            const health = String(ch.HealthStatus || "").toLowerCase();
+            const feature = String(ch.FeatureStatus || "").toLowerCase();
+            const explicitlyUnavailable = feature !== "" && feature !== "active" || health !== "" && health !== "online";
+            if (explicitlyUnavailable) continue;
             methods.push(pm);
             if (!categories[category]) categories[category] = [];
             categories[category].push(pm);
@@ -9845,6 +9852,80 @@ var PaymentManager = class {
 };
 var paymentManager = new PaymentManager();
 
+// src/core/descriptor.ts
+function mapCategoryToDescriptorType(category, paymentMethod) {
+  const cat = (category || "").toLowerCase();
+  const method = (paymentMethod || "").toLowerCase();
+  const isVa = cat === "virtual account" || method.includes("_va");
+  const isQr = cat === "qris" || method === "qris";
+  const isEwallet = cat === "e-wallet" || cat === "ewallet" || method === "ewallet";
+  const isRetail = cat === "retail / gerai" || cat === "cstore" || method === "cstore";
+  const isCard = cat === "kartu kredit" || cat === "cc";
+  const isPaylater = cat === "paylater / cicilan" || cat === "paylater" || method === "paylater";
+  if (isQr) return "qris";
+  if (isVa) return "va";
+  if (isEwallet) return "ewallet";
+  if (isRetail) return "retail";
+  if (isCard) return "card";
+  if (isPaylater) return "paylater";
+  return "other";
+}
+function iconForType(type) {
+  switch (type) {
+    case "qris":
+    case "ewallet":
+      return "\u{1F4F1}";
+    case "va":
+      return "\u{1F3E6}";
+    case "retail":
+      return "\u{1F3EA}";
+    case "card":
+    case "paylater":
+    default:
+      return "\u{1F4B3}";
+  }
+}
+function badgeForType(type) {
+  switch (type) {
+    case "qris":
+      return "Instan Bebas Biaya";
+    case "va":
+      return "Otomatis 24 Jam";
+    case "ewallet":
+      return "E-Wallet Instan";
+    case "retail":
+      return "Gerai Retail";
+    case "card":
+      return "Visa / Mastercard";
+    case "paylater":
+      return "Cicilan PayLater";
+    default:
+      return "Tersedia Otomatis";
+  }
+}
+function buildPaymentMethodDescriptor(pm, _providerName) {
+  const category = pm.category || "";
+  const code = (pm.code || pm.paymentMethod || "").toUpperCase();
+  const type = mapCategoryToDescriptorType(category, pm.paymentMethod);
+  const icon = iconForType(type);
+  let badge = badgeForType(type);
+  const feeDisplay = pm.totalFee && pm.totalFee !== "-" ? pm.totalFee : "";
+  return {
+    id: code,
+    name: pm.paymentName,
+    type,
+    icon,
+    badge: feeDisplay ? `${badge} \u2022 Fee ${feeDisplay}` : badge,
+    image: pm.paymentImage || void 0,
+    category,
+    coming_soon: false,
+    totalFee: feeDisplay || void 0
+  };
+}
+function buildPaymentMethodDescriptors(methods, providerName) {
+  return methods.map((pm) => buildPaymentMethodDescriptor(pm, providerName));
+}
+
 // src/core/providerRegistry.ts
 var ProviderRegistry = class {
   descriptors = /* @__PURE__ */ new Map();
@@ -10306,6 +10387,33 @@ var Buayar = class {
     const providerName = configOverride?.provider || this.provider;
     return this.manager.getPaymentMethods(providerName, params || { amount: 1e4 }, mergedConfig);
   }
+  /**
+   * Ambil daftar channel pembayaran aktif dalam bentuk deskriptor kanonikal
+   * siap-render (id, name, type, icon, badge, image, category, totalFee).
+   * Wrapper di atas {@link Buayar.getPaymentMethods} + `buildPaymentMethodDescriptors`,
+   * sehingga konsumen UI/snapshot tidak perlu melakukan mapping ulang per provider.
+   */
+  async getPaymentMethodDescriptors(params, configOverride) {
+    const mergedConfig = { ...this.config, ...configOverride };
+    const providerName = configOverride?.provider || this.provider;
+    const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const res = await this.manager.getPaymentMethods(providerName, params || { amount: 1e4 }, mergedConfig);
+    if (!res.success) {
+      return {
+        success: false,
+        provider: providerName,
+        descriptors: [],
+        error: res.error || "Failed to fetch payment methods",
+        generatedAt
+      };
+    }
+    return {
+      success: true,
+      provider: providerName,
+      descriptors: buildPaymentMethodDescriptors(res.methods, providerName),
+      generatedAt
+    };
+  }
   /**
    * Cek status transaksi pembayaran berdasarkan Order ID
    */
@@ -10525,6 +10633,8 @@ var buayar = new Buayar();
   buildCoreChargePayload,
   buildDefaultDescriptors,
   buildIpaymuCallbackString,
+  buildPaymentMethodDescriptor,
+  buildPaymentMethodDescriptors,
   buildPaypalBasicAuth,
   buildPayuBasicAuth,
   buildRazorpayBasicAuth,
@@ -10545,6 +10655,7 @@ var buayar = new Buayar();
   getPaymentMethodCategory,
   getXenditAuthHeader,
   hmacSha256,
+  mapCategoryToDescriptorType,
   md5,
   minifyJson,
   normalizeIpaymuCallback,

package/dist/index.mjs

@@ -1863,6 +1863,10 @@ var IpaymuProvider = class extends BasePaymentProvider {
                 feeDetail: ch.TransactionFee
               }
             };
+            const health = String(ch.HealthStatus || "").toLowerCase();
+            const feature = String(ch.FeatureStatus || "").toLowerCase();
+            const explicitlyUnavailable = feature !== "" && feature !== "active" || health !== "" && health !== "online";
+            if (explicitlyUnavailable) continue;
             methods.push(pm);
             if (!categories[category]) categories[category] = [];
             categories[category].push(pm);
@@ -9678,6 +9682,80 @@ var PaymentManager = class {
 };
 var paymentManager = new PaymentManager();
 
+// src/core/descriptor.ts
+function mapCategoryToDescriptorType(category, paymentMethod) {
+  const cat = (category || "").toLowerCase();
+  const method = (paymentMethod || "").toLowerCase();
+  const isVa = cat === "virtual account" || method.includes("_va");
+  const isQr = cat === "qris" || method === "qris";
+  const isEwallet = cat === "e-wallet" || cat === "ewallet" || method === "ewallet";
+  const isRetail = cat === "retail / gerai" || cat === "cstore" || method === "cstore";
+  const isCard = cat === "kartu kredit" || cat === "cc";
+  const isPaylater = cat === "paylater / cicilan" || cat === "paylater" || method === "paylater";
+  if (isQr) return "qris";
+  if (isVa) return "va";
+  if (isEwallet) return "ewallet";
+  if (isRetail) return "retail";
+  if (isCard) return "card";
+  if (isPaylater) return "paylater";
+  return "other";
+}
+function iconForType(type) {
+  switch (type) {
+    case "qris":
+    case "ewallet":
+      return "\u{1F4F1}";
+    case "va":
+      return "\u{1F3E6}";
+    case "retail":
+      return "\u{1F3EA}";
+    case "card":
+    case "paylater":
+    default:
+      return "\u{1F4B3}";
+  }
+}
+function badgeForType(type) {
+  switch (type) {
+    case "qris":
+      return "Instan Bebas Biaya";
+    case "va":
+      return "Otomatis 24 Jam";
+    case "ewallet":
+      return "E-Wallet Instan";
+    case "retail":
+      return "Gerai Retail";
+    case "card":
+      return "Visa / Mastercard";
+    case "paylater":
+      return "Cicilan PayLater";
+    default:
+      return "Tersedia Otomatis";
+  }
+}
+function buildPaymentMethodDescriptor(pm, _providerName) {
+  const category = pm.category || "";
+  const code = (pm.code || pm.paymentMethod || "").toUpperCase();
+  const type = mapCategoryToDescriptorType(category, pm.paymentMethod);
+  const icon = iconForType(type);
+  let badge = badgeForType(type);
+  const feeDisplay = pm.totalFee && pm.totalFee !== "-" ? pm.totalFee : "";
+  return {
+    id: code,
+    name: pm.paymentName,
+    type,
+    icon,
+    badge: feeDisplay ? `${badge} \u2022 Fee ${feeDisplay}` : badge,
+    image: pm.paymentImage || void 0,
+    category,
+    coming_soon: false,
+    totalFee: feeDisplay || void 0
+  };
+}
+function buildPaymentMethodDescriptors(methods, providerName) {
+  return methods.map((pm) => buildPaymentMethodDescriptor(pm, providerName));
+}
+
 // src/core/providerRegistry.ts
 var ProviderRegistry = class {
   descriptors = /* @__PURE__ */ new Map();
@@ -10139,6 +10217,33 @@ var Buayar = class {
     const providerName = configOverride?.provider || this.provider;
     return this.manager.getPaymentMethods(providerName, params || { amount: 1e4 }, mergedConfig);
   }
+  /**
+   * Ambil daftar channel pembayaran aktif dalam bentuk deskriptor kanonikal
+   * siap-render (id, name, type, icon, badge, image, category, totalFee).
+   * Wrapper di atas {@link Buayar.getPaymentMethods} + `buildPaymentMethodDescriptors`,
+   * sehingga konsumen UI/snapshot tidak perlu melakukan mapping ulang per provider.
+   */
+  async getPaymentMethodDescriptors(params, configOverride) {
+    const mergedConfig = { ...this.config, ...configOverride };
+    const providerName = configOverride?.provider || this.provider;
+    const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const res = await this.manager.getPaymentMethods(providerName, params || { amount: 1e4 }, mergedConfig);
+    if (!res.success) {
+      return {
+        success: false,
+        provider: providerName,
+        descriptors: [],
+        error: res.error || "Failed to fetch payment methods",
+        generatedAt
+      };
+    }
+    return {
+      success: true,
+      provider: providerName,
+      descriptors: buildPaymentMethodDescriptors(res.methods, providerName),
+      generatedAt
+    };
+  }
   /**
    * Cek status transaksi pembayaran berdasarkan Order ID
    */
@@ -10357,6 +10462,8 @@ export {
   buildCoreChargePayload,
   buildDefaultDescriptors,
   buildIpaymuCallbackString,
+  buildPaymentMethodDescriptor,
+  buildPaymentMethodDescriptors,
   buildPaypalBasicAuth,
   buildPayuBasicAuth,
   buildRazorpayBasicAuth,
@@ -10377,6 +10484,7 @@ export {
   getPaymentMethodCategory,
   getXenditAuthHeader,
   hmacSha256,
+  mapCategoryToDescriptorType,
   md5,
   minifyJson,
   normalizeIpaymuCallback,

package/docs/ipaymu.md

@@ -80,6 +80,43 @@ if (result.success) {
 }
 ```
 
+> **Automatis filter availability:** Buayar hanya mengembalikan saluran yang benar-benar
+> tersedia — saluran dengan `FeatureStatus` selain `"active"` (mis. `inactive`, `disabled`, `suspended`)
+> atau `HealthStatus` selain `"online"` (mis. `offline`, `maintenance`) **otomatis dibuang** dari daftar.
+> Jadi metode yang muncul selalu berasal dari data real-time iPaymu, bukan asumsi.
+
+### 3a. Deskriptor Kanonikal Siap-Render (`getPaymentMethodDescriptors`)
+
+Untuk konsumen UI/snapshot yang butuh bentuk seragam tanpa mapping manual per provider, gunakan `getPaymentMethodDescriptors()`:
+
+```typescript
+const snap = await buayar.getPaymentMethodDescriptors({ amount: 100000 });
+
+if (snap.success) {
+  console.log("Provider:", snap.provider);
+  console.log("Dibuat pada:", snap.generatedAt);
+  console.log("Total:", snap.descriptors.length);
+
+  // Contoh: siap disimpan sebagai JSON flipbook oleh frontend
+  console.log(snap.descriptors[0]);
+  /*
+  {
+    id: "BCA_VA",
+    name: "Virtual Account BCA",
+    type: "va",
+    icon: "🏦",
+    badge: "Otomatis 24 Jam • Fee 0.7%",
+    image: "https://my.ipaymu.com/images/banks/bca.png",
+    category: "Virtual Account",
+    coming_soon: false,
+    totalFee: "0.7%"
+  }
+  */
+}
+```
+
+`type` adalah salah satu dari `qris | va | ewallet | retail | card | paylater | other`, siap dipakai untuk ikon/badge. Mapping kategori → tipe dilakukan sentral di `buildPaymentMethodDescriptors()` (ekspor dari `core/descriptor`), jadi semua konsumen mendapat hasil identik.
+
 ---
 
 ## 4. Pembuatan Tagihan (Invoice)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crediblemark/buayar",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "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",