nestjs-monobank 1.2.8

package/dist/modules/subscription/interfaces/responses/history.response.d.ts

@@ -0,0 +1,9 @@
+import type { PaginatedResponse } from "../../../../common/interfaces";
+import type { WalletStatusEnum } from "../../enums";
+export interface PaymentResponse {
+    amount: number;
+    status: WalletStatusEnum;
+    chargedAt: string;
+    ccy: string;
+}
+export type HistoryResponse = PaginatedResponse<PaymentResponse>;

package/dist/modules/subscription/interfaces/responses/history.response.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/subscription/interfaces/responses/index.d.ts

@@ -0,0 +1,5 @@
+export * from './subscription.response';
+export * from './subscription-status.response';
+export * from './client-subscriptions.response';
+export * from './history.response';
+export * from './create-subscription.response';

package/dist/modules/subscription/interfaces/responses/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./subscription.response"), exports);
+__exportStar(require("./subscription-status.response"), exports);
+__exportStar(require("./client-subscriptions.response"), exports);
+__exportStar(require("./history.response"), exports);
+__exportStar(require("./create-subscription.response"), exports);

package/dist/modules/subscription/interfaces/responses/subscription-status.response.d.ts

@@ -0,0 +1,29 @@
+import type { SubscriptionSummary, WalletData } from "../../../../common/interfaces";
+import type { SubscriptionStatusEnum } from "../../enums";
+/**
+ * Статус підписки клієнта
+ */
+export interface SubscriptionStatusResponse {
+    /** Ідентифікатор підписки */
+    subscriptionId: string;
+    /** Статус підписки */
+    status: SubscriptionStatusEnum;
+    /** Дата початку підписки (ISO 8601) */
+    startDate: string;
+    /** Дата завершення підписки (ISO 8601), якщо підписка закінчена або запланована */
+    endDate?: string;
+    /** Сума списання у мінімальних одиницях валюти */
+    amount: number;
+    /** Числовий код валюти ISO 4217 */
+    ccy: number;
+    /** Періодичність списання (наприклад, "1m", "2w") */
+    interval: string;
+    /** Дата наступного списання (ISO 8601), якщо відома */
+    nextChargeDate?: string;
+    /** Причина скасування, якщо підписка була скасована */
+    cancellationDesc?: string;
+    /** Статистика платежів по підписці */
+    summary: SubscriptionSummary;
+    /** Дані гаманця, через який проходять списання */
+    walletData: WalletData;
+}

package/dist/modules/subscription/interfaces/responses/subscription-status.response.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/subscription/interfaces/responses/subscription.response.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Відповідь API при створенні або отриманні підписки
+ */
+export interface SubscriptionResponse {
+    /** Ідентифікатор підписки */
+    subscriptionId: string;
+    /** URL сторінки підписки для користувача */
+    pageUrl: string;
+}

package/dist/modules/subscription/interfaces/responses/subscription.response.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/subscription/subscription.module.d.ts

@@ -0,0 +1,2 @@
+export declare class SubscriptionModule {
+}

package/dist/modules/subscription/subscription.module.js

@@ -0,0 +1,20 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionModule = void 0;
+const common_1 = require("@nestjs/common");
+const subscription_service_1 = require("./subscription.service");
+let SubscriptionModule = class SubscriptionModule {
+};
+exports.SubscriptionModule = SubscriptionModule;
+exports.SubscriptionModule = SubscriptionModule = __decorate([
+    (0, common_1.Module)({
+        providers: [subscription_service_1.SubscriptionService],
+        exports: [subscription_service_1.SubscriptionService],
+    })
+], SubscriptionModule);

package/dist/modules/subscription/subscription.service.d.ts

