@crediblemark/buayar 0.1.6 → 0.1.8

package/README.md

@@ -3,26 +3,41 @@
 [![npm version](https://img.shields.io/npm/v/@crediblemark/buayar.svg?style=flat-square&color=amber)](https://www.npmjs.com/package/@crediblemark/buayar)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 
-**`@crediblemark/buayar`** adalah Unified Payment Gateway SDK untuk Node.js dan TypeScript yang dirancang untuk mempermudah integrasi berbagai gerbang pembayaran (Payment Gateway) dengan satu struktur API yang seragam.
+**`@crediblemark/buayar`** adalah Unified Payment Gateway SDK untuk Node.js dan TypeScript yang dirancang untuk mempermudah integrasi berbagai gerbang pembayaran (Payment Gateway) di Indonesia menggunakan satu struktur API yang seragam.
 
-Dengan SDK ini, Anda cukup menulis kode satu kali menggunakan struktur API yang konsisten untuk mengelola pembuatan invoice/transaksi serta verifikasi callback webhook dari berbagai penyedia layanan payment gateway.
+Dengan SDK ini, Anda cukup menulis kode satu kali menggunakan struktur API yang konsisten untuk mengelola pembuatan transaksi, pengecekan status transaksi, query metode pembayaran, serta verifikasi callback webhook dari berbagai penyedia layanan payment gateway.
 
 ---
 
 ## 🚀 Fitur Utama
- 
+
 - 🔄 **Unified API**: Satu antarmuka (interface) terpadu untuk semua provider payment gateway.
-- ⚡ **Direct Payment Support**: Otomatis mendeteksi `paymentMethod` dan beralih ke Direct Inquiry API (v2/inquiry) Duitku untuk mengembalikan `vaNumber`, `qrString` (EMVCo), dan `paymentCode` secara instan tanpa redirect eksternal.
-- 🏷️ **Pre-Categorization (Accordion Ready)**: Menyediakan pengelompokan pembayaran bawaan (`Virtual Account`, `QRIS`, `E-Wallet`, `Retail / Gerai`, `Lainnya`) langsung dari API response untuk memudahkan implementasi UI accordion.
+- ⚡ **Direct Payment Support**: Otomatis mendeteksi `paymentMethod` dan beralih ke Direct Inquiry API Duitku atau Core API Midtrans untuk mengembalikan `vaNumber`, `qrString` (EMVCo), dan `paymentCode` secara instan tanpa redirect eksternal.
+- 🏷️ **Pre-Categorization (Accordion Ready)**: Menyediakan pengelompokan pembayaran bawaan (`Virtual Account`, `QRIS`, `E-Wallet`, `Retail / Gerai`, `Kartu Kredit`, `Paylater / Cicilan`, `Lainnya`) langsung dari API response untuk memudahkan implementasi UI accordion.
 - 🎨 **Headless SDK Philosophy**: Dirancang murni sebagai core logic & data manager tanpa overhead UI/styling. Memberikan kebebasan penuh bagi pengembang untuk mendesain UI/Tailwind/dark mode di tingkat aplikasi.
 - 🛡️ **Tipe Data Kuat (TypeScript)**: Dilengkapi dengan deklarasi tipe data lengkap untuk mencegah *runtime error*.
-- 🇮🇩 **Dukungan Lokal**: Siap digunakan untuk transaksi di Indonesia (seperti Duitku).
 - ⚙️ **Modular & Dapat Diperluas**: Memungkinkan penambahan provider baru dengan mewarisi kelas base yang disediakan.
-- 🔒 **Otomatisasi Signature**: Keamanan transaksi terjamin dengan pembuatan *hash* signature (MD5, SHA-256) otomatis secara internal.
- 
+- 🔒 **Otomatisasi Signature**: Keamanan transaksi terjamin dengan pembuatan *hash* signature (MD5, SHA-256, SHA-512) otomatis secara internal.
+
+---
+
+## 📦 Provider yang Didukung
+
+SDK ini mendukung beberapa provider payment gateway terkemuka di Indonesia. Silakan merujuk ke dokumentasi detail untuk masing-masing provider:
+
+* 🏛️ **[Integrasi Duitku (docs/duitku.md)](file:///media/rasyiqi/PROJECT/credibuild-project/buayar/docs/duitku.md)**
+  * Mendukung Redirect Checkout & Direct Inquiry (VA, QRIS, Retail Code langsung).
+  * Verifikasi callback otomatis (signature MD5).
+  * Penelusuran status transaksi & query metode pembayaran dinamis.
+
+* 🏛️ **[Integrasi Midtrans (docs/midtrans.md)](file:///media/rasyiqi/PROJECT/credibuild-project/buayar/docs/midtrans.md)**
+  * Mendukung Snap API (Redirect Checkout) & Core API (Direct Charge VA, QRIS, E-Wallet, Retail, Kartu Kredit, Paylater).
+  * Verifikasi callback otomatis (signature SHA-512).
+  * Dilengkapi ekstensi `MidtransClient` untuk fitur transaksi pasca-bayar (refund, cancel, subscription recurring, balance check, payment link, gopay tokenization, invoicing).
+
 ---
 
-## 📦 Instalasi
+## ⚙️ Instalasi
 
 Instal package menggunakan manajer paket pilihan Anda:
 
@@ -40,6 +55,23 @@ yarn add @crediblemark/buayar
 pnpm add @crediblemark/buayar
 ```
 
+### Instalasi dari GitHub Packages (Alternatif)
+
+Package ini juga tersedia di [GitHub Packages](https://github.com/crediblemark-official/Buayar/packages). Buat file `.npmrc` di root project Anda:
+
+```ini
+@crediblemark:registry=https://npm.pkg.github.com/
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+```
+
+Kemudian install seperti biasa:
+
+```bash
+bun add @crediblemark/buayar
+```
+
+> **Catatan:** Anda memerlukan GitHub Personal Access Token (PAT) dengan scope `read:packages` yang di-set sebagai environment variable `GITHUB_TOKEN`.
+
 ---
 
 ## 🗺️ Alur Proses Pembayaran
@@ -50,15 +82,15 @@ sequenceDiagram
     actor Customer as 👤 Pelanggan
     participant App as 💻 Aplikasi Anda (Backend)
     participant SDK as 💳 @crediblemark/buayar
-    participant PG as 🏛️ Payment Gateway (e.g. Duitku)
+    participant PG as 🏛️ Payment Gateway (Duitku / Midtrans)
 
     Customer->>App: 1. Checkout Order
     App->>SDK: 2. createInvoice(provider, params, config)
-    SDK->>SDK: 3. Kalkulasi & Generate Signature
-    SDK->>PG: 4. Inquiry Request (API)
-    PG-->>SDK: 5. Kembalikan Payment URL & Ref
+    SDK->>SDK: 3. signature Generation & Calculation
+    SDK->>PG: 4. Inquiry / Charge Request (API)
+    PG-->>SDK: 5. Kembalikan Payment URL / VA / QRIS / Ref
     SDK-->>App: 6. Response (InvoiceResponse)
-    App-->>Customer: 7. Redirect ke Halaman Pembayaran (Payment URL)
+    App-->>Customer: 7. Tampilkan Detail VA/QRIS atau Redirect ke Payment URL
     Customer->>PG: 8. Selesaikan Pembayaran
     PG->>App: 9. Webhook Callback (Notifikasi Pembayaran)
     App->>SDK: 10. verifyCallback(provider, body, config)
@@ -68,135 +100,6 @@ sequenceDiagram
 
 ---
 
-## 🛠️ Integrasi & Penggunaan
-
-### 1. Inisialisasi & Membuat Transaksi (Invoice)
-
-Berikut adalah contoh pembuatan transaksi menggunakan provider **Duitku**:
-
-```typescript
-import { paymentManager } from "@crediblemark/buayar";
-
-const providerName = "duitku";
-
-// Konfigurasi Kredensial Provider
-const providerConfig = {
-  merchantCode: "DXXXX",         // Merchant Code dari Duitku
-  apiKey: "xxxxxxxxxxxxxxxx",    // API Key / Merchant Key Anda
-  sandbox: true,                 // Set true untuk development / testing
-};
-
-// Parameter Invoice / Pembayaran
-const invoiceParams = {
-  orderId: "ORDER-100249",
-  amount: 150000,                // Nominal transaksi (Rupiah)
-  productDetails: "Pembelian Template Landing Page Premium",
-  customer: {
-    name: "Rasyiqi Crediblemark",
-    email: "rasyiqi@crediblemark.com",
-    phone: "081234567890",       // Opsional
-  },
-  returnUrl: "https://situsbisnis.com/payment/success",
-  callbackUrl: "https://api.situsbisnis.com/v1/payment/callback",
-};
-
-async function handleCheckout() {
-  try {
-    const result = await paymentManager.createInvoice(
-      providerName,
-      invoiceParams,
-      providerConfig
-    );
-
-    if (result.success) {
-      console.log("Invoice Berhasil Dibuat! 🎉");
-      console.log("URL Pembayaran:", result.paymentUrl);
-      console.log("Referensi Gateway:", result.reference);
-      
-      // Redirect pelanggan ke paymentUrl
-      // response.redirect(result.paymentUrl);
-    } else {
-      console.error("Gagal membuat invoice:", result.error);
-    }
-  } catch (error) {
-    console.error("Terjadi kesalahan:", error);
-  }
-}
-
-handleCheckout();
-```
-
-### 2. Verifikasi Callback / Webhook Notifikasi
-
-Gunakan fungsi ini di endpoint API callback/webhook untuk memastikan data notifikasi yang dikirim oleh Payment Gateway valid dan tidak dimanipulasi:
-
-```typescript
-import { paymentManager } from "@crediblemark/buayar";
-
-// Endpoint API Webhook Handler
-async function handlePaymentCallback(req: any, res: any) {
-  const providerName = "duitku";
-  const callbackPayload = req.body; // Payload POST dari gateway
-  
-  const providerConfig = {
-    merchantCode: "DXXXX",
-    apiKey: "xxxxxxxxxxxxxxxx",
-    sandbox: true,
-  };
-
-  try {
-    const verification = await paymentManager.verifyCallback(
-      providerName,
-      callbackPayload,
-      providerConfig
-    );
-
-    if (verification.isValid) {
-      console.log(`Signature valid untuk Order: ${verification.orderId}`);
-      
-      if (verification.status === "paid") {
-        console.log("Status: PEMBAYARAN SELESAI & LUNAS! ✅");
-        // Update database Anda: ubah status order menjadi LUNAS
-      } else if (verification.status === "failed") {
-        console.log("Status: PEMBAYARAN GAGAL ❌");
-        // Update database: ubah status order menjadi GAGAL
-      }
-      
-      // Kirim respon sukses ke Payment Gateway (Duitku meminta respon plaintext OK)
-      res.status(200).send("OK");
-    } else {
-      console.warn("Peringatan: Signature callback tidak valid! Potensi manipulasi data.");
-      res.status(400).send("Bad Signature");
-    }
-  } catch (error) {
-    console.error("Gagal memproses callback:", error);
-    res.status(500).send("Internal Server Error");
-  }
-}
-```
-
----
-
-## 🗂️ Referensi API
-
-### `PaymentManager`
-
-#### `createInvoice(providerName, params, config)`
-Membuat transaksi baru ke gerbang pembayaran tertentu.
-- **`providerName`**: `string` - Nama provider payment gateway (contoh: `'duitku'`).
-- **`params`**: `CreateInvoiceParams` - Data invoice dan detail pelanggan.
-- **`config`**: `ProviderConfig` - Kredensial merchant dan API key.
-- **Return**: `Promise<InvoiceResponse>`
-
-#### `verifyCallback(providerName, body, config)`
-Memvalidasi signature webhook callback dari payment gateway.
-- **`providerName`**: `string` - Nama provider payment gateway (contoh: `'duitku'`).
-- **`body`**: `any` - Payload callback mentah dari request body.
-- **`config`**: `ProviderConfig` - Kredensial merchant dan API key.
-- **Return**: `Promise<VerifyCallbackResult>`
-
----
-
 ## 📐 Spesifikasi Interface (TypeScript)
 
 ### `CreateInvoiceParams`
@@ -212,6 +115,8 @@ interface CreateInvoiceParams {
   };
   returnUrl: string;
   callbackUrl: string;
+  paymentMethod?: string; // Opsional: Kode pembayaran untuk direct charge (contoh: "BCA", "bca_va", "qris")
+  providerParams?: any;   // Opsional: Parameter tambahan spesifik provider
 }
 ```
 
@@ -219,14 +124,14 @@ interface CreateInvoiceParams {
 ```typescript
 interface InvoiceResponse {
   success: boolean;
-  paymentUrl?: string;
-  reference?: string;
-  vaNumber?: string;       // Nomor Virtual Account (untuk metode Bank VA)
-  qrString?: string;       // EMVCo QRIS payload mentah (untuk scan langsung)
-  qrCodeUrl?: string;      // Image URL QRIS dari Duitku
+  paymentUrl?: string;     // URL checkout halaman pembayaran (jika menggunakan redirect)
+  reference?: string;      // ID Referensi transaksi / token Snap dari gateway
+  vaNumber?: string;       // Nomor Virtual Account jika menggunakan VA instan
+  qrString?: string;       // Data string QRIS mentah (EMVCo) untuk scan QR langsung
+  qrCodeUrl?: string;      // URL gambar QR Code
   paymentCode?: string;    // Kode pembayaran retail (Indomaret/Alfamart)
-  rawResponse: any;
-  error?: string;
+  rawResponse: any;        // Payload respons mentah dari API gateway
+  error?: string;          // Pesan kegagalan jika success = false
 }
 ```
 
@@ -237,36 +142,12 @@ interface PaymentMethod {
   paymentName: string;
   paymentImage: string;
   totalFee: string;
-  category: "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Lainnya";
-}
-```
-
-### `VerifyCallbackResult`
-```typescript
-interface VerifyCallbackResult {
-  isValid: boolean;
-  orderId: string;
-  amount: number;
-  status: "paid" | "pending" | "failed";
-  rawPayload: any;
+  category: "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
 }
 ```
 
 ---
 
-## 🛠️ Utilitas Tambahan
-
-### `getPaymentMethodCategory(code, name)`
-Mengkategorikan kode dan nama metode pembayaran Duitku ke kategori terstandarisasi untuk UI Accordion.
-```typescript
-import { getPaymentMethodCategory } from "@crediblemark/buayar";
-
-const cat = getPaymentMethodCategory("BT", "Permata VA"); 
-// Output: "Virtual Account"
-```
-
----
-
 ## 📄 Lisensi
 
 Proyek ini dilisensikan di bawah **MIT License**. Hak Cipta © 2026 Rasyiqi Crediblemark.

package/dist/index.d.mts

@@ -11,6 +11,8 @@ interface CreateInvoiceParams {
     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) */
+    providerParams?: any;
 }
 interface InvoiceResponse {
     success: boolean;
@@ -84,6 +86,69 @@ declare abstract class BasePaymentProvider {
     abstract verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     abstract getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
     abstract checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+    /** Probe/discover which payment methods are actually enabled/active for the merchant */
+    probePaymentMethods?(config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
+}
+
+declare class MidtransClient {
+    private apiKey;
+    private sandbox;
+    constructor(config: {
+        apiKey: string;
+        sandbox: boolean;
+    } | ProviderConfig);
+    private getApiBaseUrl;
+    request(method: "GET" | "POST" | "PATCH" | "DELETE", path: string, body: any): Promise<any>;
+    cancelTransaction(orderId: string): Promise<any>;
+    refundTransaction(orderId: string, payload: {
+        refund_key?: string;
+        amount?: number;
+        reason?: string;
+    }): Promise<any>;
+    expireTransaction(orderId: string): Promise<any>;
+    approveTransaction(orderId: string): Promise<any>;
+    denyTransaction(orderId: string): Promise<any>;
+    captureTransaction(transactionId: string, amount?: number): Promise<any>;
+    linkPayAccount(payload: any): Promise<any>;
+    getPayAccount(accountId: string): Promise<any>;
+    unbindPayAccount(accountId: string): Promise<any>;
+    getGoPayPromo(accountId: string, grossAmount: number, currency?: string): Promise<any>;
+    createSubscription(payload: any): Promise<any>;
+    getSubscription(subscriptionId: string): Promise<any>;
+    updateSubscription(subscriptionId: string, payload: any): Promise<any>;
+    disableSubscription(subscriptionId: string): Promise<any>;
+    enableSubscription(subscriptionId: string): Promise<any>;
+    createPaymentLink(payload: any): Promise<any>;
+    getPaymentLink(paymentLinkId: string): Promise<any>;
+    deletePaymentLink(paymentLinkId: string): Promise<any>;
+    getBalance(): Promise<any>;
+    createBillingInvoice(payload: any): Promise<any>;
+    getBillingInvoice(invoiceId: string): Promise<any>;
+    voidBillingInvoice(invoiceId: string): Promise<any>;
+    convertBillingInvoice(invoiceId: string): Promise<any>;
+}
+
+declare class MidtransProvider extends BasePaymentProvider {
+    readonly name = "midtrans";
+    private getSnapBaseUrl;
+    private getApiBaseUrl;
+    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>;
+    /**
+     * Get an instance of MidtransClient to perform transaction actions, subscriptions, invoicing, etc.
+     */
+    getClient(config: ProviderConfig): MidtransClient;
+    probePaymentMethods(config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
 }
 
 declare class DuitkuProvider extends BasePaymentProvider {
@@ -93,6 +158,11 @@ declare class DuitkuProvider extends BasePaymentProvider {
     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 function getPaymentMethodCategory(code: string, name?: string): "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
@@ -102,11 +172,18 @@ declare class PaymentManager {
     constructor();
     registerProvider(provider: BasePaymentProvider): void;
     getProvider(name: string): BasePaymentProvider;
+    getMidtransProvider(): MidtransProvider;
+    getMidtransClient(config: ProviderConfig): MidtransClient;
     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>;
     checkTransaction(providerName: string, params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+    probePaymentMethods(providerName: string, config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
 }
 declare const paymentManager: PaymentManager;
 
-export { BasePaymentProvider, type CheckTransactionParams, type CheckTransactionResult, type CreateInvoiceParams, DuitkuProvider, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, PaymentManager, type PaymentMethod, type ProviderConfig, type VerifyCallbackResult, getPaymentMethodCategory, 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 };

package/dist/index.d.ts

@@ -11,6 +11,8 @@ interface CreateInvoiceParams {
     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) */
+    providerParams?: any;
 }
 interface InvoiceResponse {
     success: boolean;
@@ -84,6 +86,69 @@ declare abstract class BasePaymentProvider {
     abstract verifyCallback(body: any, config: ProviderConfig): Promise<VerifyCallbackResult>;
     abstract getPaymentMethods(params: GetPaymentMethodsParams, config: ProviderConfig): Promise<GetPaymentMethodsResult>;
     abstract checkTransaction(params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+    /** Probe/discover which payment methods are actually enabled/active for the merchant */
+    probePaymentMethods?(config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
+}
+
+declare class MidtransClient {
+    private apiKey;
+    private sandbox;
+    constructor(config: {
+        apiKey: string;
+        sandbox: boolean;
+    } | ProviderConfig);
+    private getApiBaseUrl;
+    request(method: "GET" | "POST" | "PATCH" | "DELETE", path: string, body: any): Promise<any>;
+    cancelTransaction(orderId: string): Promise<any>;
+    refundTransaction(orderId: string, payload: {
+        refund_key?: string;
+        amount?: number;
+        reason?: string;
+    }): Promise<any>;
+    expireTransaction(orderId: string): Promise<any>;
+    approveTransaction(orderId: string): Promise<any>;
+    denyTransaction(orderId: string): Promise<any>;
+    captureTransaction(transactionId: string, amount?: number): Promise<any>;
+    linkPayAccount(payload: any): Promise<any>;
+    getPayAccount(accountId: string): Promise<any>;
+    unbindPayAccount(accountId: string): Promise<any>;
+    getGoPayPromo(accountId: string, grossAmount: number, currency?: string): Promise<any>;
+    createSubscription(payload: any): Promise<any>;
+    getSubscription(subscriptionId: string): Promise<any>;
+    updateSubscription(subscriptionId: string, payload: any): Promise<any>;
+    disableSubscription(subscriptionId: string): Promise<any>;
+    enableSubscription(subscriptionId: string): Promise<any>;
+    createPaymentLink(payload: any): Promise<any>;
+    getPaymentLink(paymentLinkId: string): Promise<any>;
+    deletePaymentLink(paymentLinkId: string): Promise<any>;
+    getBalance(): Promise<any>;
+    createBillingInvoice(payload: any): Promise<any>;
+    getBillingInvoice(invoiceId: string): Promise<any>;
+    voidBillingInvoice(invoiceId: string): Promise<any>;
+    convertBillingInvoice(invoiceId: string): Promise<any>;
+}
+
+declare class MidtransProvider extends BasePaymentProvider {
+    readonly name = "midtrans";
+    private getSnapBaseUrl;
+    private getApiBaseUrl;
+    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>;
+    /**
+     * Get an instance of MidtransClient to perform transaction actions, subscriptions, invoicing, etc.
+     */
+    getClient(config: ProviderConfig): MidtransClient;
+    probePaymentMethods(config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
 }
 
 declare class DuitkuProvider extends BasePaymentProvider {
@@ -93,6 +158,11 @@ declare class DuitkuProvider extends BasePaymentProvider {
     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 function getPaymentMethodCategory(code: string, name?: string): "Virtual Account" | "QRIS" | "E-Wallet" | "Retail / Gerai" | "Kartu Kredit" | "Paylater / Cicilan" | "Lainnya";
@@ -102,11 +172,18 @@ declare class PaymentManager {
     constructor();
     registerProvider(provider: BasePaymentProvider): void;
     getProvider(name: string): BasePaymentProvider;
+    getMidtransProvider(): MidtransProvider;
+    getMidtransClient(config: ProviderConfig): MidtransClient;
     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>;
     checkTransaction(providerName: string, params: CheckTransactionParams, config: ProviderConfig): Promise<CheckTransactionResult>;
+    probePaymentMethods(providerName: string, config: ProviderConfig): Promise<{
+        success: boolean;
+        enabled: string[];
+        error?: string;
+    }>;
 }
 declare const paymentManager: PaymentManager;
 
-export { BasePaymentProvider, type CheckTransactionParams, type CheckTransactionResult, type CreateInvoiceParams, DuitkuProvider, type GetPaymentMethodsParams, type GetPaymentMethodsResult, type InvoiceResponse, PaymentManager, type PaymentMethod, type ProviderConfig, type VerifyCallbackResult, getPaymentMethodCategory, 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 };