@exode-team/multicard-uz.api 1.0.0

package/.eslintrc.js

@@ -0,0 +1,5 @@
+module.exports = {
+    env: {
+        jest: true,
+    },
+};

package/dist/helpers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Helpers
+ *
+ * @author: exode <hello@exode.ru>
+ */
+/**
+ * Проверка подписи callback (success)
+ * sign = MD5("{store_id}{invoice_id}{amount}{secret}")
+ */
+export declare const verifyCallbackSign: (payload: {
+    store_id: number | string;
+    invoice_id: string;
+    amount: number | string;
+    sign: string;
+}, secret: string) => boolean;
+/**
+ * Проверка подписи webhook (status change)
+ * sign = SHA1("{uuid}{invoice_id}{amount}{secret}")
+ */
+export declare const verifyWebhookSign: (payload: {
+    uuid: string;
+    sign: string;
+    amount: number | string;
+    invoice_id: string;
+}, secret: string) => boolean;

package/dist/helpers.js

@@ -0,0 +1,45 @@
+/**
+ * Helpers
+ *
+ * @author: exode <hello@exode.ru>
+ */
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "crypto"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.verifyWebhookSign = exports.verifyCallbackSign = void 0;
+    const crypto_1 = require("crypto");
+    /**
+     * Проверка подписи callback (success)
+     * sign = MD5("{store_id}{invoice_id}{amount}{secret}")
+     */
+    const verifyCallbackSign = (payload, secret) => {
+        const { amount, invoice_id, sign, store_id, } = payload;
+        const dataToHash = `${store_id}${invoice_id}${amount}${secret}`;
+        const calculatedSign = (0, crypto_1.createHash)('md5')
+            .update(dataToHash)
+            .digest('hex');
+        return sign === calculatedSign;
+    };
+    exports.verifyCallbackSign = verifyCallbackSign;
+    /**
+     * Проверка подписи webhook (status change)
+     * sign = SHA1("{uuid}{invoice_id}{amount}{secret}")
+     */
+    const verifyWebhookSign = (payload, secret) => {
+        const { amount, invoice_id, sign, uuid, } = payload;
+        const dataToHash = `${uuid}${invoice_id}${amount}${secret}`;
+        const calculatedSign = (0, crypto_1.createHash)('sha1')
+            .update(dataToHash)
+            .digest('hex');
+        return sign === calculatedSign;
+    };
+    exports.verifyWebhookSign = verifyWebhookSign;
+});

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Index
+ *
+ * @author: exode <hello@exode.ru>
+ */
+export * from './types';
+export * from './helpers';
+export * from './multicard-api';

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * Index
+ *
+ * @author: exode <hello@exode.ru>
+ */
+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);
+};
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "./types", "./helpers", "./multicard-api"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    __exportStar(require("./types"), exports);
+    __exportStar(require("./helpers"), exports);
+    __exportStar(require("./multicard-api"), exports);
+});

package/dist/multicard-api.d.ts