@@ -0,0 +1,91 @@
+import type { ClientSubscriptionResponse, ClientSubscriptionsRequest, CreateSubscriptionRequest, CreateSubscriptionResponse, EditSubscriptionRequest, HistoryRequest, HistoryResponse, SubscriptionStatusResponse } from "./interfaces";
+import { MonobankHttpClient } from "../../core/http/monobank.http-client";
+export declare class SubscriptionService {
+    private readonly http;
+    constructor(http: MonobankHttpClient);
+    /**
+     * Створює нову підписку (регулярний платіж).
+     * Після створення клієнта необхідно перенаправити на `pageUrl`
+     * для підтвердження підписки.
+     *
+     * @param {CreateSubscriptionRequest} data Дані для створення підписки
+     * @returns {Promise<CreateSubscriptionResponse>} Обʼєкт із посиланням на сторінку оплати
+     *
+     * @example
+     * const subscription = await this.monobankService.subscription.create({
+     *   amount: 19900,
+     *   redirectUrl: 'https://example.com/payment/success',
+     *   webHookUrls: {
+     *       chargeUrl: "https://example.com/api/v1/webhooks/monobank/charge"
+     *       statusUrl: "https://example.com/api/v1/webhooks/monobank/status"
+     *   }
+     *   interval: '1m',
+     *   validity: 2592000
+     * });
+     *
+     * console.log(subscription.pageUrl);
+     */
+    create(data: CreateSubscriptionRequest): Promise<CreateSubscriptionResponse>;
+    /**
+     * Отримує поточний статус підписки.
+     *
+     * @param {string} subscriptionId Унікальний ідентифікатор підписки
+     * @returns {Promise<SubscriptionStatusResponse>} Інформація про статус підписки
+     *
+     * @example
+     * const status = await this.monobankService.subscription.getStatus('sub_123456');
+     * console.log(status.status);
+     */
+    getStatus(subscriptionId: string): Promise<SubscriptionStatusResponse>;
+    /**
+     * Отримує історію платежів по підписці.
+     *
+     * @param {HistoryRequest} query Параметри фільтрації (subscriptionId, дати, ліміти)
+     * @returns {Promise<HistoryResponse>} Список платежів
+     *
+     * @example
+     * const history = await this.monobankService.subscription.getHistory({
+     *   subscriptionId: 'sub_123456',
+     *   dateFrom: '2025-01-01T00:00:00Z',
+     *   limit: 20
+     * });
+     */
+    getHistory(query: HistoryRequest): Promise<HistoryResponse>;
+    /**
+     * Отримує список підписок мерчанта або клієнта.
+     *
+     * @param {ClientSubscriptionsRequest} query Параметри пошуку (статус, дати, сторінка)
+     * @returns {Promise<ClientSubscriptionsResponse>} Масив підписок
+     *
+     * @example
+     * const subscriptions = await this.monobankService.subscription.getClientSubscriptions({
+     *   status: 'active',
+     *   limit: 10
+     * });
+     */
+    getClientSubscriptions(query: ClientSubscriptionsRequest): Promise<ClientSubscriptionResponse>;
+    /**
+     * Редагує або скасовує підписку.
+     * На даний момент підтримується дія `cancel`.
+     *
+     * @param {EditSubscriptionRequest} data Дані для редагування підписки
+     * @returns {Promise<void>}
+     *
+     * @example
+     * await this.monobankService.subscription.editSubscription({
+     *   subscriptionId: 'sub_123456',
+     *   action: 'cancel'
+     * });
+     */
+    editSubscription(data: EditSubscriptionRequest): Promise<void>;
+    /**
+     * Видаляє (деактивує) підписку.
+     *
+     * @param {string} subscriptionId Ідентифікатор підписки
+     * @returns {Promise<void>}
+     *
+     * @example
+     * await this.monobankService.subscription.removeSubscription('sub_123456');
+     */
+    removeSubscription(subscriptionId: string): Promise<void>;
+}

package/dist/modules/subscription/subscription.service.js

