@crediblemark/buayar 0.6.2 → 0.8.0

package/dist/index.d.mts

@@ -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;
@@ -33,7 +59,7 @@ interface MandiriBillInfo {
 }
 interface InvoiceResponse {
     success: boolean;
-    /** Provider yang memproses invoice ini ('midtrans' | 'duitku') */
+    /** Provider yang memproses invoice ini ('midtrans' | 'duitku' | 'doku' ...) */
     provider?: string;
     /** Order ID unik dari merchant */
     orderId?: string;
@@ -43,6 +69,8 @@ interface InvoiceResponse {
     paymentUrl?: string;
     /** Reference number dari Payment Gateway */
     reference?: string;
+    /** Dimensi hasil kanal spesifik (VA / QRIS / e-Wallet / Checkout) untuk typing strict. */
+    mode?: PaymentMode;
     /** Nomor Virtual Account (untuk metode Bank Transfer / VA) */
     vaNumber?: string;
     /** Nama Bank dari Virtual Account (misal: "bca", "bni", "bri", "mandiri", "permata") */
@@ -59,11 +87,32 @@ interface InvoiceResponse {
     billInfo?: MandiriBillInfo;
     /** Waktu kedaluwarsa tagihan pembayaran */
     expiresAt?: Date | string;
-    /** Raw response asli dari API provider */
+    /** Raw response asli dari API provider (termasuk saat gagal) */
     rawResponse: any;
     /** Pesan error jika gagal */
     error?: string;
 }
+/** Kanal pembayaran hasil invoice — membantu typing strict dan rendering UI. */
+type PaymentMode = "checkout" | "va" | "qris" | "ewallet" | "retail" | "other";
+/** Hasil invoice khusus Virtual Account (mode === 'va'). */
+interface VirtualAccountResponse extends InvoiceResponse {
+    mode: "va";
+    vaNumber: string;
+    vaBank?: string;
+}
+/** Hasil invoice khusus QRIS (mode === 'qris'). */
+interface QrisResponse extends InvoiceResponse {
+    mode: "qris";
+    qrString: string;
+    qrCodeUrl?: string;
+}
+/** Hasil invoice khusus e-Wallet (mode === 'ewallet'). */
+interface EWalletResponse extends InvoiceResponse {
+    mode: "ewallet";
+    checkoutUrl?: string;
+    paymentUrl?: string;
+    deeplink?: string;
+}
 interface VerifyCallbackResult {
     isValid: boolean;
     provider?: string;
@@ -136,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;
@@ -605,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 {
@@ -1026,10 +1124,52 @@ declare class PaymentManager {
 }
 declare const paymentManager: PaymentManager;
 
+interface ProviderCapability {
+    /** Metode pembayaran kanonik yang didukung provider ini */
+    methods: string[];
+    /** Operasi lanjutan yang didukung */
+    operations: {
+        refund: boolean;
+        checkBalance: boolean;
+        disburse: boolean;
+    };
+}
+interface ProviderDescriptor extends ProviderCapability {
+    name: string;
+    /** Kunci env kredensial yang menandakan provider ini aktif (untuk autodetect) */
+    envKeys: string[];
+}
 /**
- * Resolver konfigurasi kredensial otomatis dari Environment Variables.
- * Mendukung variabel universal Buayar / PG serta variabel spesifik masing-masing provider.
- */
+ * Pendeteksi / registrar provider dinamis.
+ * Metadata provider terpusat di sini sehingga:
+ *  - Daftar provider bisa ditambah tanpa ubah core (register(...)).
+ *  - Provider aktif bisa di-autodetect dari kredensial .env.
+ *  - Provider pengirim webhook bisa ditebak dari struktur payload.
+ *  - Capability (metode + operasi) bisa di-query secara runtime.
+ */
+declare class ProviderRegistry {
+    private descriptors;
+    constructor(initial?: ProviderDescriptor[]);
+    register(desc: ProviderDescriptor): void;
+    unregister(name: string): boolean;
+    has(name: string): boolean;
+    get(name: string): ProviderDescriptor | undefined;
+    names(): string[];
+    /**
+     * Autodetect provider aktif dari variabel lingkungan.
+     * Mengembalikan nama provider yang kredensial .env-nya terisi penuh,
+     * atau undefined jika tidak ada / ambigu.
+     */
+    detectFromEnv(env: Record<string, string | undefined>): string | undefined;
+    /**
+     * Autodetect provider dari struktur payload webhook.
+     * Mengembalikan nama provider jika dikenali, else undefined.
+     */
+    detectFromWebhook(payload: any): string | undefined;
+}
+declare function buildDefaultDescriptors(): ProviderDescriptor[];
+declare const providerRegistry: ProviderRegistry;
+
 declare function resolveConfigFromEnv(customConfig?: BuayarConfig): BuayarConfig;
 
 /**
@@ -1045,7 +1185,8 @@ declare function resolveConfigFromEnv(customConfig?: BuayarConfig): BuayarConfig
 declare class Buayar {
     private manager;
     private config;
-    constructor(config?: BuayarConfig, manager?: PaymentManager);
+    private registry;
+    constructor(config?: BuayarConfig, manager?: PaymentManager, registry?: ProviderRegistry);
     /**
      * Dapatkan salinan konfigurasi aktif saat ini
      */
@@ -1066,6 +1207,40 @@ declare class Buayar {
      * Ambil instance provider kelas dasar
      */
     getProvider(name?: string): BasePaymentProvider;
+    /**
+     * Daftar nama provider yang terdaftar (bawaan + kustom).
+     */
+    listProviders(): string[];
+    /**
+     * Registrasi metadata provider kustom untuk deteksi & capability.
+     * Contoh: buayar.registerProviderDescriptor({ name, envKeys, methods, operations })
+     */
+    registerProviderDescriptor(desc: ProviderDescriptor): void;
+    /**
+     * Cek capability (metode + operasi) provider tertentu — atau provider aktif bila kosong.
+     * Jawab pertanyaan "provider ini dukung apa?" secara runtime, tanpa bongkar dokumen.
+     */
+    getCapabilities(name?: string): ProviderCapability | undefined;
+    /**
+     * Deteksi nama provider dari struktur payload webhook.
+     */
+    detectProviderFromPayload(payload: any): string | undefined;
+    /**
+     * Deteksi nama provider aktif dari variabel lingkungan (kredensial yang terisi).
+     */
+    detectProviderFromEnv(env?: Record<string, string | undefined>): string | undefined;
+    /**
+     * Logika "bisa pakai X dengan provider Y?" — helper untuk portabilitas.
+     */
+    supports(name: string, operation: "refund" | "checkBalance" | "disburse"): boolean;
+    /**
+     * Daftar metode pembayaran yang benar2 tersedia untuk provider aktif.
+     */
+    getSupportedMethods(name?: string): string[];
+    /**
+     * Iterasi CEPAT: apakah provider aktif mendukung method kanonik tertentu?
+     */
+    supportsMethod(method: string, name?: string): boolean;
     /**
      * Buat transaksi pembayaran baru (Mendukung Semi dan Full Integrasi)
      */
@@ -1391,6 +1566,11 @@ declare function snapExternalId(prefix?: string): string;
  * @returns true when the X-SIGNATURE matches.
  */
 declare function verifySnapWebhookSignature(headers: Record<string, string | string[] | undefined>, body: any, clientSecret: string, endpointUrl?: string): boolean;
+/**
+ * Map a DOKU SNAP error (responseMessage/responseCode) to an actionable hint
+ * for developers, so config gaps (missing BIN / merchantId / keys) are obvious.
+ */
+declare function snapErrorHint(message: string, code?: string): string | undefined;
 
 /**
  * Generate signature PrismaLink
@@ -1585,6 +1765,21 @@ declare class SnapClient {
         extraHeaders?: Record<string, string>;
     }): Promise<any>;
 }
+/** DOKU SNAP API error with structured diagnostics (status code + raw response). */
+declare class SnapApiError extends Error {
+    readonly status: number;
+    readonly responseCode?: string;
+    readonly raw: any;
+    readonly endpoint?: string;
+    readonly method?: string;
+    constructor(message: string, opts: {
+        status: number;
+        code?: string;
+        raw?: any;
+        endpoint?: string;
+        method?: string;
+    });
+}
 
 /**
  * Generate MD5 hash string (lowercase)
@@ -1615,4 +1810,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, 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, PaypalClient, PaypalProvider, PayuClient, PayuProvider, PrismalinkClient, PrismalinkProvider, type ProviderConfig, RazorpayClient, RazorpayProvider, type RefundParams, type RefundResult, SnapClient, type SnapClientOptions, SquareClient, SquareProvider, StripeClient, StripeProvider, TwoCheckoutClient, TwoCheckoutProvider, type VerifyCallbackResult, XenditClient, type XenditDisbursementParams, XenditProvider, buayar, buildBraintreeBasicAuth, buildCoreChargePayload, buildPaypalBasicAuth, buildPayuBasicAuth, buildRazorpayBasicAuth, buildTwoCheckoutAuth, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, generateSnapAsymmetricSignature, generateSnapSymmetricSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, md5, minifyJson, parseCoreChargeResponse, paymentManager, resolveConfigFromEnv, safeCompare, serializePaypalParams, serializeStripeParams, sha256, sha256Hex, sha512, snapExternalId, snapTimestamp, snapUtcTimestamp, toCanonicalPaymentMethod, toDokuPaymentMethod, toDuitkuPaymentMethod, toFaspayPaymentMethod, toFinpayPaymentMethod, toIpaymuPaymentMethod, toNicepayPaymentMethod, toOyPaymentMethod, toPrismalinkPaymentMethod, toStripePaymentMethod, toXenditPaymentMethod, verifyAdyenWebhook, verifyBraintreeWebhook, verifyCheckoutComWebhook, verifyDokuWebhookSignature, verifyDuitkuCallbackSignature, verifyFaspaySignature, verifyFinpaySignature, verifyIpaymuCallback, 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 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, buildPaypalBasicAuth, buildPayuBasicAuth, buildRazorpayBasicAuth, buildTwoCheckoutAuth, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, generateSnapAsymmetricSignature, generateSnapSymmetricSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, md5, minifyJson, 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, verifyNicepayWebhook, verifyOyWebhook, verifyPaypalWebhookSimple, verifyPayuWebhook, verifyPrismalinkSignature, verifyRazorpayWebhook, verifySnapWebhookSignature, verifySquareWebhook, verifyStripeWebhook, verifyTwoCheckoutWebhook, verifyXenditWebhookToken };

package/dist/index.d.ts

@@ -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;
@@ -33,7 +59,7 @@ interface MandiriBillInfo {
 }
 interface InvoiceResponse {
     success: boolean;
-    /** Provider yang memproses invoice ini ('midtrans' | 'duitku') */
+    /** Provider yang memproses invoice ini ('midtrans' | 'duitku' | 'doku' ...) */
     provider?: string;
     /** Order ID unik dari merchant */
     orderId?: string;
@@ -43,6 +69,8 @@ interface InvoiceResponse {
     paymentUrl?: string;
     /** Reference number dari Payment Gateway */
     reference?: string;
+    /** Dimensi hasil kanal spesifik (VA / QRIS / e-Wallet / Checkout) untuk typing strict. */
+    mode?: PaymentMode;
     /** Nomor Virtual Account (untuk metode Bank Transfer / VA) */
     vaNumber?: string;
     /** Nama Bank dari Virtual Account (misal: "bca", "bni", "bri", "mandiri", "permata") */
@@ -59,11 +87,32 @@ interface InvoiceResponse {
     billInfo?: MandiriBillInfo;
     /** Waktu kedaluwarsa tagihan pembayaran */
     expiresAt?: Date | string;
-    /** Raw response asli dari API provider */
+    /** Raw response asli dari API provider (termasuk saat gagal) */
     rawResponse: any;
     /** Pesan error jika gagal */
     error?: string;
 }
+/** Kanal pembayaran hasil invoice — membantu typing strict dan rendering UI. */
+type PaymentMode = "checkout" | "va" | "qris" | "ewallet" | "retail" | "other";
+/** Hasil invoice khusus Virtual Account (mode === 'va'). */
+interface VirtualAccountResponse extends InvoiceResponse {
+    mode: "va";
+    vaNumber: string;
+    vaBank?: string;
+}
+/** Hasil invoice khusus QRIS (mode === 'qris'). */
+interface QrisResponse extends InvoiceResponse {
+    mode: "qris";
+    qrString: string;
+    qrCodeUrl?: string;
+}
+/** Hasil invoice khusus e-Wallet (mode === 'ewallet'). */
+interface EWalletResponse extends InvoiceResponse {
+    mode: "ewallet";
+    checkoutUrl?: string;
+    paymentUrl?: string;
+    deeplink?: string;
+}
 interface VerifyCallbackResult {
     isValid: boolean;
     provider?: string;
@@ -136,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;
@@ -605,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 {
@@ -1026,10 +1124,52 @@ declare class PaymentManager {
 }
 declare const paymentManager: PaymentManager;
 
+interface ProviderCapability {
+    /** Metode pembayaran kanonik yang didukung provider ini */
+    methods: string[];
+    /** Operasi lanjutan yang didukung */
+    operations: {
+        refund: boolean;
+        checkBalance: boolean;
+        disburse: boolean;
+    };
+}
+interface ProviderDescriptor extends ProviderCapability {
+    name: string;
+    /** Kunci env kredensial yang menandakan provider ini aktif (untuk autodetect) */
+    envKeys: string[];
+}
 /**
- * Resolver konfigurasi kredensial otomatis dari Environment Variables.
- * Mendukung variabel universal Buayar / PG serta variabel spesifik masing-masing provider.
- */
+ * Pendeteksi / registrar provider dinamis.
+ * Metadata provider terpusat di sini sehingga:
+ *  - Daftar provider bisa ditambah tanpa ubah core (register(...)).
+ *  - Provider aktif bisa di-autodetect dari kredensial .env.
+ *  - Provider pengirim webhook bisa ditebak dari struktur payload.
+ *  - Capability (metode + operasi) bisa di-query secara runtime.
+ */
+declare class ProviderRegistry {
+    private descriptors;
+    constructor(initial?: ProviderDescriptor[]);
+    register(desc: ProviderDescriptor): void;
+    unregister(name: string): boolean;
+    has(name: string): boolean;
+    get(name: string): ProviderDescriptor | undefined;
+    names(): string[];
+    /**
+     * Autodetect provider aktif dari variabel lingkungan.
+     * Mengembalikan nama provider yang kredensial .env-nya terisi penuh,
+     * atau undefined jika tidak ada / ambigu.
+     */
+    detectFromEnv(env: Record<string, string | undefined>): string | undefined;
+    /**
+     * Autodetect provider dari struktur payload webhook.
+     * Mengembalikan nama provider jika dikenali, else undefined.
+     */
+    detectFromWebhook(payload: any): string | undefined;
+}
+declare function buildDefaultDescriptors(): ProviderDescriptor[];
+declare const providerRegistry: ProviderRegistry;
+
 declare function resolveConfigFromEnv(customConfig?: BuayarConfig): BuayarConfig;
 
 /**
@@ -1045,7 +1185,8 @@ declare function resolveConfigFromEnv(customConfig?: BuayarConfig): BuayarConfig
 declare class Buayar {
     private manager;
     private config;
-    constructor(config?: BuayarConfig, manager?: PaymentManager);
+    private registry;
+    constructor(config?: BuayarConfig, manager?: PaymentManager, registry?: ProviderRegistry);
     /**
      * Dapatkan salinan konfigurasi aktif saat ini
      */
@@ -1066,6 +1207,40 @@ declare class Buayar {
      * Ambil instance provider kelas dasar
      */
     getProvider(name?: string): BasePaymentProvider;
+    /**
+     * Daftar nama provider yang terdaftar (bawaan + kustom).
+     */
+    listProviders(): string[];
+    /**
+     * Registrasi metadata provider kustom untuk deteksi & capability.
+     * Contoh: buayar.registerProviderDescriptor({ name, envKeys, methods, operations })
+     */
+    registerProviderDescriptor(desc: ProviderDescriptor): void;
+    /**
+     * Cek capability (metode + operasi) provider tertentu — atau provider aktif bila kosong.
+     * Jawab pertanyaan "provider ini dukung apa?" secara runtime, tanpa bongkar dokumen.
+     */
+    getCapabilities(name?: string): ProviderCapability | undefined;
+    /**
+     * Deteksi nama provider dari struktur payload webhook.
+     */
+    detectProviderFromPayload(payload: any): string | undefined;
+    /**
+     * Deteksi nama provider aktif dari variabel lingkungan (kredensial yang terisi).
+     */
+    detectProviderFromEnv(env?: Record<string, string | undefined>): string | undefined;
+    /**
+     * Logika "bisa pakai X dengan provider Y?" — helper untuk portabilitas.
+     */
+    supports(name: string, operation: "refund" | "checkBalance" | "disburse"): boolean;
+    /**
+     * Daftar metode pembayaran yang benar2 tersedia untuk provider aktif.
+     */
+    getSupportedMethods(name?: string): string[];
+    /**
+     * Iterasi CEPAT: apakah provider aktif mendukung method kanonik tertentu?
+     */
+    supportsMethod(method: string, name?: string): boolean;
     /**
      * Buat transaksi pembayaran baru (Mendukung Semi dan Full Integrasi)
      */
@@ -1391,6 +1566,11 @@ declare function snapExternalId(prefix?: string): string;
  * @returns true when the X-SIGNATURE matches.
  */
 declare function verifySnapWebhookSignature(headers: Record<string, string | string[] | undefined>, body: any, clientSecret: string, endpointUrl?: string): boolean;
+/**
+ * Map a DOKU SNAP error (responseMessage/responseCode) to an actionable hint
+ * for developers, so config gaps (missing BIN / merchantId / keys) are obvious.
+ */
+declare function snapErrorHint(message: string, code?: string): string | undefined;
 
 /**
  * Generate signature PrismaLink
@@ -1585,6 +1765,21 @@ declare class SnapClient {
         extraHeaders?: Record<string, string>;
     }): Promise<any>;
 }
+/** DOKU SNAP API error with structured diagnostics (status code + raw response). */
+declare class SnapApiError extends Error {
+    readonly status: number;
+    readonly responseCode?: string;
+    readonly raw: any;
+    readonly endpoint?: string;
+    readonly method?: string;
+    constructor(message: string, opts: {
+        status: number;
+        code?: string;
+        raw?: any;
+        endpoint?: string;
+        method?: string;
+    });
+}
 
 /**
  * Generate MD5 hash string (lowercase)
@@ -1615,4 +1810,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, 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, PaypalClient, PaypalProvider, PayuClient, PayuProvider, PrismalinkClient, PrismalinkProvider, type ProviderConfig, RazorpayClient, RazorpayProvider, type RefundParams, type RefundResult, SnapClient, type SnapClientOptions, SquareClient, SquareProvider, StripeClient, StripeProvider, TwoCheckoutClient, TwoCheckoutProvider, type VerifyCallbackResult, XenditClient, type XenditDisbursementParams, XenditProvider, buayar, buildBraintreeBasicAuth, buildCoreChargePayload, buildPaypalBasicAuth, buildPayuBasicAuth, buildRazorpayBasicAuth, buildTwoCheckoutAuth, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, generateSnapAsymmetricSignature, generateSnapSymmetricSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, md5, minifyJson, parseCoreChargeResponse, paymentManager, resolveConfigFromEnv, safeCompare, serializePaypalParams, serializeStripeParams, sha256, sha256Hex, sha512, snapExternalId, snapTimestamp, snapUtcTimestamp, toCanonicalPaymentMethod, toDokuPaymentMethod, toDuitkuPaymentMethod, toFaspayPaymentMethod, toFinpayPaymentMethod, toIpaymuPaymentMethod, toNicepayPaymentMethod, toOyPaymentMethod, toPrismalinkPaymentMethod, toStripePaymentMethod, toXenditPaymentMethod, verifyAdyenWebhook, verifyBraintreeWebhook, verifyCheckoutComWebhook, verifyDokuWebhookSignature, verifyDuitkuCallbackSignature, verifyFaspaySignature, verifyFinpaySignature, verifyIpaymuCallback, 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 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, buildPaypalBasicAuth, buildPayuBasicAuth, buildRazorpayBasicAuth, buildTwoCheckoutAuth, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, generateSnapAsymmetricSignature, generateSnapSymmetricSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, md5, minifyJson, 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, verifyNicepayWebhook, verifyOyWebhook, verifyPaypalWebhookSimple, verifyPayuWebhook, verifyPrismalinkSignature, verifyRazorpayWebhook, verifySnapWebhookSignature, verifySquareWebhook, verifyStripeWebhook, verifyTwoCheckoutWebhook, verifyXenditWebhookToken };