@crediblemark/buayar 0.1.10 → 0.2.0

package/dist/index.d.mts

@@ -1,81 +1,181 @@
+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;
+
+interface CustomerDetails {
+    name: string;
+    email: string;
+    phone?: string;
+}
 interface CreateInvoiceParams {
     orderId: string;
     amount: number;
     productDetails: string;
-    customer: {
-        name: string;
-        email: string;
-        phone?: string;
-    };
-    returnUrl: string;
-    callbackUrl: string;
-    /** Specific Duitku payment method code (e.g. "BCA", "I1", "OV"). If omitted, all methods are available via Duitku's redirect page. */
-    paymentMethod?: string;
-    /** Provider-specific parameters (e.g., token_id, billing details, custom headers/fields) */
+    customer: CustomerDetails;
+    returnUrl?: string;
+    callbackUrl?: string;
+    /**
+     * Payment method code.
+     * Mendukung Canonical Code (contoh: "bca_va", "mandiri_va", "qris", "gopay", "shopeepay", "alfamart", "indomaret")
+     * atau kode raw spesifik provider (contoh Duitku: "BC", "M2", "SP").
+     * Jika dikosongkan, akan beralih ke Mode Semi Integrasi (Redirect Checkout).
+     */
+    paymentMethod?: CanonicalPaymentMethod | string;
+    /** Parameter kustom tambahan untuk provider spesifik (opsional) */
     providerParams?: any;
 }