@@ -0,0 +1,142 @@
+/**
+ * MulticardApi
+ *
+ * @author: exode <hello@exode.ru>
+ */
+import { MulticardBase } from './multicard-base';
+import { AuthGetTokenResponse, CardBindCreateRequest, CardBindCreateResponse, CardBindGetStatusResponse, CardDeleteResponse, CardGetResponse, FiscalSendLinkRequest, FiscalSendLinkResponse, InvoiceCreateRequest, InvoiceCreateResponse, InvoiceDeleteResponse, InvoiceGetResponse, MulticardResponse, PaymentCancelResponse, PaymentConfirmRequest, PaymentConfirmResponse, PaymentCreateByTokenRequest, PaymentCreateResponse, PaymentGetResponse, PaymentPartialRefundRequest, PaymentPartialRefundResponse } from './types';
+export declare class MulticardApi extends MulticardBase {
+    /**
+     * Запрос к API
+     * @param {string} apiUrl
+     * @param {Record<any, any>} data
+     * @param {Record<any, any>} headers
+     * @param {'post' | 'get' | 'put' | 'delete' | 'patch'} httpMethod
+     * @returns {Promise<T>}
+     * @private
+     */
+    private requestApi;
+    /**
+     * ===========================
+     * Auth
+     * ===========================
+     */
+    /**
+     * Получение JWT-токена (24ч)
+     * @param {string} applicationId
+     * @param {string} secret
+     * @returns {Promise<MulticardResponse<AuthGetTokenResponse>>}
+     */
+    getToken(applicationId: string, secret: string): Promise<MulticardResponse<AuthGetTokenResponse>>;
+    /**
+     * ===========================
+     * Invoice (checkout redirect)
+     * ===========================
+     */
+    /**
+     * Создание инвойса
+     * @param {InvoiceCreateRequest} request
+     * @returns {Promise<InvoiceCreateResponse>}
+     */
+    createInvoice(request: InvoiceCreateRequest): Promise<InvoiceCreateResponse>;
+    /**
+     * Получение информации об инвойсе
+     * @param {string} uuid
+     * @returns {Promise<InvoiceGetResponse>}
+     */
+    getInvoice(uuid: string): Promise<InvoiceGetResponse>;
+    /**
+     * Удаление/аннулирование инвойса
+     * @param {string} uuid
+     * @returns {Promise<InvoiceDeleteResponse>}
+     */
+    deleteInvoice(uuid: string): Promise<InvoiceDeleteResponse>;
+    /**
+     * ===========================
+     * Card Binding (Form)
+     * ===========================
+     */
+    /**
+     * Создание сессии привязки карты (redirect на форму Multicard)
+     * @param {CardBindCreateRequest} request
+     * @returns {Promise<CardBindCreateResponse>}
+     */
+    createBindSession(request: CardBindCreateRequest): Promise<CardBindCreateResponse>;
+    /**
+     * Проверка статуса привязки карты
+     * @param {string} sessionId
+     * @returns {Promise<CardBindGetStatusResponse>}
+     */
+    getBindStatus(sessionId: string): Promise<CardBindGetStatusResponse>;
+    /**
+     * ===========================
+     * Card Management
+     * ===========================
+     */
+    /**
+     * Получение информации о карте по токену
+     * @param {string} cardToken
+     * @returns {Promise<CardGetResponse>}
+     */
+    getCard(cardToken: string): Promise<CardGetResponse>;
+    /**
+     * Аннулирование токена карты
+     * @param {string} cardToken
+     * @returns {Promise<CardDeleteResponse>}
+     */
+    removeCard(cardToken: string): Promise<CardDeleteResponse>;
+    /**
+     * ===========================
+     * Payment by Token
+     * ===========================
+     */
+    /**
+     * Создание платежа по токену карты
+     * @param {PaymentCreateByTokenRequest} request
+     * @returns {Promise<PaymentCreateResponse>}
+     */
+    createPayment(request: PaymentCreateByTokenRequest): Promise<PaymentCreateResponse>;
+    /**
+     * Подтверждение платежа (OTP или безакцептное)
+     * @param {string} paymentUuid
+     * @param {PaymentConfirmRequest} request
+     * @returns {Promise<PaymentConfirmResponse>}
+     */
+    confirmPayment(paymentUuid: string, request?: PaymentConfirmRequest): Promise<PaymentConfirmResponse>;
+    /**
+     * Получение информации о платеже
+     * @param {string} uuid
+     * @returns {Promise<PaymentGetResponse>}
+     */
+    getPayment(uuid: string): Promise<PaymentGetResponse>;
+    /**
+     * ===========================
+     * Refund
+     * ===========================
+     */
+    /**
+     * Полная отмена платежа (полный возврат)
+     * @param {string} uuid
+     * @returns {Promise<PaymentCancelResponse>}
+     */
+    cancelPayment(uuid: string): Promise<PaymentCancelResponse>;
+    /**
+     * Частичный возврат
+     * @param {string} uuid
+     * @param {PaymentPartialRefundRequest} request
+     * @returns {Promise<PaymentPartialRefundResponse>}
+     */
+    partialRefund(uuid: string, request: PaymentPartialRefundRequest): Promise<PaymentPartialRefundResponse>;
+    /**
+     * ===========================
+     * Fiscal
+     * ===========================
+     */
+    /**
+     * Отправка фискальной ссылки
+     * @param {string} paymentUuid
+     * @param {FiscalSendLinkRequest} request
+     * @returns {Promise<FiscalSendLinkResponse>}
+     */
+    sendFiscalLink(paymentUuid: string, request: FiscalSendLinkRequest): Promise<FiscalSendLinkResponse>;
+}

package/dist/multicard-api.js

