@monigo/sdk 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -109,6 +109,28 @@ export declare interface CreateSubscriptionRequest {
     plan_id: string;
 }
 
+/** Request body for `wallets.createVirtualAccount()`. */
+export declare interface CreateVirtualAccountRequest {
+    /** Use `VirtualAccountProvider` constants. */
+    provider: VirtualAccountProviderValue;
+    currency: string;
+}
+
+/** Request body for `wallets.credit()`. */
+export declare interface CreditWalletRequest {
+    /** Amount as a decimal string, e.g. `"100.50"`. */
+    amount: string;
+    currency: string;
+    description: string;
+    /** Use `WalletEntryType` constants. */
+    entry_type: WalletEntryTypeValue;
+    reference_type: string;
+    reference_id: string;
+    idempotency_key: string;
+    /** Optional provider account UUID for the other side of double entry. */
+    provider_id?: string;
+}
+
 /** An end-customer record in your Monigo organisation. */
 export declare interface Customer {
     id: string;
@@ -179,6 +201,33 @@ export declare class CustomersResource {
     delete(customerId: string): Promise<void>;
 }
 
+/** A prepaid balance belonging to a single customer. All monetary values are decimal strings. */
+export declare interface CustomerWallet {
+    id: string;
+    customer_id: string;
+    org_id: string;
+    currency: string;
+    /** Current available balance as a decimal string, e.g. `"500.000000"`. */
+    balance: string;
+    /** Balance reserved for pending operations. */
+    reserved_balance: string;
+    created_at: string;
+    updated_at: string;
+}
+
+/** Request body for `wallets.debit()`. */
+export declare interface DebitWalletRequest {
+    /** Amount as a decimal string, e.g. `"50.25"`. */
+    amount: string;
+    currency: string;
+    description: string;
+    /** Use `WalletEntryType` constants. */
+    entry_type: WalletEntryTypeValue;
+    reference_type: string;
+    reference_id: string;
+    idempotency_key: string;
+}
+
 /** Tracks the progress of an asynchronous event replay job. */
 export declare interface EventReplayJob {
     id: string;
@@ -263,6 +312,13 @@ export declare class EventsResource {
     getReplay(jobId: string): Promise<EventReplayJob>;
 }
 
+/** Request body for `wallets.getOrCreate()`. */
+export declare interface GetOrCreateWalletRequest {
+    org_id: string;
+    customer_id: string;
+    currency: string;
+}
+
 /** A single usage event sent to the Monigo ingestion pipeline. */
 export declare interface IngestEvent {
     /**
@@ -406,6 +462,32 @@ export declare const InvoiceStatus: {
 
 export declare type InvoiceStatusValue = (typeof InvoiceStatus)[keyof typeof InvoiceStatus];
 
+/** One side of a double-entry accounting record. */
+export declare interface LedgerEntry {
+    id: string;
+    org_id: string;
+    transaction_id: string;
+    wallet_id: string | null;
+    /** `customer_wallet`, `provider`, or `revenue`. */
+    account_type: string;
+    account_id: string;
+    /** Use `WalletDirection` constants. */
+    direction: WalletDirectionValue;
+    /** Amount as a decimal string. */
+    amount: string;
+    currency: string;
+    balance_before: string;
+    balance_after: string;
+    description: string;
+    /** Use `WalletEntryType` constants. */
+    entry_type: WalletEntryTypeValue;
+    reference_type: string;
+    reference_id: string;
+    idempotency_key: string;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+}
+
 export declare interface ListCustomersResponse {
     customers: Customer[];
     count: number;
@@ -457,6 +539,34 @@ export declare interface ListSubscriptionsResponse {
     count: number;
 }
 
+export declare interface ListTransactionsParams {
+    /** Number of entries to return (1–100). Defaults to 25. */
+    limit?: number;
+    /** Number of entries to skip. Defaults to 0. */
+    offset?: number;
+}
+
+export declare interface ListTransactionsResponse {
+    transactions: LedgerEntry[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+
+export declare interface ListVirtualAccountsResponse {
+    virtual_accounts: VirtualAccount[];
+    count: number;
+}
+
+export declare interface ListWalletsParams {
+    org_id: string;
+}
+
+export declare interface ListWalletsResponse {
+    wallets: CustomerWallet[];
+    count: number;
+}
+
 /** Defines what usage is counted and how. */
 export declare interface Metric {
     id: string;
@@ -599,6 +709,8 @@ export declare class MonigoClient {
     readonly usage: UsageResource;
     /** Manage customer portal access links. Requires `read` / `write` scope. */
     readonly portalTokens: PortalTokensResource;
+    /** Manage customer wallets, balance operations, and virtual accounts. Requires `read` / `write` scope. */
+    readonly wallets: WalletsResource;
     constructor(options: MonigoClientOptions);
     /* Excluded from this release type: _request */
     /** Normalise a `Date | string` value to an ISO 8601 string. */
@@ -1142,4 +1254,127 @@ export declare interface UsageRollup {
     updated_at: string;
 }
 
+/** A dedicated virtual bank account that funds a customer wallet. */
+export declare interface VirtualAccount {
+    id: string;
+    customer_id: string;
+    wallet_id: string;
+    org_id: string;
+    /** Payment provider. Use `VirtualAccountProvider` constants. */
+    provider: VirtualAccountProviderValue;
+    account_number: string;
+    account_name: string;
+    bank_name: string;
+    bank_code: string;
+    currency: string;
+    provider_ref: string;
+    is_active: boolean;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    updated_at: string;
+}
+
+export declare const VirtualAccountProvider: {
+    readonly Paystack: "paystack";
+    readonly Flutterwave: "flutterwave";
+    readonly Monnify: "monnify";
+};
+
+export declare type VirtualAccountProviderValue = (typeof VirtualAccountProvider)[keyof typeof VirtualAccountProvider];
+
+export declare const WalletDirection: {
+    /** Reduces the wallet balance. */
+    readonly Debit: "debit";
+    /** Increases the wallet balance. */
+    readonly Credit: "credit";
+};
+
+export declare type WalletDirectionValue = (typeof WalletDirection)[keyof typeof WalletDirection];
+
+export declare const WalletEntryType: {
+    /** Credit from an external funding source. */
+    readonly Deposit: "deposit";
+    /** Debit to an external destination. */
+    readonly Withdrawal: "withdrawal";
+    /** Automatic debit for metered usage charges. */
+    readonly Usage: "usage";
+    /** Credit reversing a previous charge. */
+    readonly Refund: "refund";
+    /** Manual balance correction. */
+    readonly Adjustment: "adjustment";
+};
+
+export declare type WalletEntryTypeValue = (typeof WalletEntryType)[keyof typeof WalletEntryType];
+
+export declare interface WalletOperationResponse {
+    wallet: CustomerWallet;
+    ledger_entries: LedgerEntry[];
+}
+
+/** Manage customer wallets, balance operations, and virtual accounts. */
+export declare class WalletsResource {
+    private readonly client;
+    constructor(client: MonigoClient);
+    /**
+     * Get an existing wallet or create a new one for the given customer and currency.
+     *
+     * **Requires `write` scope.**
+     */
+    getOrCreate(request: GetOrCreateWalletRequest, options?: MutationOptions): Promise<CustomerWallet>;
+    /**
+     * List all wallets for an organisation.
+     *
+     * **Requires `read` scope.**
+     */
+    list(params: ListWalletsParams): Promise<ListWalletsResponse>;
+    /**
+     * List all wallets belonging to a specific customer.
+     *
+     * **Requires `read` scope.**
+     */
+    listByCustomer(customerId: string): Promise<ListWalletsResponse>;
+    /**
+     * Fetch a single wallet by UUID, including its virtual accounts.
+     *
+     * **Requires `read` scope.**
+     */
+    get(walletId: string): Promise<WalletWithVirtualAccountsResponse>;
+    /**
+     * Credit (add funds to) a wallet. Returns the updated wallet and ledger entries.
+     *
+     * **Requires `write` scope.**
+     */
+    credit(walletId: string, request: CreditWalletRequest, options?: MutationOptions): Promise<WalletOperationResponse>;
+    /**
+     * Debit (remove funds from) a wallet. Returns the updated wallet and ledger entries.
+     * Throws a 402 error if the wallet has insufficient balance.
+     *
+     * **Requires `write` scope.**
+     */
+    debit(walletId: string, request: DebitWalletRequest, options?: MutationOptions): Promise<WalletOperationResponse>;
+    /**
+     * List paginated ledger entries (transactions) for a wallet.
+     *
+     * **Requires `read` scope.**
+     */
+    listTransactions(walletId: string, params?: ListTransactionsParams): Promise<ListTransactionsResponse>;
+    /**
+     * Create a dedicated virtual bank account that automatically funds the wallet on deposit.
+     *
+     * **Requires `write` scope.**
+     */
+    createVirtualAccount(walletId: string, request: CreateVirtualAccountRequest, options?: MutationOptions): Promise<VirtualAccount>;
+    /**
+     * List all virtual accounts linked to a wallet.
+     *
+     * **Requires `read` scope.**
+     */
+    listVirtualAccounts(walletId: string): Promise<ListVirtualAccountsResponse>;
+}
+
+export declare interface WalletWithVirtualAccountsResponse {
+    wallet: CustomerWallet;
+    virtual_accounts: VirtualAccount[];
+}
+
 export { }

package/dist/monigo.cjs

@@ -724,6 +724,122 @@ class PortalTokensResource {
     );
   }
 }
+class WalletsResource {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get an existing wallet or create a new one for the given customer and currency.
+   *
+   * **Requires `write` scope.**
+   */
+  async getOrCreate(request, options) {
+    const wrapper = await this.client._request(
+      "POST",
+      "/v1/wallets",
+      { body: request, idempotencyKey: options?.idempotencyKey }
+    );
+    return wrapper.wallet;
+  }
+  /**
+   * List all wallets for an organisation.
+   *
+   * **Requires `read` scope.**
+   */
+  async list(params) {
+    return this.client._request("GET", "/v1/wallets", {
+      query: { org_id: params.org_id }
+    });
+  }
+  /**
+   * List all wallets belonging to a specific customer.
+   *
+   * **Requires `read` scope.**
+   */
+  async listByCustomer(customerId) {
+    return this.client._request(
+      "GET",
+      `/v1/customers/${customerId}/wallets`
+    );
+  }
+  /**
+   * Fetch a single wallet by UUID, including its virtual accounts.
+   *
+   * **Requires `read` scope.**
+   */
+  async get(walletId) {
+    return this.client._request(
+      "GET",
+      `/v1/wallets/${walletId}`
+    );
+  }
+  /**
+   * Credit (add funds to) a wallet. Returns the updated wallet and ledger entries.
+   *
+   * **Requires `write` scope.**
+   */
+  async credit(walletId, request, options) {
+    return this.client._request(
+      "POST",
+      `/v1/wallets/${walletId}/credit`,
+      { body: request, idempotencyKey: options?.idempotencyKey }
+    );
+  }
+  /**
+   * Debit (remove funds from) a wallet. Returns the updated wallet and ledger entries.
+   * Throws a 402 error if the wallet has insufficient balance.
+   *
+   * **Requires `write` scope.**
+   */
+  async debit(walletId, request, options) {
+    return this.client._request(
+      "POST",
+      `/v1/wallets/${walletId}/debit`,
+      { body: request, idempotencyKey: options?.idempotencyKey }
+    );
+  }
+  /**
+   * List paginated ledger entries (transactions) for a wallet.
+   *
+   * **Requires `read` scope.**
+   */
+  async listTransactions(walletId, params) {
+    return this.client._request(
+      "GET",
+      `/v1/wallets/${walletId}/transactions`,
+      {
+        query: {
+          limit: params?.limit?.toString(),
+          offset: params?.offset?.toString()
+        }
+      }
+    );
+  }
+  /**
+   * Create a dedicated virtual bank account that automatically funds the wallet on deposit.
+   *
+   * **Requires `write` scope.**
+   */
+  async createVirtualAccount(walletId, request, options) {
+    const wrapper = await this.client._request(
+      "POST",
+      `/v1/wallets/${walletId}/virtual-accounts`,
+      { body: request, idempotencyKey: options?.idempotencyKey }
+    );
+    return wrapper.virtual_account;
+  }
+  /**
+   * List all virtual accounts linked to a wallet.
+   *
+   * **Requires `read` scope.**
+   */
+  async listVirtualAccounts(walletId) {
+    return this.client._request(
+      "GET",
+      `/v1/wallets/${walletId}/virtual-accounts`
+    );
+  }
+}
 const DEFAULT_BASE_URL = "https://api.monigo.co";
 const DEFAULT_TIMEOUT_MS = 3e4;
 class MonigoClient {
@@ -750,6 +866,7 @@ class MonigoClient {
     this.invoices = new InvoicesResource(this);
     this.usage = new UsageResource(this);
     this.portalTokens = new PortalTokensResource(this);
+    this.wallets = new WalletsResource(this);
   }
   /**
    * Execute an authenticated HTTP request against the Monigo API.
@@ -863,6 +980,29 @@ const PayoutMethod = {
   BankTransfer: "bank_transfer",
   MobileMoney: "mobile_money"
 };
+const WalletEntryType = {
+  /** Credit from an external funding source. */
+  Deposit: "deposit",
+  /** Debit to an external destination. */
+  Withdrawal: "withdrawal",
+  /** Automatic debit for metered usage charges. */
+  Usage: "usage",
+  /** Credit reversing a previous charge. */
+  Refund: "refund",
+  /** Manual balance correction. */
+  Adjustment: "adjustment"
+};
+const WalletDirection = {
+  /** Reduces the wallet balance. */
+  Debit: "debit",
+  /** Increases the wallet balance. */
+  Credit: "credit"
+};
+const VirtualAccountProvider = {
+  Paystack: "paystack",
+  Flutterwave: "flutterwave",
+  Monnify: "monnify"
+};
 exports.Aggregation = Aggregation;
 exports.BillingPeriod = BillingPeriod;
 exports.CustomersResource = CustomersResource;
@@ -881,4 +1021,8 @@ exports.PricingModel = PricingModel;
 exports.SubscriptionStatus = SubscriptionStatus;
 exports.SubscriptionsResource = SubscriptionsResource;
 exports.UsageResource = UsageResource;
+exports.VirtualAccountProvider = VirtualAccountProvider;
+exports.WalletDirection = WalletDirection;
+exports.WalletEntryType = WalletEntryType;
+exports.WalletsResource = WalletsResource;
 //# sourceMappingURL=monigo.cjs.map