@warriorteam/redai-zalo-sdk 1.29.0 → 1.31.0

package/dist/types/consultation.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Types cho Consultation Service - Zalo OA API
+ *
+ * Consultation messages (tin nhắn tư vấn) là loại tin nhắn đặc biệt
+ * cho phép OA gửi tin nhắn chủ động đến người dùng trong khung thời gian nhất định
+ *
+ * API Endpoint: https://openapi.zalo.me/v3.0/oa/message/cs
+ * Method: POST
+ * Content-Type: application/json
+ */
+/**
+ * Interface cho template action (default_action trong elements)
+ */
+export interface TemplateAction {
+    /** Loại action */
+    type: "oa.open.url" | "oa.query.show" | "oa.query.hide" | "oa.open.sms" | "oa.open.phone";
+    /** URL (cho oa.open.url) */
+    url?: string;
+    /** Payload string (cho oa.query.show, oa.query.hide) hoặc object (cho oa.open.sms, oa.open.phone) */
+    payload?: string | {
+        content?: string;
+        phone_code?: string;
+    } | {
+        phone_code?: string;
+    };
+}
+/**
+ * Interface cho template element
+ *
+ * Quy tắc elements:
+ * - elements là mảng JSON, tối đa 5 phần tử
+ * - title: bắt buộc, ≤ 100 ký tự
+ * - subtitle: bắt buộc cho element đầu tiên, tùy chọn cho các element sau, ≤ 500 ký tự
+ * - image_url: URL ảnh (tùy chọn)
+ * - default_action: hành động khi click vào element (tùy chọn)
+ */
+export interface TemplateElement {
+    /** Tiêu đề (bắt buộc, ≤ 100 ký tự) */
+    title: string;
+    /** Tiêu đề phụ (bắt buộc cho element đầu tiên, tùy chọn cho các element sau, ≤ 500 ký tự) */
+    subtitle?: string;
+    /** URL ảnh (tùy chọn) */
+    image_url?: string;
+    /** Hành động khi click vào element (tùy chọn) */
+    default_action?: TemplateAction;
+}
+/**
+ * Interface cho template button
+ *
+ * Quy tắc buttons:
+ * - buttons là mảng JSON, tối đa 5 phần tử
+ * - title: bắt buộc, ≤ 100 ký tự
+ * - type: loại action
+ * - payload: dữ liệu của action, phụ thuộc vào loại type
+ */
+export interface TemplateButton {
+    /** Tiêu đề button (bắt buộc, ≤ 100 ký tự) */
+    title: string;
+    /** Loại button */
+    type: "oa.open.url" | "oa.query.show" | "oa.query.hide" | "oa.open.sms" | "oa.open.phone";
+    /** Payload của button, phụ thuộc vào type */
+    payload: string | {
+        url?: string;
+    } | {
+        content?: string;
+        phone_code?: string;
+    } | {
+        phone_code?: string;
+    };
+}
+/**
+ * Interface cho từng tin nhắn trong chuỗi tin nhắn
+ */
+export interface MessageItem {
+    /** Loại tin nhắn */
+    type: "text" | "image" | "gif" | "file" | "sticker" | "request_user_info";
+    /** Nội dung tin nhắn (cho text message) */
+    text?: string;
+    /** URL hình ảnh (cho image/gif message) */
+    imageUrl?: string;
+    /** URL GIF (cho gif message) */
+    gifUrl?: string;
+    /** Chiều rộng GIF (bắt buộc cho gif) */
+    width?: number;
+    /** Chiều cao GIF (bắt buộc cho gif) */
+    height?: number;
+    /** Token file (cho file message) */
+    fileToken?: string;
+    /** Attachment ID (cho image/sticker message) */
+    attachmentId?: string;
+    /** Sticker attachment ID (cho sticker message) */
+    stickerAttachmentId?: string;
+    /** Tiêu đề (cho request_user_info message) */
+    title?: string;
+    /** Tiêu đề phụ (cho request_user_info message) */
+    subtitle?: string;
+    /** Delay sau khi gửi tin nhắn này (milliseconds) */
+    delay?: number;
+}
+/**
+ * Interface cho request gửi chuỗi tin nhắn
+ */
+export interface SendMessageSequenceRequest {
+    /** Access token của Official Account */
+    accessToken: string;
+    /** ID người nhận */
+    userId: string;
+    /** Danh sách tin nhắn */
+    messages: MessageItem[];
+    /** Delay mặc định giữa các tin nhắn (milliseconds) - nếu không có delay riêng */
+    defaultDelay?: number;
+}
+/**
+ * Interface cho response gửi chuỗi tin nhắn
+ */
+export interface SendMessageSequenceResponse {
+    /** Tổng số tin nhắn đã gửi thành công */
+    successCount: number;
+    /** Tổng số tin nhắn thất bại */
+    failureCount: number;
+    /** Chi tiết kết quả từng tin nhắn */
+    results: Array<{
+        /** Index của tin nhắn trong danh sách */
+        index: number;
+        /** Loại tin nhắn */
+        type: string;
+        /** Trạng thái gửi */
+        success: boolean;
+        /** Thông tin response nếu thành công */
+        response?: any;
+        /** Thông tin lỗi nếu thất bại */
+        error?: string;
+        /** Thời gian gửi */
+        timestamp: number;
+    }>;
+    /** Tổng thời gian thực hiện (milliseconds) */
+    totalDuration: number;
+}
+/**
+ * Interface cho request gửi chuỗi tin nhắn tới nhiều users
+ */
+export interface SendMessageSequenceToMultipleUsersRequest {
+    /** Access token của Official Account */
+    accessToken: string;
+    /** Danh sách user IDs */
+    userIds: string[];
+    /** Danh sách tin nhắn */
+    messages: MessageItem[];
+    /** Delay mặc định giữa các tin nhắn (milliseconds) */
+    defaultDelay?: number;
+    /** Delay giữa các user (milliseconds) để tránh rate limit */
+    delayBetweenUsers?: number;
+    /** Callback function để tracking tiến trình */
+    onProgress?: (progress: UserProgressInfo) => void;
+}
+/**
+ * Interface cho thông tin tiến trình từng user
+ */
+export interface UserProgressInfo {
+    /** User ID hiện tại */
+    userId: string;
+    /** Index của user trong danh sách (bắt đầu từ 0) */
+    userIndex: number;
+    /** Tổng số users */
+    totalUsers: number;
+    /** Trạng thái: 'started' | 'completed' | 'failed' */
+    status: 'started' | 'completed' | 'failed';
+    /** Kết quả gửi tin nhắn (nếu đã hoàn thành) */
+    result?: SendMessageSequenceResponse;
+    /** Thông tin lỗi (nếu thất bại) */
+    error?: string;
+    /** Thời gian bắt đầu */
+    startTime: number;
+    /** Thời gian kết thúc (nếu đã hoàn thành) */
+    endTime?: number;
+}
+/**
+ * Interface cho response gửi chuỗi tin nhắn tới nhiều users
+ */
+export interface SendMessageSequenceToMultipleUsersResponse {
+    /** Tổng số users */
+    totalUsers: number;
+    /** Số users gửi thành công */
+    successfulUsers: number;
+    /** Số users gửi thất bại */
+    failedUsers: number;
+    /** Chi tiết kết quả từng user */
+    userResults: Array<{
+        /** User ID */
+        userId: string;
+        /** Index của user trong danh sách */
+        userIndex: number;
+        /** Trạng thái gửi cho user này */
+        success: boolean;
+        /** Kết quả chi tiết gửi tin nhắn */
+        messageSequenceResult?: SendMessageSequenceResponse;
+        /** Thông tin lỗi nếu thất bại */
+        error?: string;
+        /** Thời gian bắt đầu gửi */
+        startTime: number;
+        /** Thời gian kết thúc */
+        endTime: number;
+        /** Thời gian thực hiện (milliseconds) */
+        duration: number;
+    }>;
+    /** Tổng thời gian thực hiện (milliseconds) */
+    totalDuration: number;
+    /** Thống kê tin nhắn tổng cộng */
+    messageStats: {
+        /** Tổng số tin nhắn đã gửi thành công */
+        totalSuccessfulMessages: number;
+        /** Tổng số tin nhắn thất bại */
+        totalFailedMessages: number;
+        /** Tổng số tin nhắn */
+        totalMessages: number;
+    };
+}
+/**
+ * Các loại template action types
+ */
+export type TemplateActionType = "oa.open.url" | "oa.query.show" | "oa.query.hide" | "oa.open.sms" | "oa.open.phone";
+/**
+ * Các loại template button types (giống với action types)
+ */
+export type TemplateButtonType = TemplateActionType;
+/**
+ * Payload cho URL action/button
+ */
+export interface UrlPayload {
+    url: string;
+}
+/**
+ * Payload cho SMS action/button
+ */
+export interface SmsPayload {
+    phone_code: string;
+    content?: string;
+}
+/**
+ * Payload cho Phone action/button
+ */
+export interface PhonePayload {
+    phone_code: string;
+}
+/**
+ * Union type cho tất cả các loại payload
+ */
+export type ConsultationTemplatePayload = string | UrlPayload | SmsPayload | PhonePayload;
+/**
+ * Template types được hỗ trợ
+ */
+export type TemplateType = "request_user_info" | "media" | string;
+//# sourceMappingURL=consultation.d.ts.map