@@ -0,0 +1,220 @@
+/**
+ * MulticardApi
+ *
+ * @author: exode <hello@exode.ru>
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "axios", "./multicard-base"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.MulticardApi = void 0;
+    const axios_1 = __importDefault(require("axios"));
+    const multicard_base_1 = require("./multicard-base");
+    class MulticardApi extends multicard_base_1.MulticardBase {
+        /**
+         * Запрос к API
+         * @param {string} apiUrl
+         * @param {Record<any, any>} data
+         * @param {Record<any, any>} headers
+         * @param {'post' | 'get' | 'put' | 'delete' | 'patch'} httpMethod
+         * @returns {Promise<T>}
+         * @private
+         */
+        requestApi(apiUrl_1) {
+            return __awaiter(this, arguments, void 0, function* (apiUrl, data = {}, headers, httpMethod = 'post') {
+                const config = {
+                    timeout: this.timeoutMs,
+                    url: `${this.baseUrl}${apiUrl}`,
+                    method: httpMethod,
+                    maxBodyLength: Infinity,
+                    data: httpMethod !== 'get' ? data : {},
+                    params: httpMethod === 'get' ? data : {},
+                    headers: Object.assign(Object.assign({ 'Accept': 'application/json', 'Content-Type': 'application/json' }, (this.accessToken ? { 'Authorization': `Bearer ${this.accessToken}` } : {})), headers),
+                };
+                if (this.mode === 'sandbox') {
+                    console.log('[PACKAGE:multicard-uz.api]', JSON.stringify(config));
+                }
+                try {
+                    const response = yield axios_1.default.request(config);
+                    return response.data;
+                }
+                catch (error) {
+                    const response = error === null || error === void 0 ? void 0 : error.response;
+                    console.error('[PACKAGE:multicard-uz.api]', `status=${response === null || response === void 0 ? void 0 : response.status}`, `config=[${JSON.stringify(config)}]`, JSON.stringify(response === null || response === void 0 ? void 0 : response.data));
+                    throw error;
+                }
+            });
+        }
+        /**
+         * ===========================
+         * Auth
+         * ===========================
+         */
+        /**
+         * Получение JWT-токена (24ч)
+         * @param {string} applicationId
+         * @param {string} secret
+         * @returns {Promise<MulticardResponse<AuthGetTokenResponse>>}
+         */
+        getToken(applicationId, secret) {
+            return this.requestApi('/auth', { secret, application_id: applicationId });
+        }
+        /**
+         * ===========================
+         * Invoice (checkout redirect)
+         * ===========================
+         */
+        /**
+         * Создание инвойса
+         * @param {InvoiceCreateRequest} request
+         * @returns {Promise<InvoiceCreateResponse>}
+         */
+        createInvoice(request) {
+            return this.requestApi('/payment/invoice', request);
+        }
+        /**
+         * Получение информации об инвойсе
+         * @param {string} uuid
+         * @returns {Promise<InvoiceGetResponse>}
+         */
+        getInvoice(uuid) {
+            return this.requestApi(`/payment/invoice/${uuid}`, {}, undefined, 'get');
+        }
+        /**
+         * Удаление/аннулирование инвойса
+         * @param {string} uuid
+         * @returns {Promise<InvoiceDeleteResponse>}
+         */
+        deleteInvoice(uuid) {
+            return this.requestApi(`/payment/invoice/${uuid}`, {}, undefined, 'delete');
+        }
+        /**
+         * ===========================
+         * Card Binding (Form)
+         * ===========================
+         */
+        /**
+         * Создание сессии привязки карты (redirect на форму Multicard)
+         * @param {CardBindCreateRequest} request
+         * @returns {Promise<CardBindCreateResponse>}
+         */
+        createBindSession(request) {
+            return this.requestApi('/payment/card/bind', request);
+        }
+        /**
+         * Проверка статуса привязки карты
+         * @param {string} sessionId
+         * @returns {Promise<CardBindGetStatusResponse>}
+         */
+        getBindStatus(sessionId) {
+            return this.requestApi(`/payment/card/bind/${sessionId}`, {}, undefined, 'get');
+        }
+        /**
+         * ===========================
+         * Card Management
+         * ===========================
+         */
+        /**
+         * Получение информации о карте по токену
+         * @param {string} cardToken
+         * @returns {Promise<CardGetResponse>}
+         */
+        getCard(cardToken) {
+            return this.requestApi(`/payment/card/${cardToken}`, {}, undefined, 'get');
+        }
+        /**
+         * Аннулирование токена карты
+         * @param {string} cardToken
+         * @returns {Promise<CardDeleteResponse>}
+         */
+        removeCard(cardToken) {
+            return this.requestApi(`/payment/card/${cardToken}`, {}, undefined, 'delete');
+        }
+        /**
+         * ===========================
+         * Payment by Token
+         * ===========================
+         */
+        /**
+         * Создание платежа по токену карты
+         * @param {PaymentCreateByTokenRequest} request
+         * @returns {Promise<PaymentCreateResponse>}
+         */
+        createPayment(request) {
+            return this.requestApi('/payment', request);
+        }
+        /**
+         * Подтверждение платежа (OTP или безакцептное)
+         * @param {string} paymentUuid
+         * @param {PaymentConfirmRequest} request
+         * @returns {Promise<PaymentConfirmResponse>}
+         */
+        confirmPayment(paymentUuid, request = {}) {
+            return this.requestApi(`/payment/${paymentUuid}`, request, undefined, 'put');
+        }
+        /**
+         * Получение информации о платеже
+         * @param {string} uuid
+         * @returns {Promise<PaymentGetResponse>}
+         */
+        getPayment(uuid) {
+            return this.requestApi(`/payment/${uuid}`, {}, undefined, 'get');
+        }
+        /**
+         * ===========================
+         * Refund
+         * ===========================
+         */
+        /**
+         * Полная отмена платежа (полный возврат)
+         * @param {string} uuid
+         * @returns {Promise<PaymentCancelResponse>}
+         */
+        cancelPayment(uuid) {
+            return this.requestApi(`/payment/${uuid}`, {}, undefined, 'delete');
+        }
+        /**
+         * Частичный возврат
+         * @param {string} uuid
+         * @param {PaymentPartialRefundRequest} request
+         * @returns {Promise<PaymentPartialRefundResponse>}
+         */
+        partialRefund(uuid, request) {
+            return this.requestApi(`/payment/${uuid}/partial`, request, undefined, 'delete');
+        }
+        /**
+         * ===========================
+         * Fiscal
+         * ===========================
+         */
+        /**
+         * Отправка фискальной ссылки
+         * @param {string} paymentUuid
+         * @param {FiscalSendLinkRequest} request
+         * @returns {Promise<FiscalSendLinkResponse>}
+         */
+        sendFiscalLink(paymentUuid, request) {
+            return this.requestApi(`/payment/${paymentUuid}/fiscal`, request, undefined, 'patch');
+        }
+    }
+    exports.MulticardApi = MulticardApi;
+});