+interface MandiriBillInfo {
+    billerCode?: string;
+    billKey?: string;
+}
 interface InvoiceResponse {
     success: boolean;
+    /** Provider yang memproses invoice ini ('midtrans' | 'duitku') */
+    provider?: string;
+    /** Order ID unik dari merchant */
+    orderId?: string;
+    /** Nominal transaksi */
+    amount?: number;
+    /** URL Checkout / Redirect untuk mode Semi-Integrasi */
     paymentUrl?: string;
+    /** Reference number dari Payment Gateway */
     reference?: string;
-    /** Virtual Account number (for bank VA methods) */
+    /** Nomor Virtual Account (untuk metode Bank Transfer / VA) */
     vaNumber?: string;
-    /** QRIS string for display in a QR code */
+    /** Nama Bank dari Virtual Account (misal: "bca", "bni", "bri", "mandiri", "permata") */
+    vaBank?: string;
+    /** Raw EMVCo QRIS string standar nasional untuk dirender ke Canvas / SVG QR */
     qrString?: string;
-    /** Duitku-hosted QR code image URL */
+    /** URL Gambar QR Code langsung */
     qrCodeUrl?: string;
-    /** Generic payment code (for retail/minimarket methods like Indomaret) */
+    /** Kode pembayaran gerai retail (Indomaret / Alfamart) */
     paymentCode?: string;
+    /** Deep link URL untuk membuka langsung aplikasi e-wallet (GoPay, ShopeePay, DANA) di mobile */
+    deeplink?: string;
+    /** Informasi biller khusus Mandiri E-Channel */
+    billInfo?: MandiriBillInfo;
+    /** Waktu kedaluwarsa tagihan pembayaran */
+    expiresAt?: Date | string;
+    /** Raw response asli dari API provider */
     rawResponse: any;
+    /** Pesan error jika gagal */
     error?: string;
 }
 interface VerifyCallbackResult {
     isValid: boolean;
+    provider?: string;
     orderId: string;
     amount: number;
-    status: "paid" | "pending" | "failed";
+    /** Status transaksi terstandarisasi */
+    status: "paid" | "pending" | "failed" | "expired";
+    /** Boolean helper: bernilai true jika transaksi sukses terbayar */
+    isPaid: boolean;
+    /** Boolean helper: bernilai true jika transaksi masih menunggu pembayaran */
+    isPending: boolean;
+    /** Boolean helper: bernilai true jika transaksi gagal/dibatalkan */
+    isFailed: boolean;
+    /** Boolean helper: bernilai true jika transaksi telah kedaluwarsa */
+    isExpired: boolean;
+    /** Kode status asli dari provider */
+    statusCode?: string;
+    /** Waktu transaksi dicatat */
+    transactionTime?: Date | string;
+    /** Raw payload callback asli dari webhook */
     rawPayload: any;
 }
 interface ProviderConfig {
-    merchantCode: string;
-    apiKey: string;
-    sandbox: boolean;
+    merchantCode?: string;
+    apiKey?: string;
+    sandbox?: boolean;
+    clientKey?: string;
+    serverKey?: string;
+    merchantId?: string;
+    projectId?: string;
+    publicKey?: string;
+    privateKey?: string;
+    secretKey?: string;
+    customBaseUrl?: string;
+    callbackUrl?: string;
+    returnUrl?: string;
+    /** Wadah konfigurasi ekstra fleksibel untuk custom provider */
+    extra?: Record<string, any>;
+}
+interface BuayarConfig extends ProviderConfig {
+    /**
+     * Nama provider aktif.
+     * Contoh: "midtrans" | "duitku"
+     * Jika tidak diisi, otomatis membaca process.env.PAYMENT_PROVIDER atau process.env.BUAYAR_PROVIDER
+     */
+    provider?: string;
 }
 interface GetPaymentMethodsParams {
-    /** Transaction amount (integer, no decimal) */
-    amount: number;
+    /** Nominal transaksi (integer) untuk menghitung fee admin dinamis */
+    amount?: number;
+}
+interface PaymentMethodItem {
+    /** Kode canonical Buayar, contoh: "bca_va", "qris", "gopay" */
+    code: string;
+    /** Kode asli bawaan provider, contoh: "BC", "SP", "bank_transfer" */
+    providerCode: string;
+    /** Nama metode pembayaran yang ramah pengguna, contoh: "BCA Virtual Account" */
+    name: string;
+    /** URL logo icon metode pembayaran */
+    image: string;
+    /** Biaya admin transaksi */
+    fee: {
+        flat: number;
+        percent: number;
+        totalFee: number;
+    };
+    /** Minimum & Maksimum transaksi yang diperbolehkan */
+    minAmount?: number;
+    maxAmount?: number;
+    /** Status ketersediaan channel */
+    isOnline: boolean;
+    /** Kategori grup untuk Accordion UI */
+    category: "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
 }
 interface PaymentMethod {
-    /** Provider-specific method code, e.g. "BT", "I1", "OL" */
     paymentMethod: string;
-    /** Human-readable name, e.g. "BCA Virtual Account" */
     paymentName: string;
-    /** URL to payment method logo/image */
     paymentImage: string;
-    /** Total transaction fee in IDR (string from API) */
     totalFee: string;
-    /** Categorized payment channel (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";
+    code?: string;
+    feeDetail?: {
+        flat: number;
+        percent: number;
+        totalFee: number;
+    };
 }
 interface GetPaymentMethodsResult {
     success: boolean;
+    provider?: string;
+    /** Daftar seluruh channel metode pembayaran */
     methods: PaymentMethod[];
+    /** Pengelompokan channel per kategori yang sudah siap dirender sebagai Accordion UI */
+    categories?: Record<string, PaymentMethod[]>;
     error?: string;
     rawResponse: any;
 }
 interface CheckTransactionParams {
-    /** The merchant order ID used when creating the invoice */
+    /** Merchant order ID saat pembuatan transaksi */
     merchantOrderId: string;
 }
 interface CheckTransactionResult {
     success: boolean;
+    provider?: string;
     orderId: string;
     reference: string;
     amount: number;
     /** "00" = success/paid, "01" = pending, "02" = failed/expired */
     statusCode: string;
-    status: "paid" | "pending" | "failed";
+    status: "paid" | "pending" | "failed" | "expired";
+    isPaid: boolean;
+    isPending: boolean;
+    isFailed: boolean;
+    isExpired: boolean;
     statusMessage: string;
+    paymentType?: string;
+    transactionTime?: Date | string;
     error?: string;
     rawResponse: any;
 }
@@ -94,13 +194,28 @@ declare abstract class BasePaymentProvider {
     }>;
 }
 