package/dist/types/consultation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consultation.d.ts","sourceRoot":"","sources":["../../src/types/consultation.ts"],"names":[],"mappings":"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"}

package/dist/types/consultation.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Types cho Consultation Service - Zalo OA API
+ *
+ * Consultation messages (tin nhắn tư vấn) là loại tin nhắn đặc biệt
+ * cho phép OA gửi tin nhắn chủ động đến người dùng trong khung thời gian nhất định
+ *
+ * API Endpoint: https://openapi.zalo.me/v3.0/oa/message/cs
+ * Method: POST
+ * Content-Type: application/json
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=consultation.js.map

package/dist/types/consultation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consultation.js","sourceRoot":"","sources":["../../src/types/consultation.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/dist/types/purchase.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Purchase API types for Zalo Official Account
+ *
+ * API để tạo đơn hàng mua sản phẩm/dịch vụ OA
+ * Yêu cầu: Ứng dụng cần được cấp quyền quản lý "Mua sản phẩm dịch vụ OA"
+ */
+/**
+ * Beneficiary types - Đối tượng thụ hưởng
+ */
+export type BeneficiaryType = "OA" | "APP";
+/**
+ * Request để tạo đơn hàng với product_id
+ */
+export interface CreateOrderWithProductRequest {
+    /**
+     * Đối tượng được thụ hưởng khi mua đơn hàng
+     * - OA: Official Account
+     * - APP: Application
+     * Lưu ý: Mỗi sản phẩm sẽ quy định đối tượng khả dụng riêng
+     */
+    beneficiary: BeneficiaryType;
+    /**
+     * ID của sản phẩm muốn mua
+     * Chỉ sử dụng product_id HOẶC redeem_code, không được dùng cả hai
+     */
+    product_id: number;
+    /**
+     * Mã giảm giá (tùy chọn)
+     * VD: Giảm 100K, Giảm 10%, ...
+     */
+    voucher_code?: string;
+}
+/**
+ * Request để tạo đơn hàng với redeem_code
+ */
+export interface CreateOrderWithRedeemRequest {
+    /**
+     * Đối tượng được thụ hưởng khi mua đơn hàng
+     */
+    beneficiary: BeneficiaryType;
+    /**
+     * Mã quà tặng
+     * Chỉ sử dụng product_id HOẶC redeem_code, không được dùng cả hai
+     */
+    redeem_code: string;
+    /**
+     * Mã giảm giá (tùy chọn)
+     */
+    voucher_code?: string;
+}
+/**
+ * Union type cho request tạo đơn hàng
+ */
+export type CreateOrderRequest = CreateOrderWithProductRequest | CreateOrderWithRedeemRequest;
+/**
+ * Response data khi tạo đơn hàng thành công
+ */
+export interface OrderData {
+    /**
+     * ID đơn hàng
+     * Lưu ý: Order chỉ được tạo từ 00:01 đến 23h54
+     */
+    order_id: string;
+    /**
+     * Loại đối tượng thụ hưởng
+     */
+    beneficiary_type: BeneficiaryType;
+    /**
+     * ID của OA (nếu beneficiary_type = OA) hoặc ID của App (nếu beneficiary_type = APP)
+     */
+    beneficiary_id: number;
+    /**
+     * ID sản phẩm
+     */
+    product_id: number;
+    /**
+     * Tên sản phẩm
+     */
+    product_name: string;
+    /**
+     * Tài khoản ZCA thanh toán đơn hàng
+     */
+    zca_id: number;
+    /**
+     * Voucher code đã được sử dụng (nếu có)
+     */
+    voucher_code?: string;
+    /**
+     * Mã quà tặng (nếu có)
+     */
+    redeem_code?: string;
+    /**
+     * Giá trị của voucher_code
+     * VD: Giảm 10% hay Giảm 100K, ...
+     */
+    discount?: number;
+    /**
+     * Giá tiền của đơn hàng (chưa áp dụng mã giảm giá)
+     */
+    amount: number;
+    /**
+     * Giá tiền chính thức sau khi đã sử dụng mã giảm giá
+     */
+    final_amount: number;
+    /**
+     * Thời điểm tạo đơn hàng, tính bằng millisecond
+     */
+    created_time: number;
+    /**
+     * OTT - One Time Token
+     * Mã xác thực dùng để xác nhận thanh toán đơn hàng
+     * Sử dụng tại API xác nhận thanh toán đơn hàng
+     * OTT sẽ có hiệu lực trong vòng 5 phút kể từ khi Order được khởi tạo
+     */
+    verified_token: string;
+}
+/**
+ * Response khi tạo đơn hàng thành công
+ */
+export interface CreateOrderResponse {
+    error: 0;
+    message: "Success";
+    data: OrderData;
+}
+/**
+ * Helper type để kiểm tra request type
+ */
+export declare function isProductOrderRequest(request: CreateOrderRequest): request is CreateOrderWithProductRequest;
+/**
+ * Helper type để kiểm tra request type
+ */
+export declare function isRedeemOrderRequest(request: CreateOrderRequest): request is CreateOrderWithRedeemRequest;
+/**
+ * Validation errors cho Purchase API
+ */
+export interface PurchaseValidationError {
+    field: string;
+    message: string;
+}
+/**
+ * Request để xác nhận thanh toán đơn hàng
+ */
+export interface ConfirmOrderRequest {
+    /**
+     * ID đơn hàng
+     * Lấy từ response của API tạo đơn hàng
+     */
+    order_id: string;
+    /**
+     * OTT - One Time Token
+     * Mã xác thực dùng để xác nhận thanh toán đơn hàng
+     * Lấy từ response của API tạo đơn hàng
+     * OTT sẽ có hiệu lực trong vòng 5 phút kể từ khi Order được khởi tạo
+     */
+    verified_token: string;
+}
+/**
+ * Response data khi xác nhận thanh toán đơn hàng thành công
+ * Lưu ý: Response không có verified_token như khi tạo đơn hàng
+ */
+export interface ConfirmedOrderData {
+    /**
+     * ID đơn hàng
+     */
+    order_id: string;
+    /**
+     * Loại đối tượng thụ hưởng
+     */
+    beneficiary_type: BeneficiaryType;
+    /**
+     * ID của OA (nếu beneficiary_type = OA) hoặc ID của App (nếu beneficiary_type = APP)
+     */
+    beneficiary_id: number;
+    /**
+     * ID sản phẩm
+     */
+    product_id: number;
+    /**
+     * Tên sản phẩm
+     */
+    product_name: string;
+    /**
+     * Tài khoản ZCA thanh toán đơn hàng
+     */
+    zca_id: number;
+    /**
+     * Voucher code đã được sử dụng (nếu có)
+     */
+    voucher_code?: string;
+    /**
+     * Mã quà tặng (nếu có)
+     */
+    redeem_code?: string;
+    /**
+     * Giá trị của voucher_code
+     * VD: Giảm 10% hay Giảm 100K, ...
+     */
+    discount?: number;
+    /**
+     * Giá tiền của đơn hàng (chưa áp dụng mã giảm giá)
+     */
+    amount: number;
+    /**
+     * Giá tiền chính thức sau khi đã sử dụng mã giảm giá
+     */
+    final_amount: number;
+    /**
+     * Thời điểm tạo đơn hàng, tính bằng millisecond
+     */
+    created_time: number;
+}
+/**
+ * Response khi xác nhận thanh toán đơn hàng thành công
+ */
+export interface ConfirmOrderResponse {
+    error: 0;
+    message: "Success";
+    data: ConfirmedOrderData;
+}
+/**
+ * Danh sách sản phẩm OA có sẵn
+ */
+export declare const OA_PRODUCTS: {
+    readonly OA_ADVANCED_6M: 866836109767958100;
+    readonly OA_ADVANCED_12M: 1302963828004138500;
+    readonly OA_PREMIUM_6M: 757295129578622300;
+    readonly OA_PREMIUM_12M: 3071996459978069000;
+    readonly GMF_10_MEMBERS: 739448264820568800;
+    readonly GMF_50_MEMBERS: 2405469629611791400;
+    readonly GMF_100_MEMBERS: 2275350247265190700;
+    readonly GMF_1000_MEMBERS: 3678557233392100000;
+    readonly TRANSACTION_5K: 4609774892111012000;
+    readonly TRANSACTION_50K: 2038298593847789600;
+    readonly TRANSACTION_500K: 2544831667685732000;
+};
+/**
+ * Thông tin chi tiết sản phẩm
+ */
+export interface ProductInfo {
+    id: number;
+    name: string;
+    beneficiary: BeneficiaryType[];
+    category: 'subscription' | 'gmf' | 'quota';
+}
+/**
+ * Danh sách thông tin chi tiết sản phẩm
+ */
+export declare const PRODUCT_INFO: Record<number, ProductInfo>;
+/**
+ * Purchase API error codes
+ */
+export declare enum PurchaseErrorCode {
+    INVALID_BENEFICIARY = 1001,
+    INVALID_PRODUCT_ID = 1002,
+    INVALID_REDEEM_CODE = 1003,
+    INVALID_VOUCHER_CODE = 1004,
+    PRODUCT_NOT_AVAILABLE = 1005,
+    INSUFFICIENT_BALANCE = 1006,
+    ORDER_TIME_RESTRICTED = 1007,
+    DUPLICATE_ORDER = 1008,
+    PERMISSION_DENIED = 1009,
+    INVALID_ORDER_ID = 1010,
+    INVALID_VERIFIED_TOKEN = 1011,
+    ORDER_EXPIRED = 1012,
+    ORDER_ALREADY_CONFIRMED = 1013,
+    SYSTEM_ERROR = 9999
+}
+//# sourceMappingURL=purchase.d.ts.map