package/dist/multicard-base.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MulticardBase
+ *
+ * @author: exode <hello@exode.ru>
+ */
+import { MulticardApiConfig } from './types';
+export declare class MulticardBase {
+    constructor(options: MulticardApiConfig);
+    /**
+     * Токен авторизации
+     * @type {string | null}
+     * @protected
+     */
+    protected accessToken: string | null;
+    /**
+     * Окружение исполнения
+     * @type {MulticardApiConfig['mode']}
+     * @protected
+     */
+    protected readonly mode: MulticardApiConfig['mode'];
+    /**
+     * Таймаут (MS)
+     * @type {MulticardApiConfig['timeoutMs']}
+     * @protected
+     */
+    protected readonly timeoutMs: MulticardApiConfig['timeoutMs'];
+    /**
+     * Base URL по окружению
+     * @returns {string}
+     * @protected
+     */
+    protected get baseUrl(): string;
+    /**
+     * Установка токена
+     * @param {string} token
+     */
+    setAccessToken(token: string): void;
+}

package/dist/multicard-base.js

@@ -0,0 +1,49 @@
+/**
+ * MulticardBase
+ *
+ * @author: exode <hello@exode.ru>
+ */
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.MulticardBase = void 0;
+    class MulticardBase {
+        constructor(options) {
+            var _a, _b;
+            /**
+             * Токен авторизации
+             * @type {string | null}
+             * @protected
+             */
+            this.accessToken = null;
+            this.mode = (_a = options.mode) !== null && _a !== void 0 ? _a : 'production';
+            this.timeoutMs = (_b = options.timeoutMs) !== null && _b !== void 0 ? _b : 30000;
+        }
+        /**
+         * Base URL по окружению
+         * @returns {string}
+         * @protected
+         */
+        get baseUrl() {
+            return this.mode === 'sandbox'
+                ? 'https://dev-mesh.multicard.uz'
+                : 'https://mesh.multicard.uz';
+        }
+        /**
+         * Установка токена
+         * @param {string} token
+         */
+        setAccessToken(token) {
+            this.accessToken = token;
+        }
+    }
+    exports.MulticardBase = MulticardBase;
+});

