liqpay-nestjs 0.2.1

package/README.md

@@ -0,0 +1,15 @@
+# liqpay-nestjs
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.10. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/core/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const LIQPAY_REQUEST_URL = "https://www.liqpay.ua/api/request";
+export declare const LIQPAY_CHECKOUT_URL = "https://www.liqpay.ua/api/3/checkout";
+export type LiqPayApiPath = typeof LIQPAY_REQUEST_URL | typeof LIQPAY_CHECKOUT_URL;

package/dist/core/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIQPAY_CHECKOUT_URL = exports.LIQPAY_REQUEST_URL = void 0;
+const LIQPAY_HOST_URL = 'https://www.liqpay.ua';
+const LIQPAY_BASE_URL = `${LIQPAY_HOST_URL}/api`;
+exports.LIQPAY_REQUEST_URL = `${LIQPAY_BASE_URL}/request`;
+exports.LIQPAY_CHECKOUT_URL = `${LIQPAY_BASE_URL}/3/checkout`;

package/dist/core/index.d.ts

@@ -0,0 +1 @@
+export * from './liqpay.client';

package/dist/core/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("./liqpay.client"), exports);

package/dist/core/liqpay.client.d.ts

@@ -0,0 +1,65 @@
+import { LiqPayCallResult, LiqPayEnvelope } from './schemas/base';
+import { LiqPayCheckoutCallback, type LiqPayCheckoutRequest } from './schemas/checkout';
+import { LiqPayPaymentStatusResponse } from './schemas/payment-status';
+/**
+ * workflow:
+ * 1) user register liqpay client where it needs to
+ * 2) user builds data for request and call client method
+ * 3) in client method data filled with key and got encoded
+ * 4) client gets response with encoded data and signature
+ * 5) client method decode data and returns it
+ * 6) user gets only decoded data from response
+ *
+ * So this API only provides requests methods and returns encoded data from responses
+ *
+ * On request user:
+ * 1) build typed data for request
+ * 2) calls method from client
+ *
+ * On response/callback user:
+ * 1) gets typed data from response/callback
+ *
+ * - on request user works only with typed data that stringifies and inserts into data field of envelope
+ * - on response user works only with typed data that parses from decoded string layed in data field on envelope
+ *
+ * On request client:
+ * 1) gets typed data object from user
+ * 2) calls call api method
+ * 3) validates typed data via zod
+ * 4) maps typed data to form that LiqPay API expects it
+ * 5) encodes typed data to string
+ * 6) sends request with envelope that contains data: encoded string with data and signature
+ *
+ * On response/callback client:
+ * 1) gets response/callback with envelope that contains data: encoded string with data and signature
+ * 2) decodes and parse encoded string from data field in envelope
+ * 3) maps encoded data to typed data
+ * 4) validates typed data
+ * 5) returns typed data to user
+ *
+ * For request build envelope with:
+ * 1) data - stringified json encoded with base64
+ * 2) signature - encoded base64(sha3-256(privateKey+data+privateKey))
+ */
+/**
+ * Client for easy interaction with LiqPay API
+ */
+export declare class LiqPayClient {
+    private readonly publicKey;
+    private readonly privateKey;
+    constructor(publicKey: string, privateKey: string);
+    private encodeData;
+    private decodeData;
+    private createSignature;
+    private getCredentials;
+    private isValidSignature;
+    private createError;
+    private parseData;
+    private parseError;
+    private parseEnvelope;
+    private call;
+    getPaymentStatus(orderId: string): Promise<LiqPayCallResult<LiqPayPaymentStatusResponse>>;
+    getCheckoutUrl(payload: LiqPayCheckoutRequest): string;
+    getCheckoutFormButton(payload: LiqPayCheckoutRequest, buttonText?: string, buttonColor?: string): string;
+    parseCheckoutCallback(envelope: LiqPayEnvelope): LiqPayCallResult<LiqPayCheckoutCallback>;
+}

