@crediblemark/buayar 0.8.4 → 0.8.6

package/dist/cli/index.js

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

package/dist/index.d.mts

@@ -139,8 +139,12 @@ interface VerifyCallbackResult {
     transactionTime?: Date | string;
     /** Raw payload callback asli dari webhook */
     rawPayload: any;
+    /** Pesan error jika verifikasi callback gagal */
+    error?: string;
 }
 interface ProviderConfig {
+    /** Nama provider target (opsional, jika ingin override per panggilan fungsi) */
+    provider?: string;
     merchantCode?: string;
     apiKey?: string;
     sandbox?: boolean;
@@ -200,6 +204,8 @@ interface PaymentMethod {
     category: "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya" | string;
     code?: string;
     extra?: any;
+    /** Tandai channel sebagai coming soon / belum tersedia */
+    coming_soon?: boolean;
     feeDetail?: {
         flat: number;
         percent: number;
@@ -216,8 +222,47 @@ 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 */
+    /**
+     * ID transaksi untuk pengecekan status.
+     *
+     * **iPaymu:** Harus berisi `TransactionId` numerik dari response `createInvoice`
+     * (`invoice.reference`), BUKAN `orderId`/`order_number` merchant.
+     * Endpoint iPaymu `/api/v2/transaction` hanya menerima ID numerik milik iPaymu.
+     */
     merchantOrderId: string;
 }
 interface CheckTransactionResult {
@@ -386,6 +431,11 @@ declare class IpaymuProvider extends BasePaymentProvider {
     createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    probePaymentMethods(config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
     checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 
@@ -395,6 +445,11 @@ declare class XenditProvider extends BasePaymentProvider {
     createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    probePaymentMethods(config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
     checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 
@@ -1222,10 +1277,10 @@ declare class ProviderRegistry {
      */
     detectFromEnv(env: Record<string, string | undefined>): string | undefined;
     /**
-     * Autodetect provider dari struktur payload webhook.
+     * Autodetect provider dari struktur payload webhook dan header.
      * Mengembalikan nama provider jika dikenali, else undefined.
      */
-    detectFromWebhook(payload: any): string | undefined;
+    detectFromWebhook(payload: any, headers?: Record<string, any>): string | undefined;
 }
 declare function buildDefaultDescriptors(): ProviderDescriptor[];
 declare const providerRegistry: ProviderRegistry;
@@ -1282,9 +1337,9 @@ declare class Buayar {
      */
     getCapabilities(name?: string): ProviderCapability | undefined;
     /**
-     * Deteksi nama provider dari struktur payload webhook.
+     * Deteksi nama provider dari struktur payload webhook dan opsional headers.
      */
-    detectProviderFromPayload(payload: any): string | undefined;
+    detectProviderFromPayload(payload: any, headers?: Record<string, string | string[] | undefined>): string | undefined;
     /**
      * Deteksi nama provider aktif dari variabel lingkungan (kredensial yang terisi).
      */
@@ -1309,6 +1364,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
      */
@@ -1320,6 +1382,14 @@ declare class Buayar {
      */
     verifyWebhook(payload: any, headers?: Record<string, string | string[] | undefined>, configOverride?: Partial<ProviderConfig>): Promise<VerifyCallbackResult>;
     handleWebhook(payload: any, headers?: Record<string, string | string[] | undefined>, configOverride?: Partial<ProviderConfig>): Promise<VerifyCallbackResult>;
+    /**
+     * Probe payment methods yang benar-benar aktif di akun merchant gateway.
+     */
+    probePaymentMethods(configOverride?: Partial<ProviderConfig>): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
     /**
      * Unified Refund — berlaku untuk semua provider yang mendukung refund.
      * Provider tanpa fitur refund mengembalikan `{ supported: false }`, bukan error.
@@ -1489,6 +1559,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 +1983,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

@@ -139,8 +139,12 @@ interface VerifyCallbackResult {
     transactionTime?: Date | string;
     /** Raw payload callback asli dari webhook */
     rawPayload: any;
+    /** Pesan error jika verifikasi callback gagal */
+    error?: string;
 }
 interface ProviderConfig {
+    /** Nama provider target (opsional, jika ingin override per panggilan fungsi) */
+    provider?: string;
     merchantCode?: string;
     apiKey?: string;
     sandbox?: boolean;
@@ -200,6 +204,8 @@ interface PaymentMethod {
     category: "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya" | string;
     code?: string;
     extra?: any;
+    /** Tandai channel sebagai coming soon / belum tersedia */
+    coming_soon?: boolean;
     feeDetail?: {
         flat: number;
         percent: number;
@@ -216,8 +222,47 @@ 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 */
+    /**
+     * ID transaksi untuk pengecekan status.
+     *
+     * **iPaymu:** Harus berisi `TransactionId` numerik dari response `createInvoice`
+     * (`invoice.reference`), BUKAN `orderId`/`order_number` merchant.
+     * Endpoint iPaymu `/api/v2/transaction` hanya menerima ID numerik milik iPaymu.
+     */
     merchantOrderId: string;
 }
 interface CheckTransactionResult {
@@ -386,6 +431,11 @@ declare class IpaymuProvider extends BasePaymentProvider {
     createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    probePaymentMethods(config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
     checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 
@@ -395,6 +445,11 @@ declare class XenditProvider extends BasePaymentProvider {
     createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    probePaymentMethods(config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
     checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
 }
 
@@ -1222,10 +1277,10 @@ declare class ProviderRegistry {
      */
     detectFromEnv(env: Record<string, string | undefined>): string | undefined;
     /**
-     * Autodetect provider dari struktur payload webhook.
+     * Autodetect provider dari struktur payload webhook dan header.
      * Mengembalikan nama provider jika dikenali, else undefined.
      */
-    detectFromWebhook(payload: any): string | undefined;
+    detectFromWebhook(payload: any, headers?: Record<string, any>): string | undefined;
 }
 declare function buildDefaultDescriptors(): ProviderDescriptor[];
 declare const providerRegistry: ProviderRegistry;
@@ -1282,9 +1337,9 @@ declare class Buayar {
      */
     getCapabilities(name?: string): ProviderCapability | undefined;
     /**
-     * Deteksi nama provider dari struktur payload webhook.
+     * Deteksi nama provider dari struktur payload webhook dan opsional headers.
      */
-    detectProviderFromPayload(payload: any): string | undefined;
+    detectProviderFromPayload(payload: any, headers?: Record<string, string | string[] | undefined>): string | undefined;
     /**
      * Deteksi nama provider aktif dari variabel lingkungan (kredensial yang terisi).
      */
@@ -1309,6 +1364,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
      */
@@ -1320,6 +1382,14 @@ declare class Buayar {
      */
     verifyWebhook(payload: any, headers?: Record<string, string | string[] | undefined>, configOverride?: Partial<ProviderConfig>): Promise<VerifyCallbackResult>;
     handleWebhook(payload: any, headers?: Record<string, string | string[] | undefined>, configOverride?: Partial<ProviderConfig>): Promise<VerifyCallbackResult>;
+    /**
+     * Probe payment methods yang benar-benar aktif di akun merchant gateway.
+     */
+    probePaymentMethods(configOverride?: Partial<ProviderConfig>): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
     /**
      * Unified Refund — berlaku untuk semua provider yang mendukung refund.
      * Provider tanpa fitur refund mengembalikan `{ supported: false }`, bukan error.
@@ -1489,6 +1559,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 +1983,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 };