@@ -0,0 +1,121 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionService = void 0;
+const common_1 = require("@nestjs/common");
+const monobank_http_client_1 = require("../../core/http/monobank.http-client");
+let SubscriptionService = class SubscriptionService {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Створює нову підписку (регулярний платіж).
+     * Після створення клієнта необхідно перенаправити на `pageUrl`
+     * для підтвердження підписки.
+     *
+     * @param {CreateSubscriptionRequest} data Дані для створення підписки
+     * @returns {Promise<CreateSubscriptionResponse>} Обʼєкт із посиланням на сторінку оплати
+     *
+     * @example
+     * const subscription = await this.monobankService.subscription.create({
+     *   amount: 19900,
+     *   redirectUrl: 'https://example.com/payment/success',
+     *   webHookUrls: {
+     *       chargeUrl: "https://example.com/api/v1/webhooks/monobank/charge"
+     *       statusUrl: "https://example.com/api/v1/webhooks/monobank/status"
+     *   }
+     *   interval: '1m',
+     *   validity: 2592000
+     * });
+     *
+     * console.log(subscription.pageUrl);
+     */
+    async create(data) {
+        return this.http.post('/merchant/subscription/create', data);
+    }
+    /**
+     * Отримує поточний статус підписки.
+     *
+     * @param {string} subscriptionId Унікальний ідентифікатор підписки
+     * @returns {Promise<SubscriptionStatusResponse>} Інформація про статус підписки
+     *
+     * @example
+     * const status = await this.monobankService.subscription.getStatus('sub_123456');
+     * console.log(status.status);
+     */
+    async getStatus(subscriptionId) {
+        return this.http.get(`/merchant/subscription/status?subscriptionId=${subscriptionId}`);
+    }
+    /**
+     * Отримує історію платежів по підписці.
+     *
+     * @param {HistoryRequest} query Параметри фільтрації (subscriptionId, дати, ліміти)
+     * @returns {Promise<HistoryResponse>} Список платежів
+     *
+     * @example
+     * const history = await this.monobankService.subscription.getHistory({
+     *   subscriptionId: 'sub_123456',
+     *   dateFrom: '2025-01-01T00:00:00Z',
+     *   limit: 20
+     * });
+     */
+    async getHistory(query) {
+        return this.http.get('/merchant/subscription/payments', { params: query });
+    }
+    /**
+     * Отримує список підписок мерчанта або клієнта.
+     *
+     * @param {ClientSubscriptionsRequest} query Параметри пошуку (статус, дати, сторінка)
+     * @returns {Promise<ClientSubscriptionsResponse>} Масив підписок
+     *
+     * @example
+     * const subscriptions = await this.monobankService.subscription.getClientSubscriptions({
+     *   status: 'active',
+     *   limit: 10
+     * });
+     */
+    async getClientSubscriptions(query) {
+        return this.http.get(`/merchant/subscription/list`, { params: query });
+    }
+    /**
+     * Редагує або скасовує підписку.
+     * На даний момент підтримується дія `cancel`.
+     *
+     * @param {EditSubscriptionRequest} data Дані для редагування підписки
+     * @returns {Promise<void>}
+     *
+     * @example
+     * await this.monobankService.subscription.editSubscription({
+     *   subscriptionId: 'sub_123456',
+     *   action: 'cancel'
+     * });
+     */
+    async editSubscription(data) {
+        return this.http.post(`/merchant/subscription/edit`, data);
+    }
+    /**
+     * Видаляє (деактивує) підписку.
+     *
+     * @param {string} subscriptionId Ідентифікатор підписки
+     * @returns {Promise<void>}
+     *
+     * @example
+     * await this.monobankService.subscription.removeSubscription('sub_123456');
+     */
+    async removeSubscription(subscriptionId) {
+        return this.http.post(`/merchant/subscription/remove?subscriptionId=${subscriptionId}`);
+    }
+};
+exports.SubscriptionService = SubscriptionService;
+exports.SubscriptionService = SubscriptionService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [monobank_http_client_1.MonobankHttpClient])
+], SubscriptionService);

package/dist/modules/wallet/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './requests';
+export * from './responses';

package/dist/modules/wallet/interfaces/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests"), exports);
+__exportStar(require("./responses"), exports);

package/dist/modules/wallet/interfaces/requests/create-card-token.request.d.ts

@@ -0,0 +1,42 @@
+import type { MerchantPaymInfoItem } from "../../../../common/interfaces";
+/**
+ * Запит на створення платежу за токеном картки.
+ */
+export interface CreateCardTokenRequest {
+    /**
+     * Токен картки, отриманий з особистого кабінету або тестовий токен
+     */
+    cardToken: string;
+    /**
+     * Сума платежу в мінімальних одиницях (наприклад, копійки для гривні)
+     */
+    amount: number;
+    /**
+     * ISO 4217 код валюти
+     */
+    ccy: number;
+    /**
+     * (Не обов'язковий) URL для переадресації користувача після 3DS підтвердження
+     */
+    redirectUrl?: string;
+    /**
+     * (Не обов'язковий) URL для вебхука, на який надсилаються оновлення статусу платежу
+     */
+    webHookUrl?: string;
+    /**
+     * Тип ініціації платежу:
+     * "merchant" - ініціатива мерчанту (наприклад, регулярний платіж)
+     * "client" - ініціатива клієнта (клієнт підтверджує платіж)
+     */
+    initiationKind: "merchant" | "client";
+    /**
+     * (Не обов'язковий) Тип платежу:
+     * "debit" - списання коштів
+     * "hold" - блокування коштів
+     */
+    paymentType?: "debit" | "hold";
+    /**
+     * (Не обов'язковий) Інформація про платіж, для зв'язку з ПРРО через веб-кабінет
+     */
+    merchantPaymInfo?: MerchantPaymInfoItem;
+}

package/dist/modules/wallet/interfaces/requests/create-card-token.request.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/wallet/interfaces/requests/index.d.ts

@@ -0,0 +1 @@
+export * from './create-card-token.request';

package/dist/modules/wallet/interfaces/requests/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-card-token.request"), exports);