package/dist/core/liqpay.client.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiqPayClient = void 0;
+const node_crypto_1 = require("node:crypto");
+const constants_1 = require("./constants");
+const checkout_1 = require("./schemas/checkout");
+const error_1 = require("./schemas/error");
+const payment_status_1 = require("./schemas/payment-status");
+/**
+ * workflow:
+ * 1) user register liqpay client where it needs to
+ * 2) user builds data for request and call client method
+ * 3) in client method data filled with key and got encoded
+ * 4) client gets response with encoded data and signature
+ * 5) client method decode data and returns it
+ * 6) user gets only decoded data from response
+ *
+ * So this API only provides requests methods and returns encoded data from responses
+ *
+ * On request user:
+ * 1) build typed data for request
+ * 2) calls method from client
+ *
+ * On response/callback user:
+ * 1) gets typed data from response/callback
+ *
+ * - on request user works only with typed data that stringifies and inserts into data field of envelope
+ * - on response user works only with typed data that parses from decoded string layed in data field on envelope
+ *
+ * On request client:
+ * 1) gets typed data object from user
+ * 2) calls call api method
+ * 3) validates typed data via zod
+ * 4) maps typed data to form that LiqPay API expects it
+ * 5) encodes typed data to string
+ * 6) sends request with envelope that contains data: encoded string with data and signature
+ *
+ * On response/callback client:
+ * 1) gets response/callback with envelope that contains data: encoded string with data and signature
+ * 2) decodes and parse encoded string from data field in envelope
+ * 3) maps encoded data to typed data
+ * 4) validates typed data
+ * 5) returns typed data to user
+ *
+ * For request build envelope with:
+ * 1) data - stringified json encoded with base64
+ * 2) signature - encoded base64(sha3-256(privateKey+data+privateKey))
+ */
+/**
+ * Client for easy interaction with LiqPay API
+ */
+class LiqPayClient {
+    publicKey;
+    privateKey;
+    constructor(publicKey, privateKey) {
+        this.publicKey = publicKey;
+        this.privateKey = privateKey;
+    }
+    encodeData(data) {
+        return Buffer.from(JSON.stringify(data)).toString('base64');
+    }
+    decodeData(encodedData) {
+        return JSON.parse(Buffer.from(encodedData, 'base64').toString('utf-8'));
+    }
+    createSignature(encodedData) {
+        const signatureString = `${this.privateKey}${encodedData}${this.privateKey}`;
+        return (0, node_crypto_1.createHash)('sha3-256').update(signatureString).digest('base64');
+    }
+    getCredentials(data) {
+        const payload = { ...data, public_key: this.publicKey };
+        const encoded = this.encodeData(payload);
+        const signature = this.createSignature(encoded);
+        return { data: encoded, signature };
+    }
+    isValidSignature(envelope) {
+        const expected = this.createSignature(envelope.data);
+        const a = Buffer.from(expected);
+        const b = Buffer.from(envelope.signature);
+        if (a.length !== b.length)
+            return false;
+        return (0, node_crypto_1.timingSafeEqual)(a, b);
+    }
+    createError(code, description) {
+        return { data: null, error: { code, description } };
+    }
+    parseData(schema, data) {
+        const error = this.parseError(data);
+        if (error)
+            return error;
+        const parsed = schema.safeParse(data);
+        if (!parsed.success)
+            return this.createError('validation_error', 'Invalid response schema');
+        return { data: parsed.data, error: null };
+    }
+    parseError(data) {
+        const parsed = error_1.LiqPayErrorResponseSchema.safeParse(data);
+        if (!parsed.success)
+            return null;
+        return this.createError(parsed.data.err_code, parsed.data.err_description);
+    }
+    parseEnvelope(envelope, schema) {
+        if (!this.isValidSignature(envelope))
+            return this.createError('invalid_signature', 'Invalid signature');
+        let rawData;
+        try {
+            rawData = this.decodeData(envelope.data);
+        }
+        catch {
+            return this.createError('decode_error', 'Failed to decode base64 data');
+        }
+        return this.parseData(schema, rawData);
+    }
+    async call(payload, rawSchema, responseSchema, url) {
+        const raw = rawSchema.parse(payload);
+        const envelope = this.getCredentials(raw);
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: new URLSearchParams(envelope),
+        });
+        if (!response.ok)
+            return this.createError('http_error', `HTTP ${response.status}`);
+        let rawData;
+        try {
+            rawData = await response.json();
+        }
+        catch {
+            return this.createError('invalid_response', 'Failed to parse JSON response');
+        }
+        return this.parseData(responseSchema, rawData);
+    }
+    async getPaymentStatus(orderId) {
+        return await this.call({ version: 7, action: 'status', orderId }, payment_status_1.LiqPayRawPaymentStatusRequestSchema, payment_status_1.LiqPayPaymentStatusResponseSchema, constants_1.LIQPAY_REQUEST_URL);
+    }
+    getCheckoutUrl(payload) {
+        const raw = checkout_1.LiqPayRawCheckoutRequestSchema.parse(payload);
+        const { data, signature } = this.getCredentials(raw);
+        return `${constants_1.LIQPAY_CHECKOUT_URL}?data=${data}&signature=${signature}`;
+    }
+    getCheckoutFormButton(payload, buttonText = 'Pay', buttonColor = '#77CC5D') {
+        const raw = checkout_1.LiqPayRawCheckoutRequestSchema.parse(payload);
+        const { data, signature } = this.getCredentials(raw);
+        return `
+      <form method="POST" action="${constants_1.LIQPAY_CHECKOUT_URL}" accept-charset="utf-8">
+        <input type="hidden" name="data" value="${data}" />
+        <input type="hidden" name="signature" value="${signature}" />
+        <script type="text/javascript" src="https://static.liqpay.ua/libjs/sdk_button.js"></script>
+        <sdk-button label="${buttonText}" background="${buttonColor}" onClick="submit()"></sdk-button>
+      </form>
+    `;
+    }
+    parseCheckoutCallback(envelope) {
+        return this.parseEnvelope(envelope, checkout_1.LiqPayCheckoutCallbackSchema);
+    }
+}
+exports.LiqPayClient = LiqPayClient;