package/dist/types.d.ts

@@ -0,0 +1,372 @@
+/**
+ * Types
+ *
+ * @author: exode <hello@exode.ru>
+ */
+/**
+ * @Common:
+ */
+export interface MulticardApiConfig {
+    mode?: 'production' | 'sandbox';
+    timeoutMs?: number;
+}
+export interface MulticardSuccessResponse<T = any> {
+    success: true;
+    data: T;
+}
+export interface MulticardErrorResponse {
+    success: false;
+    error: {
+        code: MulticardErrorCode;
+        details: string;
+    };
+}
+export type MulticardResponse<T = any> = MulticardSuccessResponse<T> | MulticardErrorResponse;
+export declare enum MulticardErrorCode {
+    ERROR_FIELDS = "ERROR_FIELDS",
+    ERROR_NOT_FOUND = "ERROR_NOT_FOUND",
+    ERROR_CARD_NOT_FOUND = "ERROR_CARD_NOT_FOUND",
+    ERROR_WRONG_OTP = "ERROR_WRONG_OTP",
+    ERROR_SMS_ALREADY_SENT = "ERROR_SMS_ALREADY_SENT",
+    ERROR_CARD_SMS = "ERROR_CARD_SMS",
+    ERROR_TRANS_NOT_READY = "ERROR_TRANS_NOT_READY",
+    ERROR_DEBIT_UNKNOWN = "ERROR_DEBIT_UNKNOWN",
+    ERROR_CALLBACK_TIMEOUT = "ERROR_CALLBACK_TIMEOUT",
+    ERROR_UNKNOWN = "ERROR_UNKNOWN"
+}
+export declare enum MulticardPaymentStatus {
+    Draft = "draft",
+    Progress = "progress",
+    Billing = "billing",
+    Success = "success",
+    Error = "error",
+    Revert = "revert",
+    Hold = "hold"
+}
+export declare enum MulticardPaymentService {
+    Uzcard = "uzcard",
+    Humo = "humo",
+    Visa = "visa",
+    Mastercard = "mastercard",
+    Account = "account",
+    Payme = "payme",
+    Click = "click",
+    Uzum = "uzum",
+    Anorbank = "anorbank",
+    Oson = "oson",
+    Alif = "alif",
+    Xazna = "xazna",
+    Beepul = "beepul",
+    Trastpay = "trastpay",
+    Sbp = "sbp"
+}
+export declare enum MulticardCommissionType {
+    Up = "up",
+    Down = "down"
+}
+export declare enum MulticardCardStatus {
+    Active = "active",
+    Inactive = "inactive"
+}
+/**
+ * @Auth:
+ */
+export interface AuthGetTokenRequest {
+    application_id: string;
+    secret: string;
+}
+export interface AuthGetTokenResponse {
+    token: string;
+    role: string;
+    expiry: string;
+}
+/**
+ * @Invoice:
+ */
+export interface OfdItem {
+    /** Количество товара */
+    qty: number;
+    /** Цена за единицу (тийины) */
+    price: number;
+    /** ИКПУ код товара */
+    mxik: string;
+    /** Итого (тийины) */
+    total: number;
+    /** Код упаковки */
+    package_code: string;
+    /** Наименование товара/услуги */
+    name: string;
+    /** Ставка НДС (%) */
+    vat: number;
+    /** ИНН продавца */
+    tin: string;
+    /** Маркировка (может быть null) */
+    mark?: string | null;
+}
+export interface InvoiceCreateRequest {
+    /** Идентификатор магазина */
+    store_id: number;
+    /** Сумма платежа (тийины) */
+    amount: number;
+    /** Идентификатор инвойса на стороне партнёра */
+    invoice_id: string;
+    /** URL для редиректа после оплаты */
+    return_url?: string;
+    /** URL для callback при успешной оплате */
+    callback_url?: string;
+    /** Данные для фискализации */
+    ofd?: OfdItem[];
+    /** Описание платежа */
+    description?: string;
+}
+export interface InvoiceModel {
+    /** UUID инвойса */
+    uuid: string;
+    /** Идентификатор магазина */
+    store_id: number;
+    /** Сумма (тийины) */
+    amount: number;
+    /** Идентификатор инвойса на стороне партнёра */
+    invoice_id: string;
+    /** Статус платежа */
+    status: MulticardPaymentStatus;
+    /** URL для редиректа на страницу оплаты */
+    checkout_url: string;
+    /** URL для редиректа после оплаты */
+    return_url?: string;
+    /** URL для callback */
+    callback_url?: string;
+    /** URL чека */
+    receipt_url?: string | null;
+}
+export type InvoiceCreateResponse = MulticardSuccessResponse<InvoiceModel>;
+export type InvoiceGetResponse = MulticardSuccessResponse<InvoiceModel>;
+export type InvoiceDeleteResponse = MulticardSuccessResponse<void>;
+/**
+ * @Card Binding (Form):
+ */
+export interface CardBindCreateRequest {
+    /** Идентификатор магазина */
+    store_id: number;
+    /** URL для редиректа после успешной привязки */
+    redirect_url: string;
+    /** URL для редиректа при отклонении привязки */
+    redirect_decline_url: string;
+    /** URL для callback с данными привязки */
+    callback_url: string;
+    /** Идентификатор пользователя на стороне партнёра */
+    payer_id?: string;
+}
+export interface CardBindSession {
+    /** Идентификатор сессии привязки */
+    session_id: string;
+    /** URL формы привязки карты (для redirect) */
+    form_url: string;
+}
+export type CardBindCreateResponse = MulticardSuccessResponse<CardBindSession>;
+export interface CardBindStatusData {
+    /** Идентификатор сессии привязки */
+    session_id: string;
+    /** Статус привязки */
+    status: string;
+    /** Данные карты (при успешной привязке) */
+    card?: CardModel;
+}
+export type CardBindGetStatusResponse = MulticardSuccessResponse<CardBindStatusData>;
+/**
+ * @Card Binding Callback:
+ */
+export interface CardBindCallbackPayload {
+    /** Токен привязанной карты */
+    card_token: string;
+    /** Маскированный номер карты */
+    card_pan: string;
+    /** Номер телефона держателя карты */
+    phone: string;
+    /** Платёжная система */
+    ps: MulticardPaymentService;
+    /** Имя держателя карты */
+    holder_name?: string;
+    /** Идентификатор пользователя */
+    payer_id?: string;
+}
+/**
+ * @Card Management:
+ */
+export interface CardModel {
+    /** ID карты */
+    id: number;
+    /** ID приложения */
+    application_id: number;
+    /** Идентификатор пользователя */
+    payer_id: string;
+    /** Маскированный номер карты */
+    card_pan: string;
+    /** Токен карты */
+    card_token: string;
+    /** Номер телефона */
+    phone: string;
+    /** Имя держателя карты */
+    holder_name: string;
+    /** ПИНФЛ (может быть null) */
+    pinfl: string | null;
+    /** Платёжная система */
+    ps: MulticardPaymentService;
+    /** Статус карты */
+    status: MulticardCardStatus;
+    /** Дата добавления */
+    added_on: string;
+    /** Статус карты (от эмитента) */
+    card_status: {
+        code: number;
+        description: string;
+    };
+    /** Подключено ли SMS-информирование */
+    sms_inform: boolean;
+}
+export type CardGetResponse = MulticardSuccessResponse<CardModel>;
+export type CardDeleteResponse = MulticardSuccessResponse<void>;
+/**
+ * @Payment:
+ */
+export interface PaymentCreateByTokenRequest {
+    /** Данные карты (по токену) */
+    card: {
+        token: string;
+    };
+    /** Сумма платежа (тийины) */
+    amount: number;
+    /** Идентификатор магазина */
+    store_id: number;
+    /** Идентификатор инвойса на стороне партнёра */
+    invoice_id: string;
+    /** URL для callback при успешной оплате */
+    callback_url?: string;
+    /** Данные для фискализации */
+    ofd?: OfdItem[];
+    /** Информация об устройстве */
+    device_details?: Record<string, any>;
+}
+export interface PaymentModel {
+    /** ID платежа */
+    id: number;
+    /** UUID платежа */
+    uuid: string;
+    /** Идентификатор магазина */
+    store_id: number;
+    /** Сумма платежа (тийины) */
+    payment_amount: number;
+    /** Тип комиссии */
+    commission_type: MulticardCommissionType;
+    /** Сумма комиссии (тийины) */
+    commission_amount: number;
+    /** Итоговая сумма (тийины) */
+    total_amount: number;
+    /** Идентификатор инвойса на стороне партнёра */
+    store_invoice_id: string;
+    /** Статус платежа */
+    status: MulticardPaymentStatus;
+    /** URL для callback */
+    callback_url: string;
+    /** Идентификатор биллинга */
+    billing_id: string;
+    /** Номер телефона */
+    phone: string;
+    /** Платёжная система */
+    ps: MulticardPaymentService;
+    /** URL чека */
+    receipt_url: string | null;
+    /** Хеш OTP (null = безакцептный платёж) */
+    otp_hash: string | null;
+    /** KYC данные */
+    kyc_data: {
+        last_name: string;
+        first_name: string;
+        middle_name: string;
+        pinfl: string;
+    } | null;
+    /** URL для checkout (для инвойсов) */
+    checkout_url: string | null;
+}
+export interface PaymentConfirmRequest {
+    /** OTP код (необязательный при безакцептном платеже) */
+    otp?: string;
+}
+export type PaymentCreateResponse = MulticardSuccessResponse<PaymentModel>;
+export type PaymentConfirmResponse = MulticardSuccessResponse<PaymentModel>;
+export type PaymentGetResponse = MulticardSuccessResponse<PaymentModel>;
+export type PaymentCancelResponse = MulticardSuccessResponse<PaymentModel>;
+export interface PaymentPartialRefundRequest {
+    /** Маскированный номер карты */
+    card_pan: string;
+    /** Сумма возврата (тийины) */
+    refund_amount: number;
+    /** Данные для фискализации */
+    ofd?: OfdItem[];
+}
+export type PaymentPartialRefundResponse = MulticardSuccessResponse<PaymentModel>;
+/**
+ * @Fiscal:
+ */
+export interface FiscalSendLinkRequest {
+    /** URL фискального чека */
+    url: string;
+}
+export type FiscalSendLinkResponse = MulticardSuccessResponse<void>;
+/**
+ * @Callbacks (Webhooks):
+ */
+export interface CallbackSuccessPayload {
+    /** Идентификатор магазина */
+    store_id: number;
+    /** Сумма (тийины) */
+    amount: number;
+    /** Идентификатор инвойса */
+    invoice_id: string;
+    /** Идентификатор биллинга */
+    billing_id: string;
+    /** Время платежа */
+    payment_time: string;
+    /** Номер телефона */
+    phone: string;
+    /** Маскированный номер карты */
+    card_pan: string;
+    /** Платёжная система */
+    ps: MulticardPaymentService;
+    /** Токен карты */
+    card_token: string;
+    /** UUID платежа */
+    uuid: string;
+    /** URL чека */
+    receipt_url: string;
+    /** Подпись MD5("{store_id}{invoice_id}{amount}{secret}") */
+    sign: string;
+}
+export interface WebhookStatusPayload {
+    /** UUID платежа */
+    uuid: string;
+    /** Сумма (тийины) */
+    amount: number;
+    /** Идентификатор инвойса */
+    invoice_id: string;
+    /** Статус платежа */
+    status: MulticardPaymentStatus;
+    /** Идентификатор биллинга */
+    billing_id: string;
+    /** Время платежа */
+    payment_time: string;
+    /** Время возврата (null если не было возврата) */
+    refund_time: string | null;
+    /** Номер телефона */
+    phone: string;
+    /** Маскированный номер карты */
+    card_pan: string;
+    /** Платёжная система */
+    ps: MulticardPaymentService;
+    /** Токен карты */
+    card_token: string;
+    /** URL чека */
+    receipt_url: string | null;
+    /** Подпись SHA1("{uuid}{invoice_id}{amount}{secret}") */
+    sign: string;
+}