package/dist/types/purchase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purchase.d.ts","sourceRoot":"","sources":["../../src/types/purchase.ts"],"names":[],"mappings":"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"}

package/dist/types/purchase.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * Purchase API types for Zalo Official Account
+ *
+ * API để tạo đơn hàng mua sản phẩm/dịch vụ OA
+ * Yêu cầu: Ứng dụng cần được cấp quyền quản lý "Mua sản phẩm dịch vụ OA"
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PurchaseErrorCode = exports.PRODUCT_INFO = exports.OA_PRODUCTS = void 0;
+exports.isProductOrderRequest = isProductOrderRequest;
+exports.isRedeemOrderRequest = isRedeemOrderRequest;
+/**
+ * Helper type để kiểm tra request type
+ */
+function isProductOrderRequest(request) {
+    return 'product_id' in request;
+}
+/**
+ * Helper type để kiểm tra request type
+ */
+function isRedeemOrderRequest(request) {
+    return 'redeem_code' in request;
+}
+/**
+ * Danh sách sản phẩm OA có sẵn
+ */
+exports.OA_PRODUCTS = {
+    // Sản phẩm OA Subscription
+    OA_ADVANCED_6M: 866836109767958135,
+    OA_ADVANCED_12M: 1302963828004138542,
+    OA_PREMIUM_6M: 757295129578622372,
+    OA_PREMIUM_12M: 3071996459978068910,
+    // Sản phẩm Quota khởi tạo GMF
+    GMF_10_MEMBERS: 739448264820568793,
+    GMF_50_MEMBERS: 2405469629611791306,
+    GMF_100_MEMBERS: 2275350247265190619,
+    GMF_1000_MEMBERS: 3678557233392100095,
+    // Sản phẩm Gói quota tin nhắn OA
+    TRANSACTION_5K: 4609774892111011697,
+    TRANSACTION_50K: 2038298593847789538,
+    TRANSACTION_500K: 2544831667685731909,
+};
+/**
+ * Danh sách thông tin chi tiết sản phẩm
+ */
+exports.PRODUCT_INFO = {
+    // OA Subscription
+    [exports.OA_PRODUCTS.OA_ADVANCED_6M]: {
+        id: exports.OA_PRODUCTS.OA_ADVANCED_6M,
+        name: "Gói OA Nâng cao 6 tháng",
+        beneficiary: ["OA"],
+        category: "subscription"
+    },
+    [exports.OA_PRODUCTS.OA_ADVANCED_12M]: {
+        id: exports.OA_PRODUCTS.OA_ADVANCED_12M,
+        name: "Gói OA Nâng cao 12 tháng",
+        beneficiary: ["OA"],
+        category: "subscription"
+    },
+    [exports.OA_PRODUCTS.OA_PREMIUM_6M]: {
+        id: exports.OA_PRODUCTS.OA_PREMIUM_6M,
+        name: "Gói OA Premium 6 tháng",
+        beneficiary: ["OA"],
+        category: "subscription"
+    },
+    [exports.OA_PRODUCTS.OA_PREMIUM_12M]: {
+        id: exports.OA_PRODUCTS.OA_PREMIUM_12M,
+        name: "Gói OA Premium 12 tháng",
+        beneficiary: ["OA"],
+        category: "subscription"
+    },
+    // GMF Products
+    [exports.OA_PRODUCTS.GMF_10_MEMBERS]: {
+        id: exports.OA_PRODUCTS.GMF_10_MEMBERS,
+        name: "GMF tối đa 10 thành viên",
+        beneficiary: ["OA"],
+        category: "gmf"
+    },
+    [exports.OA_PRODUCTS.GMF_50_MEMBERS]: {
+        id: exports.OA_PRODUCTS.GMF_50_MEMBERS,
+        name: "GMF tối đa 50 thành viên",
+        beneficiary: ["OA"],
+        category: "gmf"
+    },
+    [exports.OA_PRODUCTS.GMF_100_MEMBERS]: {
+        id: exports.OA_PRODUCTS.GMF_100_MEMBERS,
+        name: "GMF tối đa 100 thành viên",
+        beneficiary: ["OA"],
+        category: "gmf"
+    },
+    [exports.OA_PRODUCTS.GMF_1000_MEMBERS]: {
+        id: exports.OA_PRODUCTS.GMF_1000_MEMBERS,
+        name: "GMF tối đa 1000 thành viên",
+        beneficiary: ["OA"],
+        category: "gmf"
+    },
+    // Transaction Quota
+    [exports.OA_PRODUCTS.TRANSACTION_5K]: {
+        id: exports.OA_PRODUCTS.TRANSACTION_5K,
+        name: "Gói 5k tin Giao dịch (1 tháng)",
+        beneficiary: ["APP", "OA"],
+        category: "quota"
+    },
+    [exports.OA_PRODUCTS.TRANSACTION_50K]: {
+        id: exports.OA_PRODUCTS.TRANSACTION_50K,
+        name: "Gói 50k tin Giao dịch (1 tháng)",
+        beneficiary: ["APP", "OA"],
+        category: "quota"
+    },
+    [exports.OA_PRODUCTS.TRANSACTION_500K]: {
+        id: exports.OA_PRODUCTS.TRANSACTION_500K,
+        name: "Gói 500k tin Giao dịch (1 tháng)",
+        beneficiary: ["APP", "OA"],
+        category: "quota"
+    },
+};
+/**
+ * Purchase API error codes
+ */
+var PurchaseErrorCode;
+(function (PurchaseErrorCode) {
+    PurchaseErrorCode[PurchaseErrorCode["INVALID_BENEFICIARY"] = 1001] = "INVALID_BENEFICIARY";
+    PurchaseErrorCode[PurchaseErrorCode["INVALID_PRODUCT_ID"] = 1002] = "INVALID_PRODUCT_ID";
+    PurchaseErrorCode[PurchaseErrorCode["INVALID_REDEEM_CODE"] = 1003] = "INVALID_REDEEM_CODE";
+    PurchaseErrorCode[PurchaseErrorCode["INVALID_VOUCHER_CODE"] = 1004] = "INVALID_VOUCHER_CODE";
+    PurchaseErrorCode[PurchaseErrorCode["PRODUCT_NOT_AVAILABLE"] = 1005] = "PRODUCT_NOT_AVAILABLE";
+    PurchaseErrorCode[PurchaseErrorCode["INSUFFICIENT_BALANCE"] = 1006] = "INSUFFICIENT_BALANCE";
+    PurchaseErrorCode[PurchaseErrorCode["ORDER_TIME_RESTRICTED"] = 1007] = "ORDER_TIME_RESTRICTED";
+    PurchaseErrorCode[PurchaseErrorCode["DUPLICATE_ORDER"] = 1008] = "DUPLICATE_ORDER";
+    PurchaseErrorCode[PurchaseErrorCode["PERMISSION_DENIED"] = 1009] = "PERMISSION_DENIED";
+    PurchaseErrorCode[PurchaseErrorCode["INVALID_ORDER_ID"] = 1010] = "INVALID_ORDER_ID";
+    PurchaseErrorCode[PurchaseErrorCode["INVALID_VERIFIED_TOKEN"] = 1011] = "INVALID_VERIFIED_TOKEN";
+    PurchaseErrorCode[PurchaseErrorCode["ORDER_EXPIRED"] = 1012] = "ORDER_EXPIRED";
+    PurchaseErrorCode[PurchaseErrorCode["ORDER_ALREADY_CONFIRMED"] = 1013] = "ORDER_ALREADY_CONFIRMED";
+    PurchaseErrorCode[PurchaseErrorCode["SYSTEM_ERROR"] = 9999] = "SYSTEM_ERROR";
+})(PurchaseErrorCode || (exports.PurchaseErrorCode = PurchaseErrorCode = {}));
+//# sourceMappingURL=purchase.js.map