package/dist/core/schemas/base/envelope.schema.d.ts

@@ -0,0 +1,6 @@
+import z from 'zod';
+export declare const LiqPayEnvelopeSchema: z.ZodObject<{
+    data: z.ZodString;
+    signature: z.ZodString;
+}, z.core.$strip>;
+export type LiqPayEnvelope = z.infer<typeof LiqPayEnvelopeSchema>;

package/dist/core/schemas/base/envelope.schema.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiqPayEnvelopeSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+exports.LiqPayEnvelopeSchema = zod_1.default.object({
+    data: zod_1.default.string().nonempty(),
+    signature: zod_1.default.string().nonempty(),
+});

package/dist/core/schemas/base/index.d.ts

@@ -0,0 +1,3 @@
+export * from './envelope.schema';
+export * from './request.type';
+export * from './response.type';

package/dist/core/schemas/base/index.js

@@ -0,0 +1,19 @@
+"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("./envelope.schema"), exports);
+__exportStar(require("./request.type"), exports);
+__exportStar(require("./response.type"), exports);

package/dist/core/schemas/base/request.type.d.ts

@@ -0,0 +1,4 @@
+import { LiqPayCheckoutRequest, LiqPayRawCheckoutRequest } from '../checkout';
+import { LiqPayPaymentStatusRequest, LiqPayRawPaymentStatusRequest } from '../payment-status';
+export type LiqPayRequest = LiqPayCheckoutRequest | LiqPayPaymentStatusRequest;
+export type LiqPayRawRequest = LiqPayRawCheckoutRequest | LiqPayRawPaymentStatusRequest;