package/dist/types.js

@@ -0,0 +1,69 @@
+/**
+ * Types
+ *
+ * @author: exode <hello@exode.ru>
+ */
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.MulticardCardStatus = exports.MulticardCommissionType = exports.MulticardPaymentService = exports.MulticardPaymentStatus = exports.MulticardErrorCode = void 0;
+    var MulticardErrorCode;
+    (function (MulticardErrorCode) {
+        MulticardErrorCode["ERROR_FIELDS"] = "ERROR_FIELDS";
+        MulticardErrorCode["ERROR_NOT_FOUND"] = "ERROR_NOT_FOUND";
+        MulticardErrorCode["ERROR_CARD_NOT_FOUND"] = "ERROR_CARD_NOT_FOUND";
+        MulticardErrorCode["ERROR_WRONG_OTP"] = "ERROR_WRONG_OTP";
+        MulticardErrorCode["ERROR_SMS_ALREADY_SENT"] = "ERROR_SMS_ALREADY_SENT";
+        MulticardErrorCode["ERROR_CARD_SMS"] = "ERROR_CARD_SMS";
+        MulticardErrorCode["ERROR_TRANS_NOT_READY"] = "ERROR_TRANS_NOT_READY";
+        MulticardErrorCode["ERROR_DEBIT_UNKNOWN"] = "ERROR_DEBIT_UNKNOWN";
+        MulticardErrorCode["ERROR_CALLBACK_TIMEOUT"] = "ERROR_CALLBACK_TIMEOUT";
+        MulticardErrorCode["ERROR_UNKNOWN"] = "ERROR_UNKNOWN";
+    })(MulticardErrorCode || (exports.MulticardErrorCode = MulticardErrorCode = {}));
+    var MulticardPaymentStatus;
+    (function (MulticardPaymentStatus) {
+        MulticardPaymentStatus["Draft"] = "draft";
+        MulticardPaymentStatus["Progress"] = "progress";
+        MulticardPaymentStatus["Billing"] = "billing";
+        MulticardPaymentStatus["Success"] = "success";
+        MulticardPaymentStatus["Error"] = "error";
+        MulticardPaymentStatus["Revert"] = "revert";
+        MulticardPaymentStatus["Hold"] = "hold";
+    })(MulticardPaymentStatus || (exports.MulticardPaymentStatus = MulticardPaymentStatus = {}));
+    var MulticardPaymentService;
+    (function (MulticardPaymentService) {
+        MulticardPaymentService["Uzcard"] = "uzcard";
+        MulticardPaymentService["Humo"] = "humo";
+        MulticardPaymentService["Visa"] = "visa";
+        MulticardPaymentService["Mastercard"] = "mastercard";
+        MulticardPaymentService["Account"] = "account";
+        MulticardPaymentService["Payme"] = "payme";
+        MulticardPaymentService["Click"] = "click";
+        MulticardPaymentService["Uzum"] = "uzum";
+        MulticardPaymentService["Anorbank"] = "anorbank";
+        MulticardPaymentService["Oson"] = "oson";
+        MulticardPaymentService["Alif"] = "alif";
+        MulticardPaymentService["Xazna"] = "xazna";
+        MulticardPaymentService["Beepul"] = "beepul";
+        MulticardPaymentService["Trastpay"] = "trastpay";
+        MulticardPaymentService["Sbp"] = "sbp";
+    })(MulticardPaymentService || (exports.MulticardPaymentService = MulticardPaymentService = {}));
+    var MulticardCommissionType;
+    (function (MulticardCommissionType) {
+        MulticardCommissionType["Up"] = "up";
+        MulticardCommissionType["Down"] = "down";
+    })(MulticardCommissionType || (exports.MulticardCommissionType = MulticardCommissionType = {}));
+    var MulticardCardStatus;
+    (function (MulticardCardStatus) {
+        MulticardCardStatus["Active"] = "active";
+        MulticardCardStatus["Inactive"] = "inactive";
+    })(MulticardCardStatus || (exports.MulticardCardStatus = MulticardCardStatus = {}));
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@exode-team/multicard-uz.api",
+  "version": "1.0.0",
+  "description": "multicard.uz API",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "yarn clean && tsc && yarn copy-definitions",
+    "build:watch": "yarn clean && tsc-watch",
+    "lint": "eslint -c ./.eslintrc.js ./src --ext .ts,.js --fix",
+    "lint:test": "eslint -c ./.eslintrc.js ./src --ext .ts,.js",
+    "clean": "rimraf dist",
+    "copy-definitions": "copyfiles -u 1 \"src/**/*.d.ts\" dist",
+    "npm:publish": "npm run build && npm publish",
+    "test": "npx ts-node api-test.ts"
+  },
+  "dependencies": {
+    "axios": "1.8.4"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.24.3",
+    "@babel/preset-env": "^7.24.3",
+    "@babel/preset-typescript": "^7.24.1",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.12.12",
+    "babel-jest": "^29.7.0",
+    "copyfiles": "^2.4.1",
+    "eslint": "^8.57.0",
+    "jest": "^29.7.0",
+    "rimraf": "^5.0.5",
+    "ts-jest": "^29.1.2",
+    "ts-watch": "^1.0.8",
+    "typescript": "^5.4.3"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "es6",
+    "module": "umd",
+    "strict": true,
+    "allowJs": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "moduleResolution": "node",
+    "baseUrl": "./src",
+    "paths": {},
+    "esModuleInterop": true
+  },
+  "include": [
+    "./src/**/*"
+  ]
+}