+declare class DuitkuProvider extends BasePaymentProvider {
+    readonly name = "duitku";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+    probePaymentMethods(config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
+}
+
 declare class MidtransClient {
     private apiKey;
     private sandbox;
-    constructor(config: {
-        apiKey: string;
-        sandbox: boolean;
-    } | ProviderConfig);
+    constructor(config: ProviderConfig | {
+        apiKey?: string;
+        serverKey?: string;
+        sandbox?: boolean;
+    });
     private getApiBaseUrl;
     request(method: "GET" | "POST" | "PATCH" | "DELETE", path: string, body: any): Promise<any>;
     cancelTransaction(orderId: string): Promise<any>;
@@ -140,9 +255,6 @@ declare class MidtransProvider extends BasePaymentProvider {
     verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
     checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
-    /**
-     * Get an instance of MidtransClient to perform transaction actions, subscriptions, invoicing, etc.
-     */
     getClient(config: ProviderConfig): MidtransClient;
     probePaymentMethods(config: ProviderConfig): Promise<{
         success: boolean;
@@ -151,21 +263,370 @@ declare class MidtransProvider extends BasePaymentProvider {
     }>;
 }
 
-declare class DuitkuProvider extends BasePaymentProvider {
-    readonly name = "duitku";
+declare class IpaymuProvider extends BasePaymentProvider {
+    readonly name = "ipaymu";
     private getBaseUrl;
     createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
     checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
-    probePaymentMethods(config: ProviderConfig): Promise<{
+}
+
+declare class XenditProvider extends BasePaymentProvider {
+    readonly name = "xendit";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class DokuProvider extends BasePaymentProvider {
+    readonly name = "doku";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class PrismalinkProvider extends BasePaymentProvider {
+    readonly name = "prismalink";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class FaspayProvider extends BasePaymentProvider {
+    readonly name = "faspay";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class FinpayProvider extends BasePaymentProvider {
+    readonly name = "finpay";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class NicepayProvider extends BasePaymentProvider {
+    readonly name = "nicepay";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+declare class OyProvider extends BasePaymentProvider {
+    readonly name = "oy";
+    private getBaseUrl;
+    createInvoice(params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
+    verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
+    getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
+    checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+}
+
+interface DuitkuDisbursementParams {
+    bankCode: string;
+    bankAccount: string;
+    amount: number;
+    purpose: string;
+    merchantOrderId: string;
+    senderName?: string;
+    senderPhone?: string;
+    callbackUrl?: string;
+}
+declare class DuitkuClient {
+    private merchantCode;
+    private apiKey;
+    private sandbox;
+    constructor(config: ProviderConfig | {
+        merchantCode?: string;
+        apiKey?: string;
+        sandbox?: boolean;
+    });
+    private getPassportBaseUrl;
+    private getApiBaseUrl;
+    /**
+     * Request helper generic dengan kalkulasi signature Duitku otomatis
+     */
+    request(method: "GET" | "POST", endpoint: string, body?: any, options?: {
+        baseUrl?: "passport" | "api";
+        customHeaders?: Record<string, string>;
+    }): Promise<any>;
+    /**
+     * Cek status transaksi pembayaran berdasarkan merchant order ID
+     */
+    checkTransaction(merchantOrderId: string): Promise<any>;
+    /**
+     * Ambil daftar channel pembayaran aktif dan kalkulasi fee dinamis
+     */
+    getPaymentMethods(amount?: number): Promise<any>;
+    /**
+     * Cek saldo merchant (Balance Inquiry)
+     */
+    checkBalance(): Promise<{
         success: boolean;
-        enabled: string[];
+        balance?: number;
+        rawResponse: any;
         error?: string;
     }>;
+    /**
+     * Mengambil daftar bank yang didukung untuk transfer / penarikan dana
+     */
+    listBanks(): Promise<any>;
+    /**
+     * Validasi nama pemilik rekening bank sebelum eksekusi transfer (Bank Account Inquiry)
+     */
+    inquiryBankAccount(bankCode: string, bankAccount: string): Promise<any>;
+    /**
+     * Eksekusi transfer dana / payout (Disbursement Transfer)
+     */
+    disburse(params: DuitkuDisbursementParams): Promise<any>;
+    /**
+     * Cek status disbursement berdasarkan merchant order ID
+     */
+    checkDisbursementStatus(merchantOrderId: string): Promise<any>;
 }
 
-declare function getPaymentMethodCategory(code: string, name?: string): "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
+declare class IpaymuClient {
+    private va;
+    private apiKey;
+    private sandbox;
+    constructor(config: ProviderConfig | {
+        merchantCode?: string;
+        merchantId?: string;
+        apiKey?: string;
+        sandbox?: boolean;
+    });
+    private getBaseUrl;
+    /**
+     * Helper request bertanda tangan iPaymu v2
+     */
+    request(method: "GET" | "POST", endpoint: string, body?: any): Promise<any>;
+    /**
+     * Cek saldo merchant iPaymu
+     */
+    checkBalance(): Promise<{
+        success: boolean;
+        balance?: number;
+        rawResponse: any;
+        error?: string;
+    }>;
+    /**
+     * Cek detail transaksi iPaymu
+     */
+    checkTransaction(transactionId: string): Promise<any>;
+}
+
+interface XenditDisbursementParams {
+    externalId: string;
+    bankCode: string;
+    accountHolderName: string;
+    accountNumber: string;
+    description: string;
+    amount: number;
+}
+declare class XenditClient {
+    private apiKey;
+    constructor(config: ProviderConfig | {
+        apiKey?: string;
+        secretKey?: string;
+    });
+    private getBaseUrl;
+    /**
+     * HTTP Request helper bertanda tangan Basic Auth Xendit
+     */
+    request(method: "GET" | "POST" | "PATCH", endpoint: string, body?: any): Promise<any>;
+    /**
+     * Cek Saldo Merchant Xendit
+     */
+    checkBalance(accountType?: "CASH" | "HOLDING" | "TAX"): Promise<{
+        success: boolean;
+        balance?: number;
+        rawResponse: any;
+        error?: string;
+    }>;
+    /**
+     * Memaksa sebuah invoice kadaluwarsa (Expire Invoice)
+     */
+    expireInvoice(invoiceId: string): Promise<any>;
+    /**
+     * Eksekusi transfer dana / disbursement
+     */
+    createDisbursement(params: XenditDisbursementParams): Promise<any>;
+}
+
+declare class DokuClient {
+    private clientId;
+    private secretKey;
+    private sandbox;
+    constructor(config: ProviderConfig | {
+        merchantCode?: string;
+        clientId?: string;
+        apiKey?: string;
+        secretKey?: string;
+        sandbox?: boolean;
+    });
+    private getBaseUrl;
+    /**
+     * Helper request bertanda tangan DOKU Jokul v2
+     */
+    request(method: "GET" | "POST", endpoint: string, body?: any): Promise<any>;
+    /**
+     * Cek status transaksi pesanan di DOKU
+     */
+    checkTransaction(invoiceNumber: string): Promise<any>;
+}
+
+declare class PrismalinkClient {
+    private merchantId;
+    private secretKey;
+    private sandbox;
+    constructor(config: ProviderConfig | {
+        merchantCode?: string;
+        merchantId?: string;
+        apiKey?: string;
+        secretKey?: string;
+        sandbox?: boolean;
+    });
+    private getBaseUrl;
+    /**
+     * Helper HTTP Request ke API PrismaLink
+     */
+    request(method: "GET" | "POST", endpoint: string, body?: any): Promise<any>;
+    /**
+     * Cek status transaksi pesanan di PrismaLink
+     */
+    checkTransaction(orderId: string): Promise<any>;
+}
+
+declare class FaspayClient {
+    private merchantId;
+    private userId;
+    private password;
+    private sandbox;
+    constructor(config: ProviderConfig | {
+        merchantCode?: string;
+        merchantId?: string;
+        userId?: string;
+        clientKey?: string;
+        apiKey?: string;
+        password?: string;
+        sandbox?: boolean;
+    });
+    private getBaseUrl;
+    /**
+     * Helper HTTP Request ke endpoint Faspay
+     */
+    request(endpoint: string, payload: any): Promise<any>;
+    /**
+     * Cek status pembayaran tagihan Faspay
+     */
+    checkTransaction(billNo: string): Promise<any>;
+    /**
+     * Batalkan tagihan pembayaran Faspay
+     */
+    cancelTransaction(billNo: string, paymentChannel: string): Promise<any>;
+}
+
+declare class FinpayClient {
+    private merchantId;
+    private merchantKey;
+    private sandbox;
+    constructor(config: ProviderConfig | {
+        merchantCode?: string;
+        merchantId?: string;
+        apiKey?: string;
+        serverKey?: string;
+        secretKey?: string;
+        sandbox?: boolean;
+    });
+    private getBaseUrl;
+    /**
+     * Helper HTTP Request ke Finpay API
+     */
+    request(endpoint: string, payload: any): Promise<any>;
+    /**
+     * Cek status transaksi pembayaran Finpay
+     */
+    checkTransaction(orderId: string): Promise<any>;
+}
+
+declare class NicepayClient {
+    private iMid;
+    private merchantKey;
+    private sandbox;
+    constructor(config: ProviderConfig | {
+        merchantCode?: string;
+        merchantId?: string;
+        iMid?: string;
+        apiKey?: string;
+        serverKey?: string;
+        secretKey?: string;
+        sandbox?: boolean;
+    });
+    private getBaseUrl;
+    /**
+     * Helper HTTP Request ke Nicepay API
+     */
+    request(endpoint: string, payload: any): Promise<any>;
+    /**
+     * Cek status transaksi pembayaran di Nicepay
+     */
+    checkTransaction(referenceNo: string, amount?: number): Promise<any>;
+    /**
+     * Batalkan transaksi di Nicepay
+     */
+    cancelTransaction(tXid: string, payMethod: string, cancelMsg?: string): Promise<any>;
+}
+
+declare class OyClient {
+    private username;
+    private apiKey;
+    private sandbox;
+    constructor(config: ProviderConfig | {
+        merchantCode?: string;
+        username?: string;
+        clientKey?: string;
+        apiKey?: string;
+        serverKey?: string;
+        secretKey?: string;
+        sandbox?: boolean;
+    });
+    private getBaseUrl;
+    /**
+     * Helper HTTP Request ke OY! Bisnis API
+     */
+    request(method: "GET" | "POST", endpoint: string, body?: any): Promise<any>;
+    /**
+     * Cek status transaksi pembayaran
+     */
+    checkTransaction(partnerTxId: string): Promise<any>;
+    /**
+     * Cek saldo akun OY! Bisnis
+     */
+    checkBalance(): Promise<any>;
+    /**
+     * Kirim dana / Transfer uang (Disbursement / Remittance)
+     */
+    remit(params: {
+        recipientBank: string;
+        recipientAccount: string;
+        amount: number;
+        note?: string;
+        partnerTrxId: string;
+    }): Promise<any>;
+}
 
 declare class PaymentManager {
     private providers;
@@ -174,6 +635,24 @@ declare class PaymentManager {
     getProvider(name: string): BasePaymentProvider;
     getMidtransProvider(): MidtransProvider;
     getMidtransClient(config: ProviderConfig): MidtransClient;
+    getDuitkuProvider(): DuitkuProvider;
+    getDuitkuClient(config: ProviderConfig): DuitkuClient;
+    getIpaymuProvider(): IpaymuProvider;
+    getIpaymuClient(config: ProviderConfig): IpaymuClient;
+    getXenditProvider(): XenditProvider;
+    getXenditClient(config: ProviderConfig): XenditClient;
+    getDokuProvider(): DokuProvider;
+    getDokuClient(config: ProviderConfig): DokuClient;
+    getPrismalinkProvider(): PrismalinkProvider;
+    getPrismalinkClient(config: ProviderConfig): PrismalinkClient;
+    getFaspayProvider(): FaspayProvider;
+    getFaspayClient(config: ProviderConfig): FaspayClient;
+    getFinpayProvider(): FinpayProvider;
+    getFinpayClient(config: ProviderConfig): FinpayClient;
+    getNicepayProvider(): NicepayProvider;
+    getNicepayClient(config: ProviderConfig): NicepayClient;
+    getOyProvider(): OyProvider;
+    getOyClient(config: ProviderConfig): OyClient;
     createInvoice(providerName: string, params: CreateInvoiceParams, config: ProviderConfig): Promise<InvoiceResponse>;
     verifyCallback(providerName: string, body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     getPaymentMethods(providerName: string, params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
@@ -186,4 +665,344 @@ declare class PaymentManager {
 }
 declare const paymentManager: PaymentManager;
 
-export { BasePaymentProvider, type CheckTransactionParams, type CheckTransactionResult, type CreateInvoiceParams, DuitkuProvider, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, MidtransClient, MidtransProvider, PaymentManager, type PaymentMethod, type ProviderConfig, type VerifyCallbackResult, getPaymentMethodCategory, paymentManager };
+/**
+ * Resolver konfigurasi kredensial otomatis dari Environment Variables.
+ * Mendukung variabel universal Buayar / PG serta variabel spesifik masing-masing provider.
+ */
+declare function resolveConfigFromEnv(customConfig?: BuayarConfig): BuayarConfig;
+
+/**
+ * Buayar - Unified Payment Gateway Client
+ *
+ * Antarmuka tingkat tinggi untuk membuat transaksi, query channel pembayaran,
+ * pengecekan status, dan verifikasi webhook universal tanpa perlu rombak kode.
+ */
+declare class Buayar {
+    private manager;
+    private config;
+    constructor(config?: BuayarConfig, manager?: PaymentManager);
+    /**
+     * Dapatkan salinan konfigurasi aktif saat ini
+     */
+    getConfig(): BuayarConfig;
+    /**
+     * Perbarui konfigurasi saat runtime
+     */
+    setConfig(config: Partial<BuayarConfig>): void;
+    /**
+     * Dapatkan nama provider aktif ('midtrans' | 'duitku' | 'ipaymu' | 'xendit' | 'doku' | 'prismalink' | 'faspay' | 'finpay' | 'nicepay' | 'oy' | ...)
+     */
+    get provider(): string;
+    /**
+     * Registrasi provider custom ke dalam PaymentManager
+     */
+    registerProvider(provider: BasePaymentProvider): void;
+    /**
+     * Ambil instance provider kelas dasar
+     */
+    getProvider(name?: string): BasePaymentProvider;
+    /**
+     * Buat transaksi pembayaran baru (Mendukung Semi dan Full Integrasi)
+     */
+    createInvoice(params: CreateInvoiceParams, configOverride?: Partial<ProviderConfig>): Promise<InvoiceResponse>;
+    /**
+     * Ambil daftar channel pembayaran aktif (Accordion-Ready)
+     */
+    getPaymentMethods(params?: GetPaymentMethodsParams, configOverride?: Partial<ProviderConfig>): Promise<GetPaymentMethodsResult>;
+    /**
+     * Cek status transaksi pembayaran berdasarkan Order ID
+     */
+    checkTransaction(params: CheckTransactionParams, configOverride?: Partial<ProviderConfig>): Promise<CheckTransactionResult>;
+    /**
+     * Universal Webhook Handler
+     *
+     * Memverifikasi keabsahan signature notifikasi pembayaran masuk dan menormalisasi payload menjadi format seragam.
+     */
+    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>;
+    getMidtransClient(configOverride?: Partial<ProviderConfig>): MidtransClient;
+    getDuitkuClient(configOverride?: Partial<ProviderConfig>): DuitkuClient;
+    getIpaymuClient(configOverride?: Partial<ProviderConfig>): IpaymuClient;
+    getXenditClient(configOverride?: Partial<ProviderConfig>): XenditClient;
+    getDokuClient(configOverride?: Partial<ProviderConfig>): DokuClient;
+    getPrismalinkClient(configOverride?: Partial<ProviderConfig>): PrismalinkClient;
+    getFaspayClient(configOverride?: Partial<ProviderConfig>): FaspayClient;
+    getFinpayClient(configOverride?: Partial<ProviderConfig>): FinpayClient;
+    getNicepayClient(configOverride?: Partial<ProviderConfig>): NicepayClient;
+    getOyClient(configOverride?: Partial<ProviderConfig>): OyClient;
+}
+declare const buayar: Buayar;
+
+/**
+ * Mapping dari Canonical Payment Method ke kode internal Duitku
+ */
+declare const CANONICAL_TO_DUITKU: Record<string, string>;
+/**
+ * Mapping dari kode internal Duitku ke Canonical Payment Method
+ */
+declare const DUITKU_TO_CANONICAL: Record<string, string>;
+/**
+ * Mapping dari Canonical Payment Method ke parameter charge Midtrans Core API
+ */
+declare const CANONICAL_TO_MIDTRANS: Record<string, {
+    payment_type: string;
+    bank?: string;
+}>;
+/**
+ * Mapping dari Canonical Payment Method ke parameter direct iPaymu
+ */
+declare const CANONICAL_TO_IPAYMU: Record<string, {
+    paymentMethod: string;
+    paymentChannel: string;
+}>;
+/**
+ * Mapping dari Canonical Payment Method ke parameter Payment Requests API Xendit
+ */
+declare const CANONICAL_TO_XENDIT: Record<string, {
+    type: string;
+    channel_code?: string;
+}>;
+/**
+ * Mapping dari Canonical Payment Method ke endpoint Direct DOKU Jokul
+ */
+declare const CANONICAL_TO_DOKU: Record<string, {
+    endpoint: string;
+    type: "va" | "qris" | "cstore" | "ewallet";
+    bank?: string;
+}>;
+/**
+ * Mapping dari Canonical Payment Method ke kode channel PrismaLink
+ */
+declare const CANONICAL_TO_PRISMALINK: Record<string, string>;
+/**
+ * Mapping dari Canonical Payment Method ke kode channel Faspay
+ */
+declare const CANONICAL_TO_FASPAY: Record<string, string>;
+/**
+ * Mapping dari Canonical Payment Method ke kode channel Finpay
+ */
+declare const CANONICAL_TO_FINPAY: Record<string, string>;
+/**
+ * Mapping dari Canonical Payment Method ke konfigurasi Nicepay
+ */
+declare const CANONICAL_TO_NICEPAY: Record<string, {
+    payMethod: string;
+    bankCd?: string;
+    mitraCd?: string;
+}>;
+/**
+ * Mapping dari Canonical Payment Method ke konfigurasi OY! Bisnis
+ */
+declare const CANONICAL_TO_OY: Record<string, {
+    type: "va" | "qris" | "ewallet" | "cstore";
+    bank_code?: string;
+    channel?: string;
+}>;
+/**
+ * Ubah method code apapun (baik canonical maupun kode raw provider) ke kode Duitku yang valid
+ */
+declare function toDuitkuPaymentMethod(code?: string): string | undefined;
+/**
+ * Ubah method code apapun ke format iPaymu direct channel
+ */
+declare function toIpaymuPaymentMethod(code?: string): {
+    paymentMethod: string;
+    paymentChannel?: string;
+} | undefined;
+/**
+ * Ubah method code apapun ke format Payment Request Xendit
+ */
+declare function toXenditPaymentMethod(code?: string): {
+    type: string;
+    channel_code?: string;
+} | undefined;
+/**
+ * Ubah method code apapun ke format Direct API DOKU Jokul
+ */
+declare function toDokuPaymentMethod(code?: string): {
+    endpoint: string;
+    type: "va" | "qris" | "cstore" | "ewallet";
+    bank?: string;
+} | undefined;
+/**
+ * Ubah method code apapun ke format channel PrismaLink
+ */
+declare function toPrismalinkPaymentMethod(code?: string): string | undefined;
+/**
+ * Ubah method code apapun ke format payment channel Faspay
+ */
+declare function toFaspayPaymentMethod(code?: string): string | undefined;
+/**
+ * Ubah method code apapun ke format channel Finpay
+ */
+declare function toFinpayPaymentMethod(code?: string): string | undefined;
+/**
+ * Ubah method code apapun ke format Nicepay
+ */
+declare function toNicepayPaymentMethod(code?: string): {
+    payMethod: string;
+    bankCd?: string;
+    mitraCd?: string;
+} | undefined;
+/**
+ * Ubah method code apapun ke format OY! Bisnis
+ */
+declare function toOyPaymentMethod(code?: string): {
+    type: "va" | "qris" | "ewallet" | "cstore";
+    bank_code?: string;
+    channel?: string;
+} | undefined;
+/**
+ * Ubah method code apapun ke format canonical standar Buayar
+ */
+declare function toCanonicalPaymentMethod(provider: string, code?: string): string;
+
+declare function getDuitkuInquirySignatures(merchantCode: string, orderId: string, amount: number, apiKey: string): {
+    payloadSignature: string;
+    timestamp: string;
+    headerSignature: string;
+};
+declare function verifyDuitkuCallbackSignature(body: any, apiKey: string): boolean;
+declare function getDuitkuPaymentMethodsSignature(merchantCode: string, amount: number, datetime: string, apiKey: string): string;
+declare function getDuitkuStatusSignatures(merchantCode: string, orderId: string, apiKey: string): {
+    timestamp: string;
+    headerSignature: string;
+    bodySignature: string;
+};
+
+declare const CORE_API_METHODS: string[];
+declare function buildCoreChargePayload(method: string, params: CreateInvoiceParams, config: ProviderConfig, integerAmount: number): {
+    payload?: any;
+    error?: string;
+};
+declare function parseCoreChargeResponse(method: string, data: any, orderId: string, integerAmount: number): InvoiceResponse;
+
+declare const MIDTRANS_STATIC_METHODS: PaymentMethod[];
+declare const MIDTRANS_PROBE_PAYLOADS: Record<string, any>;
+
+/**
+ * Generate signature for iPaymu API v2 requests
+ *
+ * Signature formula:
+ * stringToSign = HTTP_METHOD + ":" + VA + ":" + SHA256(RAW_BODY).toLowerCase() + ":" + API_KEY
+ * signature = HMAC_SHA256(stringToSign, API_KEY)
+ */
+declare function generateIpaymuSignature(method: "GET" | "POST", va: string, apiKey: string, body?: any): {
+    signature: string;
+    timestamp: string;
+};
+/**
+ * Verifikasi callback webhook dari iPaymu
+ */
+declare function verifyIpaymuCallback(payload: any): {
+    isPaid: boolean;
+    isPending: boolean;
+    isFailed: boolean;
+};
+
+/**
+ * Buat Basic Auth Header untuk API Xendit (Secret API Key + ":")
+ */
+declare function getXenditAuthHeader(secretKey: string): string;
+/**
+ * Verifikasi webhook callback token dari header x-callback-token Xendit
+ */
+declare function verifyXenditWebhookToken(headerToken?: string, expectedToken?: string): boolean;
+
+/**
+ * Generate DOKU Jokul v2 Request Headers & Signature
+ *
+ * Digest = Base64(SHA256(RAW_BODY))
+ * ComponentSignature = Client-Id:{clientId}\nRequest-Id:{requestId}\nRequest-Timestamp:{timestamp}\nRequest-Target:{requestTarget}\nDigest:{digest}
+ * Signature = "HMACSHA256=" + Base64(HMAC_SHA256(ComponentSignature, secretKey))
+ */
+declare function generateDokuHeaders(clientId: string, secretKey: string, requestTarget: string, body?: any, customRequestId?: string): {
+    "Client-Id": string;
+    "Request-Id": string;
+    "Request-Timestamp": string;
+    "Signature": string;
+    "Digest"?: string;
+};
+/**
+ * Verifikasi webhook signature DOKU Jokul
+ */
+declare function verifyDokuWebhookSignature(headers: Record<string, string | string[] | undefined>, body: any, clientId: string, secretKey: string, requestTarget?: string): boolean;
+
+/**
+ * Generate signature PrismaLink
+ *
+ * Signature formula: SHA256(merchantId + orderId + amount + secretKey)
+ */
+declare function generatePrismalinkSignature(merchantId: string, orderId: string, amount: number, secretKey: string): string;
+/**
+ * Verifikasi webhook signature dari callback PrismaLink
+ */
+declare function verifyPrismalinkSignature(merchantId: string, orderId: string, amount: number, secretKey: string, incomingSignature: string): boolean;
+
+/**
+ * Generate signature Faspay (SHA1(MD5(username + password + bill_no)))
+ */
+declare function generateFaspaySignature(userId: string, password: string, billNo: string): string;
+/**
+ * Verifikasi callback webhook notification Faspay
+ */
+declare function verifyFaspaySignature(userId: string, password: string, billNo: string, paymentStatusCode: string, incomingSignature: string): boolean;
+
+/**
+ * Generate signature Finpay HMAC-SHA512
+ */
+declare function generateFinpaySignature(merchantId: string, orderId: string, amount: number, merchantKey: string): string;
+/**
+ * Verifikasi webhook signature notifikasi Finpay
+ */
+declare function verifyFinpaySignature(merchantId: string, orderId: string, amount: number, merchantKey: string, incomingSignature: string): boolean;
+
+/**
+ * Format date ke format Nicepay: YYYYMMDDHHmmss (14 karakter)
+ */
+declare function formatNicepayTimestamp(date?: Date): string;
+/**
+ * Generate merchantToken Nicepay: SHA256(timeStamp + iMid + referenceNo + amt + merchantKey)
+ */
+declare function generateNicepayToken(timeStamp: string, iMid: string, referenceNo: string, amt: number | string, merchantKey: string): string;
+/**
+ * Verifikasi webhook callback signature dari dbProcessUrl Nicepay
+ */
+declare function verifyNicepayWebhook(timeStamp: string, iMid: string, referenceNo: string, amt: number | string, merchantKey: string, incomingToken: string): boolean;
+
+/**
+ * Generate header autentikasi OY! Bisnis
+ */
+declare function generateOyHeaders(username: string, apiKey: string): Record<string, string>;
+/**
+ * Verifikasi webhook callback OY! Bisnis
+ */
+declare function verifyOyWebhook(headers: Record<string, string | string[] | undefined>, expectedUsername: string): boolean;
+
+/**
+ * Generate MD5 hash string (lowercase)
+ */
+declare function md5(data: string): string;
+/**
+ * Generate SHA-256 hash string (lowercase)
+ */
+declare function sha256(data: string): string;
+/**
+ * Generate SHA-512 hash string (lowercase)
+ */
+declare function sha512(data: string): string;
+/**
+ * Generate HMAC-SHA256 hash string (lowercase)
+ */
+declare function hmacSha256(data: string, secret: string): string;
+/**
+ * Timing-safe string comparison to prevent timing attacks on signatures
+ */
+declare function safeCompare(a: string, b: string): boolean;
+
+/**
+ * Helper to categorize raw payment method code & name into unified accordion ready groups
+ */
+declare function getPaymentMethodCategory(code: string, name?: string): "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
+
+export { BasePaymentProvider, 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_XENDIT, CORE_API_METHODS, type CanonicalPaymentMethod, type CheckTransactionParams, type CheckTransactionResult, type CreateInvoiceParams, type CustomerDetails, DUITKU_TO_CANONICAL, 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, PrismalinkClient, PrismalinkProvider, type ProviderConfig, type VerifyCallbackResult, XenditClient, type XenditDisbursementParams, XenditProvider, buayar, buildCoreChargePayload, formatNicepayTimestamp, generateDokuHeaders, generateFaspaySignature, generateFinpaySignature, generateIpaymuSignature, generateNicepayToken, generateOyHeaders, generatePrismalinkSignature, getDuitkuInquirySignatures, getDuitkuPaymentMethodsSignature, getDuitkuStatusSignatures, getPaymentMethodCategory, getXenditAuthHeader, hmacSha256, md5, parseCoreChargeResponse, paymentManager, resolveConfigFromEnv, safeCompare, sha256, sha512, toCanonicalPaymentMethod, toDokuPaymentMethod, toDuitkuPaymentMethod, toFaspayPaymentMethod, toFinpayPaymentMethod, toIpaymuPaymentMethod, toNicepayPaymentMethod, toOyPaymentMethod, toPrismalinkPaymentMethod, toXenditPaymentMethod, verifyDokuWebhookSignature, verifyDuitkuCallbackSignature, verifyFaspaySignature, verifyFinpaySignature, verifyIpaymuCallback, verifyNicepayWebhook, verifyOyWebhook, verifyPrismalinkSignature, verifyXenditWebhookToken };