zmp-sdk 2.52.1-beta.3 → 2.52.2

package/index.d.ts

@@ -1426,84 +1426,6 @@ type GetZPITokenReturns = {
     zpp: string;
     zpt: string;
 };
-type VoucherDisplayType = "qr_code" | "bar_code";
-type VoucherActionType = "url" | "phone";
-type VoucherAction = {
-    /**
-     * Loại CTA hiển thị trên thẻ voucher.
-     */
-    type: VoucherActionType;
-    /**
-     * URL khi `type=url`, hoặc số điện thoại khi `type=phone`.
-     */
-    value: string;
-    /**
-     * Nội dung hiển thị trên button CTA.
-     */
-    cta: string;
-};
-type AddVoucherData = {
-    /**
-     * Tên voucher / ưu đãi.
-     */
-    name: string;
-    /**
-     * Điều kiện áp dụng (chính), hiển thị trên chi tiết vé.
-     */
-    condition: string;
-    /**
-     * Điều kiện áp dụng chi tiết (phụ).
-     */
-    conditionDetail?: string;
-    /**
-     * Thời gian bắt đầu hiệu lực, epoch milliseconds.
-     */
-    validAt?: number;
-    /**
-     * Hạn sử dụng, epoch milliseconds.
-     */
-    expiredAt: number;
-    /**
-     * Mã voucher; không truyền thì tự sinh QR OA của merchant.
-     */
-    code?: string;
-    /**
-     * Loại mã hiển thị. Mặc định là `qr_code`.
-     */
-    display?: VoucherDisplayType;
-    /**
-     * Token để merchant gửi tin nhắn không tốn phí. Lấy từ callback
-     * `onDataReceived` của `showFunctionButtonWidget`.
-     */
-    interactToken?: string;
-    /**
-     * Tên khách hàng sở hữu; không truyền thì không hiển thị trên vé.
-     */
-    ownerName?: string;
-    /**
-     * OA ID của merchant trên Zalo.
-     */
-    merchantOaId: string;
-    /**
-     * Tên OA / thương hiệu phát hành voucher.
-     */
-    merchantName: string;
-    /**
-     * Logo OA, dùng làm logo hiển thị trên voucher.
-     */
-    merchantLogoUrl: string;
-    /**
-     * Danh sách CTA hiển thị trên thẻ (tối đa 2).
-     */
-    actions?: VoucherAction[];
-};
-type AddVoucherReturns = {
-    /**
-     * Token để merchant gửi tin nhắn OA cho người dùng; chuỗi rỗng nếu server
-     * không trả về.
-     */
-    oa_message_token: string;
-};
 type TempFile = {
     /**
      * Đường dẫn các temp file đã chọn.
@@ -2758,11 +2680,14 @@ declare const checkoutPopupArgs: ZodObject<{
     amount: ZodUnion<[ZodString, ZodNumber]>;
     orderDescription: ZodString;
     qrContent: ZodString;
+    method: ZodOptional<ZodString>;
 }, "strip", ZodTypeAny, {
+    method?: string | undefined;
     amount: string | number;
     orderDescription: string;
     qrContent: string;
 }, {
+    method?: string | undefined;
     amount: string | number;
     orderDescription: string;
     qrContent: string;
@@ -5346,71 +5271,6 @@ declare function requestSendNotification(args?: AsyncVoidCallback): Promise<void
  */
 declare function addRating(args?: AsyncVoidCallback): Promise<void>;
 
-/**
- * Lưu voucher vào Ví QR của người dùng.
- *
- * API này gửi dữ liệu voucher từ Mini App về server trung gian. Server trung gian
- * chịu trách nhiệm đăng nhập Ví QR, mã hoá dữ liệu bằng `secureKey`, sau đó trả về
- * deeplink thêm thẻ vào Ví QR. SDK sẽ tự mở deeplink này bằng `openWebview` để đưa
- * người dùng tới màn hình thêm thẻ; deeplink không được trả về cho bên gọi, chỉ
- * trả về `oa_message_token`.
- *
- * @zaloOnly Chỉ hoạt động khi chạy bên trong ứng dụng Zalo mobile.
- *
- * @param {string} name Tên voucher / ưu đãi.
- * @param {string} condition Điều kiện áp dụng (chính), hiển thị trên chi tiết vé.
- * @param {number} expiredAt Hạn sử dụng, epoch milliseconds.
- * @param {string} merchantOaId OA ID của merchant trên Zalo.
- * @param {string} merchantName Tên OA / thương hiệu phát hành voucher.
- * @param {string} merchantLogoUrl Logo OA, dùng làm logo hiển thị trên voucher.
- * @param {string} [conditionDetail] Điều kiện áp dụng chi tiết (phụ).
- * @param {number} [validAt] Thời gian bắt đầu hiệu lực, epoch milliseconds.
- * @param {string} [code] Mã voucher; không truyền thì tự sinh QR OA của merchant.
- * @param {"qr_code" | "bar_code"} [display="qr_code"] Loại mã hiển thị.
- * @param {string} [ownerName] Tên khách hàng sở hữu; không truyền thì không hiển thị trên vé.
- * @param {string} [interactToken] Token để merchant gửi tin nhắn không tốn phí.
- * Lấy từ callback `onDataReceived` của {@link showFunctionButtonWidget} khi
- * người dùng nhấn vào Function Button Widget.
- * @param {VoucherAction[]} [actions] Danh sách CTA hiển thị trên thẻ (tối đa 2).
- *
- * @returns {Promise<AddVoucherReturns>} Promise resolve khi tạo thẻ thành công và
- * deeplink đã được mở, trả về `oa_message_token` (chuỗi rỗng nếu server không
- * trả về); reject kèm mã lỗi từ server nếu thất bại.
- *
- * @example Thêm voucher vào Ví QR:
- * ```ts
- * await addVoucher({
- *   name: "Giảm 50% giá trị đơn hàng",
- *   condition: "Áp dụng cho hóa đơn trên 200.000đ",
- *   expiredAt: 1743440399000,
- *   merchantOaId: "2646373759294038927",
- *   merchantName: "The Face Shop",
- *   merchantLogoUrl: "https://static.example.com/logo.png",
- * });
- * ```
- *
- * @example Gửi kèm `interactToken` lấy từ Function Button Widget:
- * ```ts
- * showFunctionButtonWidget({
- *   id: "orderButton",
- *   type: "ORDER",
- *   text: "Tạo đơn hàng",
- *   onDataReceived: async (interactToken) => {
- *     await addVoucher({
- *       name: "Giảm 50% giá trị đơn hàng",
- *       condition: "Áp dụng cho hóa đơn trên 200.000đ",
- *       expiredAt: 1743440399000,
- *       merchantOaId: "2646373759294038927",
- *       merchantName: "The Face Shop",
- *       merchantLogoUrl: "https://static.example.com/logo.png",
- *       interactToken,
- *     });
- *   },
- * });
- * ```
- */
-declare function addVoucher(args: AsyncCallback<AddVoucherReturns> & AddVoucherData): Promise<AddVoucherReturns>;
-
 declare const interactOAArgs$1: ZodObject<{
     oaId: ZodString;
 }, "strip", ZodTypeAny, {
@@ -5928,6 +5788,70 @@ type ShowFunctionButtonWidgetArgs = Omit<ShowFunctionButtonWidgetValidatedArgs,
     onDataReceived?: FunctionButtonWidgetOnDataReceived;
     onError?: FunctionButtonWidgetOnError;
 };
+/**
+ * Widget Function Button: Khi người dùng nhấn vào button này, Mini App sẽ nhận được 1 interact token để Merchant Server gửi kèm khi gọi Checkout SDK updateOrderStatus (https://mini.zalo.me/documents/checkout-sdk/updateOrderStatus/).
+ *
+ * @minimumVersion 2.39.0
+ * @zaloOnly Chỉ hoạt động khi chạy bên trong ứng dụng Zalo mobile.
+ *
+ * @param {string} id ID của element, nơi cần hiển thị widget.
+ * @param {"ORDER"} type Loại nút, hiện tại chỉ hỗ trợ giá trị: `ORDER`.
+ * @param {"Thanh toán" |"Đặt món" |"Đặt xe" |"Đặt hàng" |"Mua vé" |"Booking" |"Đặt chỗ" |"Tạo đơn hàng" |"Đặt trước" |"Mua hàng" |"Đặt lịch" |"Tra cứu" |"Kiểm tra"} text Chuỗi hiển thị trong button. Phải là một trong các giá trị được cho phép:
+ * - Thanh toán
+ * - Đặt món
+ * - Đặt xe
+ * - Đặt hàng
+ * - Mua vé
+ * - Booking
+ * - Đặt chỗ
+ * - Tạo đơn hàng
+ * - Đặt trước
+ * - Mua hàng
+ * - Đặt lịch
+ * - Tra cứu
+ * - Kiểm tra
+ * @param {string} [fontSize="16px"] Kích thước font chữ. Giá trị nhỏ nhất là 14px.
+ * @param {string} [color="#0068FF"] Màu chủ đạo của widget. Giá trị phải là chuỗi hex.
+ * @param {string} [textColor="#FFFFFF"] Màu chữ trong button. Giá trị phải là chuỗi hex.
+ * @param {string} [borderRadius="48px"] Bo góc (bo tròn các góc của button).
+ * @param {(interactToken: string, type: string, context: { callAction: (actionName: string, actionData: any) => void }) => void} [onDataReceived] Callback được gọi khi người dùng nhấn vào widget. Callback này chứa `interactToken` để Merchant Server gửi kèm khi gọi Checkout SDK updateOrderStatus (https://mini.zalo.me/documents/checkout-sdk/updateOrderStatus/).
+ * @param {(error: AppError) => void} [onError] Callback được gọi khi có lỗi xảy ra khi người dùng nhấn vào widget. Callback này chứa `error` là thông tin về lỗi.
+ *
+ * @example Hiển thị Widget Function Button:
+ * ```ts
+ * import React, { useEffect } from "react";
+ * import { showFunctionButtonWidget } from "zmp-sdk/apis";
+ *
+ * function HomePage() {
+ *   useEffect(() => {
+ *     showFunctionButtonWidget({
+ *       id: "orderButton",
+ *       type: "ORDER",
+ *       text: "Đặt hàng",
+ *       color: "#0068FF",
+ *       textColor: "#FFFFFF",
+ *       borderRadius: "48px",
+ *       onDataReceived: (interactToken, type) => {
+ *         console.log(interactToken);
+ *       },
+ *       onError: (error) => {
+ *         console.error("onError:", error.code, error.message);
+ *       },
+ *     });
+ *   }, []);
+ *
+ *   return (
+ *     <>
+ *       ...
+ *       <div id="orderButton" />
+ *       ...
+ *     </>
+ *   );
+ * }
+ *
+ * export default HomePage;
+ * ```
+ */
 declare function showFunctionButtonWidget(args: AsyncVoidCallback & ShowFunctionButtonWidgetArgs): Promise<void>;
 
 declare const scanNFCArgs: ZodObject<{
@@ -6297,7 +6221,6 @@ declare const otherApis: {
     openGroupList: typeof openGroupList;
     requestSendNotification: typeof requestSendNotification;
     addRating: typeof addRating;
-    addVoucher: typeof addVoucher;
     interactOA: typeof interactOA;
     interactOa: typeof interactOA;
     isAllowedInteractWithOA: typeof checkIsAllowedInteractWithOA;
@@ -6364,4 +6287,4 @@ declare const otherApis: {
     ZMACameraImp: typeof ZMACameraImp;
 };
 
-export { Action, AddVoucherData, AddVoucherReturns, AndroidBottomNavigationBarType, AppError, AsyncCallback, AsyncCallbackFailObject, AsyncProgressCallback, AsyncVoidCallback, AuthorizeType, CameraEvents, CameraParams, ChatType, CheckStateBioAuthenticationReturns, CheckTransactionReturns, CheckZaloCameraPermissionReturns, CheckoutKit, CheckoutPopupOpenParams, CheckoutPopupResponseData, CheckoutSDK, ChooseImageReturns, Common, ContextInfo, CreateOrderIAPReturns, CreateOrderReturns, Events as EventName, Events, FacingMode, FileInfo, FunctionProps, GetAppInfoReturns, GetAuthCodeReturns, GetBeaconDiscoveryReturns, GetDeviceInfoReturn, GetFileInfoReturns, GetLocationReturns, GetNetworkTypeReturns, GetPhoneNumberReturns, GetSettingReturn, GetStorageReturns, GetUserInfoReturns, GetZPITokenReturns, IAPMethodType, IAPPayType, IAPPayTypeType, IOSSafeAreaBottomType, IsSupportReturns, JumpStatus, KeepScreenReturns, LFSStorage, ListFile, LogData, MediaConstraints, MediaDevice, MediaPickerType, NativeCallBackData, NetworkType, OpenBioAuthenticationReturns, OpenMediaPickerReturns, OpenPostFeedReturns, OpenProfilePickerReturns, OpenProfilePickerType, OpenShareSheetReturns, OpenWebviewReturns, OrientationType, Payment, PhotoConstraint, PhotoFormat, PhotoFrame, PhotoQuality, PickAttr, PickedProfile, PlatformType, PostFeedType, ProfileInfo, ProfileType, ProrationMode, ProrationModeType, RemoveStorageReturns, RequestCameraPermissionReturns, SaveFileReturns, ScanNFCType, ScanQRCodeReturns, SelectPaymentMethodReturns, SetStorageReturns, ShareSheetType, StatusBarType, StorageInfo, StreamType, SystemInfo, TempFile, TextAlignType, UserInfo, VibrateType, VoucherAction, VoucherActionType, VoucherDisplayType, ZMACamera, ZMACameraImp, addRating, addVoucher, authorize, checkNFC, checkStateBioAuthentication, checkTransaction, checkZaloCameraPermission, chooseImage, clearStorage, closeApp, closeLoading, configAppView, connectWifi, createCameraContext, createOrder, createOrderIAP, createShortcut, otherApis as default, displayAd, downloadFile, events, favoriteApp, followOA, getAccessToken, getAppInfo, getAuthCode, getBeacons, getContext, getContextAsync, getDeviceId, getDeviceIdAsync, getDeviceInfo, getEntrySource, getIDToken, getLocation, getNetworkType, getPhoneNumber, getRouteParams, getSetting, getShareableLink, getStorage, getStorageInfo, getSystemInfo, getUserID, getUserInfo, getVersion, getZPIToken, hideKeyboard, iBeaconInfo, interactOA, interactOA as interactOa, checkIsAllowedInteractWithOA as isAllowedInteractWithOA, keepScreen, loadAd, login, minimizeApp, nativeStorage, offConfirmToExit, offKeepScreen, onCallbackData, onConfirmToExit, onKeepScreen, onNetworkStatusChange, openBioAuthentication, openChat, openDocument, openGroupList, openMediaPicker, openMiniApp, openOutApp, openPermissionSetting, openPhone, openPostFeed, openProfile, openProfilePicker, openSMS, openShareSheet, openWebview, purchase, refreshAd, removeStorage, requestCameraPermission, requestSendNotification, requestUpdateZalo, saveImageToGallery, saveVideoToGallery, scanNFC, scanQRCode, selectPaymentMethod, sendDataToPreviousMiniApp, setAccessToken, setAndroidBottomNavigationBar, setIOSBottomSafeArea, setNavigationBarColor, setNavigationBarLeftButton, setNavigationBarTitle, setStatusBar, setStorage, setupAd, showCustomOAWidget, showFunctionButtonWidget, showOAWidget, showToast, startBeaconDiscovery, stopBeaconDiscovery, trackingManager, unfollowOA, vibrate, viewOAQr };
+export { Action, AndroidBottomNavigationBarType, AppError, AsyncCallback, AsyncCallbackFailObject, AsyncProgressCallback, AsyncVoidCallback, AuthorizeType, CameraEvents, CameraParams, ChatType, CheckStateBioAuthenticationReturns, CheckTransactionReturns, CheckZaloCameraPermissionReturns, CheckoutKit, CheckoutPopupOpenParams, CheckoutPopupResponseData, CheckoutSDK, ChooseImageReturns, Common, ContextInfo, CreateOrderIAPReturns, CreateOrderReturns, Events as EventName, Events, FacingMode, FileInfo, FunctionProps, GetAppInfoReturns, GetAuthCodeReturns, GetBeaconDiscoveryReturns, GetDeviceInfoReturn, GetFileInfoReturns, GetLocationReturns, GetNetworkTypeReturns, GetPhoneNumberReturns, GetSettingReturn, GetStorageReturns, GetUserInfoReturns, GetZPITokenReturns, IAPMethodType, IAPPayType, IAPPayTypeType, IOSSafeAreaBottomType, IsSupportReturns, JumpStatus, KeepScreenReturns, LFSStorage, ListFile, LogData, MediaConstraints, MediaDevice, MediaPickerType, NativeCallBackData, NetworkType, OpenBioAuthenticationReturns, OpenMediaPickerReturns, OpenPostFeedReturns, OpenProfilePickerReturns, OpenProfilePickerType, OpenShareSheetReturns, OpenWebviewReturns, OrientationType, Payment, PhotoConstraint, PhotoFormat, PhotoFrame, PhotoQuality, PickAttr, PickedProfile, PlatformType, PostFeedType, ProfileInfo, ProfileType, ProrationMode, ProrationModeType, RemoveStorageReturns, RequestCameraPermissionReturns, SaveFileReturns, ScanNFCType, ScanQRCodeReturns, SelectPaymentMethodReturns, SetStorageReturns, ShareSheetType, StatusBarType, StorageInfo, StreamType, SystemInfo, TempFile, TextAlignType, UserInfo, VibrateType, ZMACamera, ZMACameraImp, addRating, authorize, checkNFC, checkStateBioAuthentication, checkTransaction, checkZaloCameraPermission, chooseImage, clearStorage, closeApp, closeLoading, configAppView, connectWifi, createCameraContext, createOrder, createOrderIAP, createShortcut, otherApis as default, displayAd, downloadFile, events, favoriteApp, followOA, getAccessToken, getAppInfo, getAuthCode, getBeacons, getContext, getContextAsync, getDeviceId, getDeviceIdAsync, getDeviceInfo, getEntrySource, getIDToken, getLocation, getNetworkType, getPhoneNumber, getRouteParams, getSetting, getShareableLink, getStorage, getStorageInfo, getSystemInfo, getUserID, getUserInfo, getVersion, getZPIToken, hideKeyboard, iBeaconInfo, interactOA, interactOA as interactOa, checkIsAllowedInteractWithOA as isAllowedInteractWithOA, keepScreen, loadAd, login, minimizeApp, nativeStorage, offConfirmToExit, offKeepScreen, onCallbackData, onConfirmToExit, onKeepScreen, onNetworkStatusChange, openBioAuthentication, openChat, openDocument, openGroupList, openMediaPicker, openMiniApp, openOutApp, openPermissionSetting, openPhone, openPostFeed, openProfile, openProfilePicker, openSMS, openShareSheet, openWebview, purchase, refreshAd, removeStorage, requestCameraPermission, requestSendNotification, requestUpdateZalo, saveImageToGallery, saveVideoToGallery, scanNFC, scanQRCode, selectPaymentMethod, sendDataToPreviousMiniApp, setAccessToken, setAndroidBottomNavigationBar, setIOSBottomSafeArea, setNavigationBarColor, setNavigationBarLeftButton, setNavigationBarTitle, setStatusBar, setStorage, setupAd, showCustomOAWidget, showFunctionButtonWidget, showOAWidget, showToast, startBeaconDiscovery, stopBeaconDiscovery, trackingManager, unfollowOA, vibrate, viewOAQr };