zmp-sdk 2.52.1-beta.2 → 2.52.1-beta.3

package/index.d.ts

@@ -1472,9 +1472,10 @@ type AddVoucherData = {
      */
     display?: VoucherDisplayType;
     /**
-     * Khoảng thời gian trước hạn để gửi nhắc, tính bằng milliseconds.
+     * Token để merchant gửi tin nhắn không tốn phí. Lấy từ callback
+     * `onDataReceived` của `showFunctionButtonWidget`.
      */
-    remindBefore: number;
+    interactToken?: string;
     /**
      * Tên khách hàng sở hữu; không truyền thì không hiển thị trên vé.
      */
@@ -1498,9 +1499,10 @@ type AddVoucherData = {
 };
 type AddVoucherReturns = {
     /**
-     * ID thẻ voucher trong Ví QR.
+     * Token để merchant gửi tin nhắn OA cho người dùng; chuỗi rỗng nếu server
+     * không trả về.
      */
-    id: string | number;
+    oa_message_token: string;
 };
 type TempFile = {
     /**
@@ -5350,14 +5352,14 @@ declare function addRating(args?: AsyncVoidCallback): Promise<void>;
  * 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.
+ * 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 {number} remindBefore Khoảng thời gian trước hạn để gửi nhắc, tính bằng 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.
@@ -5366,10 +5368,14 @@ declare function addRating(args?: AsyncVoidCallback): Promise<void>;
  * @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<void>} Promise resolve khi tạo thẻ thành công và deeplink đã
- * được mở; reject kèm mã lỗi từ server nếu thất bại.
+ * @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
@@ -5377,14 +5383,33 @@ declare function addRating(args?: AsyncVoidCallback): Promise<void>;
  *   name: "Giảm 50% giá trị đơn hàng",
  *   condition: "Áp dụng cho hóa đơn trên 200.000đ",
  *   expiredAt: 1743440399000,
- *   remindBefore: 3600000,
  *   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<void> & AddVoucherData): Promise<void>;
+declare function addVoucher(args: AsyncCallback<AddVoucherReturns> & AddVoucherData): Promise<AddVoucherReturns>;
 
 declare const interactOAArgs$1: ZodObject<{
     oaId: ZodString;