package/dist/modules/wallet/interfaces/responses/card-token.response.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Результат платежу за токеном картки.
+ */
+export interface CardTokenResponse {
+    /**
+     * Унікальний ідентифікатор рахунку (invoice).
+     */
+    invoiceId: string;
+    /**
+     * URL для проведення 3DS підтвердження платежу.
+     */
+    tdsUrl: string;
+    /**
+     * Статус платежу: "success", "failure" тощо.
+     */
+    status: string;
+    /**
+     * Причина невдачі платежу (якщо статус "failure").
+     */
+    failureReason?: string;
+    /**
+     * Сума платежу в мінімальних одиницях (наприклад, копійки для гривні).
+     */
+    amount: number;
+    /**
+     * ISO 4217 код валюти.
+     */
+    ccy: number;
+    /**
+     * Дата створення рахунку (може бути null).
+     */
+    createdDate: string | null;
+    /**
+     * Дата останнього оновлення рахунку (може бути null).
+     */
+    modifiedDate: string | null;
+}

package/dist/modules/wallet/interfaces/responses/card-token.response.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/wallet/interfaces/responses/create-card-token.response.d.ts

@@ -0,0 +1,7 @@
+import type { CardTokenResponse } from './card-token.response';
+/**
+ * Відповідь API при створенні платежу за токеном картки.
+ * Наслідує базову структуру CardTokenResponse.
+ */
+export interface CreateCardTokenResponse extends CardTokenResponse {
+}

package/dist/modules/wallet/interfaces/responses/create-card-token.response.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/wallet/interfaces/responses/index.d.ts

@@ -0,0 +1,2 @@
+export * from './card-token.response';
+export * from './create-card-token.response';

package/dist/modules/wallet/interfaces/responses/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./card-token.response"), exports);
+__exportStar(require("./create-card-token.response"), exports);

package/dist/modules/wallet/wallet.module.d.ts

@@ -0,0 +1,2 @@
+export declare class WalletModule {
+}

package/dist/modules/wallet/wallet.module.js

@@ -0,0 +1,20 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletModule = void 0;
+const common_1 = require("@nestjs/common");
+const wallet_service_1 = require("./wallet.service");
+let WalletModule = class WalletModule {
+};
+exports.WalletModule = WalletModule;
+exports.WalletModule = WalletModule = __decorate([
+    (0, common_1.Module)({
+        providers: [wallet_service_1.WalletService],
+        exports: [wallet_service_1.WalletService],
+    })
+], WalletModule);

package/dist/modules/wallet/wallet.service.d.ts

@@ -0,0 +1,54 @@
+import { MonobankHttpClient } from "../../core/http/monobank.http-client";
+import type { CardTokenResponse, CreateCardTokenRequest, CreateCardTokenResponse } from './interfaces';
+export declare class WalletService {
+    readonly http: MonobankHttpClient;
+    constructor(http: MonobankHttpClient);
+    /**
+    * Створює токен картки (Card Token) для збереження платіжної картки.
+    *
+    * Використовується для:
+    * - привʼязки картки клієнта
+    * - повторних платежів без повторного введення реквізитів
+    * - роботи з wallet-платежами Monobank
+    *
+    * @param {CreateCardTokenRequest} data - Дані для створення токена картки.
+    * @returns {Promise<CreateCardTokenResponse>} Дані створеного токена картки.
+    *
+    * @example
+    * const data: CreateCardTokenRequest = {
+    *   amount: 100,
+    *   ccy: 980,
+    *   redirectUrl: "https://example.com/success",
+    *   webHookUrl: "https://example.com/webhook"
+    * };
+    *
+    * const token = await this.monobankService.wallet.create(data);
+    * console.log(token.cardToken);
+    */
+    create(data: CreateCardTokenRequest): Promise<CreateCardTokenResponse>;
+    /**
+    * Отримує інформацію про wallet за його ідентифікатором.
+    *
+    * @param {string} id - Унікальний ідентифікатор wallet.
+    * @returns {Promise<CardTokenResponse>} Дані wallet (привʼязана картка, статус тощо).
+    *
+    * @example
+    * const wallet = await this.monobankService.wallet.getById("wlt_123456");
+    * console.log(wallet);
+    */
+    getById(id: string): Promise<CardTokenResponse>;
+    /**
+    * Видаляє привʼязану картку за токеном.
+    *
+    * Після видалення:
+    * - токен стає недійсним
+    * - повторні списання по цій картці неможливі
+    *
+    * @param {string} token - Токен картки (cardToken).
+    * @returns {Promise<void>} Результат операції видалення.
+    *
+    * @example
+    * await this.monobankService.wallet.deleteByToken("card_token_abc123");
+    */
+    deleteByToken(token: string): Promise<void>;
+}