package/dist/core/schemas/base/request.type.js

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

package/dist/core/schemas/base/response.type.d.ts

@@ -0,0 +1,15 @@
+import { LiqPayCheckoutCallback, LiqPayRawCheckoutCallback } from '../checkout';
+import { LiqPayErrorResponse } from '../error';
+import { LiqPayPaymentStatusResponse, LiqPayRawPaymentStatusResponse } from '../payment-status';
+export type LiqPayResponse = LiqPayCheckoutCallback | LiqPayPaymentStatusResponse;
+export type LiqPayRawResponse = LiqPayRawCheckoutCallback | LiqPayRawPaymentStatusResponse | LiqPayErrorResponse;
+export type LiqPayCallResult<T> = {
+    data: T;
+    error?: null;
+} | {
+    data: null;
+    error: {
+        code: string;
+        description: string;
+    };
+};

package/dist/core/schemas/base/response.type.js

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

package/dist/core/schemas/checkout/checkout-callback.schema.d.ts

@@ -0,0 +1,241 @@
+import { z } from 'zod';
+export declare const LiqPayRawCheckoutCallbackSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodNumber>;
+    public_key: z.ZodOptional<z.ZodString>;
+    acq_id: z.ZodOptional<z.ZodNumber>;
+    action: z.ZodOptional<z.ZodString>;
+    agent_commission: z.ZodOptional<z.ZodNumber>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    amount_bonus: z.ZodOptional<z.ZodNumber>;
+    amount_credit: z.ZodOptional<z.ZodNumber>;
+    amount_debit: z.ZodOptional<z.ZodNumber>;
+    authcode_credit: z.ZodOptional<z.ZodString>;
+    authcode_debit: z.ZodOptional<z.ZodString>;
+    card_token: z.ZodOptional<z.ZodString>;
+    commission_credit: z.ZodOptional<z.ZodNumber>;
+    commission_debit: z.ZodOptional<z.ZodNumber>;
+    completion_date: z.ZodOptional<z.ZodString>;
+    create_date: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+    currency_credit: z.ZodOptional<z.ZodString>;
+    currency_debit: z.ZodOptional<z.ZodString>;
+    customer: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    err_code: z.ZodOptional<z.ZodString>;
+    err_description: z.ZodOptional<z.ZodString>;
+    info: z.ZodOptional<z.ZodString>;
+    ip: z.ZodOptional<z.ZodString>;
+    is_3ds: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
+    liqpay_order_id: z.ZodOptional<z.ZodString>;
+    mpi_eci: z.ZodOptional<z.ZodNumber>;
+    order_id: z.ZodOptional<z.ZodString>;
+    payment_id: z.ZodOptional<z.ZodNumber>;
+    paytype: z.ZodOptional<z.ZodString>;
+    receiver_commission: z.ZodOptional<z.ZodNumber>;
+    redirect_to: z.ZodOptional<z.ZodString>;
+    refund_date_last: z.ZodOptional<z.ZodString>;
+    rrn_credit: z.ZodOptional<z.ZodString>;
+    rrn_debit: z.ZodOptional<z.ZodString>;
+    sender_bonus: z.ZodOptional<z.ZodNumber>;
+    sender_card_bank: z.ZodOptional<z.ZodString>;
+    sender_card_country: z.ZodOptional<z.ZodString>;
+    sender_card_mask2: z.ZodOptional<z.ZodString>;
+    sender_iban: z.ZodOptional<z.ZodString>;
+    sender_card_type: z.ZodOptional<z.ZodString>;
+    sender_commission: z.ZodOptional<z.ZodNumber>;
+    sender_first_name: z.ZodOptional<z.ZodString>;
+    sender_last_name: z.ZodOptional<z.ZodString>;
+    sender_phone: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    wait_reserve_status: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
+    token: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    err_erc: z.ZodOptional<z.ZodString>;
+    product_category: z.ZodOptional<z.ZodString>;
+    product_description: z.ZodOptional<z.ZodString>;
+    product_name: z.ZodOptional<z.ZodString>;
+    product_url: z.ZodOptional<z.ZodString>;
+    refund_amount: z.ZodOptional<z.ZodNumber>;
+    verifycode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LiqPayRawCheckoutCallback = z.infer<typeof LiqPayRawCheckoutCallbackSchema>;
+export declare const LiqPayCheckoutCallbackSchema: z.ZodPipe<z.ZodObject<{
+    version: z.ZodOptional<z.ZodNumber>;
+    public_key: z.ZodOptional<z.ZodString>;
+    acq_id: z.ZodOptional<z.ZodNumber>;
+    action: z.ZodOptional<z.ZodString>;
+    agent_commission: z.ZodOptional<z.ZodNumber>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    amount_bonus: z.ZodOptional<z.ZodNumber>;
+    amount_credit: z.ZodOptional<z.ZodNumber>;
+    amount_debit: z.ZodOptional<z.ZodNumber>;
+    authcode_credit: z.ZodOptional<z.ZodString>;
+    authcode_debit: z.ZodOptional<z.ZodString>;
+    card_token: z.ZodOptional<z.ZodString>;
+    commission_credit: z.ZodOptional<z.ZodNumber>;
+    commission_debit: z.ZodOptional<z.ZodNumber>;
+    completion_date: z.ZodOptional<z.ZodString>;
+    create_date: z.ZodOptional<z.ZodString>;
+    currency: z.ZodOptional<z.ZodString>;
+    currency_credit: z.ZodOptional<z.ZodString>;
+    currency_debit: z.ZodOptional<z.ZodString>;
+    customer: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    end_date: z.ZodOptional<z.ZodString>;
+    err_code: z.ZodOptional<z.ZodString>;
+    err_description: z.ZodOptional<z.ZodString>;
+    info: z.ZodOptional<z.ZodString>;
+    ip: z.ZodOptional<z.ZodString>;
+    is_3ds: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
+    liqpay_order_id: z.ZodOptional<z.ZodString>;
+    mpi_eci: z.ZodOptional<z.ZodNumber>;
+    order_id: z.ZodOptional<z.ZodString>;
+    payment_id: z.ZodOptional<z.ZodNumber>;
+    paytype: z.ZodOptional<z.ZodString>;
+    receiver_commission: z.ZodOptional<z.ZodNumber>;
+    redirect_to: z.ZodOptional<z.ZodString>;
+    refund_date_last: z.ZodOptional<z.ZodString>;
+    rrn_credit: z.ZodOptional<z.ZodString>;
+    rrn_debit: z.ZodOptional<z.ZodString>;
+    sender_bonus: z.ZodOptional<z.ZodNumber>;
+    sender_card_bank: z.ZodOptional<z.ZodString>;
+    sender_card_country: z.ZodOptional<z.ZodString>;
+    sender_card_mask2: z.ZodOptional<z.ZodString>;
+    sender_iban: z.ZodOptional<z.ZodString>;
+    sender_card_type: z.ZodOptional<z.ZodString>;
+    sender_commission: z.ZodOptional<z.ZodNumber>;
+    sender_first_name: z.ZodOptional<z.ZodString>;
+    sender_last_name: z.ZodOptional<z.ZodString>;
+    sender_phone: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    wait_reserve_status: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
+    token: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    err_erc: z.ZodOptional<z.ZodString>;
+    product_category: z.ZodOptional<z.ZodString>;
+    product_description: z.ZodOptional<z.ZodString>;
+    product_name: z.ZodOptional<z.ZodString>;
+    product_url: z.ZodOptional<z.ZodString>;
+    refund_amount: z.ZodOptional<z.ZodNumber>;
+    verifycode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+    version: 0 | 7 | undefined;
+    action: "" | "pay" | "hold" | "paysplit" | "subscribe" | "paydonate" | "auth" | "regular" | "status" | undefined;
+    completionDate: Date | undefined;
+    createDate: Date | undefined;
+    currency: "" | "USD" | "EUR" | "UAH" | undefined;
+    currencyCredit: "" | "USD" | "EUR" | "UAH" | undefined;
+    currencyDebit: "" | "USD" | "EUR" | "UAH" | undefined;
+    endDate: Date | undefined;
+    errCode: "" | "5" | "limit" | "frod" | "decline" | "err_auth" | "err_cache" | "user_not_found" | "err_sms_send" | "err_sms_otp" | "shop_blocked" | "shop_not_active" | "invalid_signature" | "order_id_empty" | "err_shop_not_agent" | "err_card_def_notfound" | "err_no_card_token" | "err_card_liqpay_def" | "err_card_type" | "err_card_country" | "err_limit_amount" | "err_payment_amount_limit" | "amount_limit" | "payment_err_sender_card" | "payment_processing" | "err_payment_discount" | "err_wallet" | "err_get_verify_code" | "err_verify_code" | "wait_info" | "err_path" | "err_payment_cash_acq" | "err_split_amount" | "err_card_receiver_def" | "payment_err_status" | "public_key_not_found" | "payment_not_found" | "payment_not_subscribed" | "wrong_amount_currency" | "err_amount_hold" | "err_access" | "order_id_duplicate" | "err_blocked" | "err_empty" | "err_empty_phone" | "err_missing" | "err_wrong" | "err_wrong_currency" | "err_phone" | "err_card" | "err_card_bin" | "err_terminal_notfound" | "err_commission_notfound" | "err_payment_create" | "err_mpi" | "err_currency_is_not_allowed" | "err_look" | "err_mods_empty" | "payment_err_type" | "err_payment_currency" | "err_payment_exchangerates" | "err_signature" | "err_api_action" | "err_api_callback" | "err_api_ip" | "expired_phone" | "expired_3ds" | "expired_otp" | "expired_cvv" | "expired_p24" | "expired_sender" | "expired_pin" | "expired_ivr" | "expired_captcha" | "expired_password" | "expired_senderapp" | "expired_prepared" | "expired_mp" | "expired_qr" | "90" | "101" | "102" | "103" | "104" | "105" | "106" | "107" | "108" | "109" | "110" | "111" | "112" | "113" | "114" | "115" | "2903" | "2915" | "3914" | "9851" | "9852" | "9854" | "9855" | "9857" | "9859" | "9860" | "9861" | "9863" | "9867" | "9868" | "9872" | "9882" | "9886" | "9961" | "9989" | undefined;
+    is3ds: boolean | undefined;
+    mpiEci: 0 | 5 | 6 | 7 | undefined;
+    paytype: "" | "apay" | "gpay" | "card" | "privat24" | "masterpass" | "moment_part" | "paypart" | "cash" | "invoice" | "qr" | undefined;
+    refundDateLast: Date | undefined;
+    status: "" | "success" | "error" | "failure" | "reversed" | "subscribed" | "unsubscribed" | "3ds_verify" | "captcha_verify" | "cvv_verify" | "ivr_verify" | "otp_verify" | "password_verify" | "phone_verify" | "pin_verify" | "receiver_verify" | "sender_verify" | "senderapp_verify" | "wait_qr" | "wait_sender" | "p24_verify" | "mp_verify" | "cash_wait" | "hold_wait" | "invoice_wait" | "prepared" | "processing" | "wait_accept" | "wait_card" | "wait_compensation" | "wait_lc" | "wait_reserve" | "wait_secure" | "try_again" | undefined;
+    waitReserveStatus: boolean | undefined;
+    publicKey?: string | undefined;
+    acqId?: number | undefined;
+    agentCommission?: number | undefined;
+    amount?: number | undefined;
+    amountBonus?: number | undefined;
+    amountCredit?: number | undefined;
+    amountDebit?: number | undefined;
+    authcodeCredit?: string | undefined;
+    authcodeDebit?: string | undefined;
+    cardToken?: string | undefined;
+    commissionCredit?: number | undefined;
+    commissionDebit?: number | undefined;
+    customer?: string | undefined;
+    description?: string | undefined;
+    errDescription?: string | undefined;
+    info?: string | undefined;
+    ip?: string | undefined;
+    liqpayOrderId?: string | undefined;
+    orderId?: string | undefined;
+    paymentId?: number | undefined;
+    receiverCommission?: number | undefined;
+    redirectTo?: string | undefined;
+    rrnCredit?: string | undefined;
+    rrnDebit?: string | undefined;
+    senderBonus?: number | undefined;
+    senderCardBank?: string | undefined;
+    senderCardCountry?: string | undefined;
+    senderCardMask2?: string | undefined;
+    senderIban?: string | undefined;
+    senderCardType?: string | undefined;
+    senderCommission?: number | undefined;
+    senderFirstName?: string | undefined;
+    senderLastName?: string | undefined;
+    senderPhone?: string | undefined;
+    token?: string | undefined;
+    type?: string | undefined;
+    errErc?: string | undefined;
+    productCategory?: string | undefined;
+    productDescription?: string | undefined;
+    productName?: string | undefined;
+    productUrl?: string | undefined;
+    refundAmount?: number | undefined;
+    verifycode?: string | undefined;
+}, {
+    version?: number | undefined;
+    public_key?: string | undefined;
+    acq_id?: number | undefined;
+    action?: string | undefined;
+    agent_commission?: number | undefined;
+    amount?: number | undefined;
+    amount_bonus?: number | undefined;
+    amount_credit?: number | undefined;
+    amount_debit?: number | undefined;
+    authcode_credit?: string | undefined;
+    authcode_debit?: string | undefined;
+    card_token?: string | undefined;
+    commission_credit?: number | undefined;
+    commission_debit?: number | undefined;
+    completion_date?: string | undefined;
+    create_date?: string | undefined;
+    currency?: string | undefined;
+    currency_credit?: string | undefined;
+    currency_debit?: string | undefined;
+    customer?: string | undefined;
+    description?: string | undefined;
+    end_date?: string | undefined;
+    err_code?: string | undefined;
+    err_description?: string | undefined;
+    info?: string | undefined;
+    ip?: string | undefined;
+    is_3ds?: string | boolean | undefined;
+    liqpay_order_id?: string | undefined;
+    mpi_eci?: number | undefined;
+    order_id?: string | undefined;
+    payment_id?: number | undefined;
+    paytype?: string | undefined;
+    receiver_commission?: number | undefined;
+    redirect_to?: string | undefined;
+    refund_date_last?: string | undefined;
+    rrn_credit?: string | undefined;
+    rrn_debit?: string | undefined;
+    sender_bonus?: number | undefined;
+    sender_card_bank?: string | undefined;
+    sender_card_country?: string | undefined;
+    sender_card_mask2?: string | undefined;
+    sender_iban?: string | undefined;
+    sender_card_type?: string | undefined;
+    sender_commission?: number | undefined;
+    sender_first_name?: string | undefined;
+    sender_last_name?: string | undefined;
+    sender_phone?: string | undefined;
+    status?: string | undefined;
+    wait_reserve_status?: string | boolean | undefined;
+    token?: string | undefined;
+    type?: string | undefined;
+    err_erc?: string | undefined;
+    product_category?: string | undefined;
+    product_description?: string | undefined;
+    product_name?: string | undefined;
+    product_url?: string | undefined;
+    refund_amount?: number | undefined;
+    verifycode?: string | undefined;
+}>>;
+export type LiqPayCheckoutCallback = z.infer<typeof LiqPayCheckoutCallbackSchema>;