zmp-sdk 2.52.0-beta.1 → 2.52.1-beta.2

package/index.d.ts

@@ -1443,72 +1443,56 @@ type VoucherAction = {
     cta: string;
 };
 type AddVoucherData = {
-    /**
-     * Tiêu đề hiển thị trên card.
-     */
-    title: string;
     /**
      * Tên voucher / ưu đãi.
      */
     name: string;
     /**
-     * Tên chủ thẻ hiển thị phụ dưới tên voucher. Mặc định dùng `ownerName`.
-     */
-    desc?: string;
-    /**
-     * Logo hiển thị trên card. Mặc định dùng `merchantLogoUrl`.
+     * Điều kiện áp dụng (chính), hiển thị trên chi tiết vé.
      */
-    avatarUrl?: string;
+    condition: string;
     /**
-     * Nội dung encode vào QR hoặc barcode.
+     * Điều kiện áp dụng chi tiết (phụ).
      */
-    code: string;
-    /**
-     * Loại mã hiển thị. Mặc định là `qr_code`.
-     */
-    display?: VoucherDisplayType;
+    conditionDetail?: string;
     /**
-     * Nguồn phát hành voucher.
+     * Thời gian bắt đầu hiệu lực, epoch milliseconds.
      */
-    partner?: string;
+    validAt?: number;
     /**
-     * Tên thương hiệu / cửa hàng phát hành voucher.
+     * Hạn sử dụng, epoch milliseconds.
      */
-    merchantName: string;
-    /**
-     * OA ID của merchant trên Zalo.
-     */
-    merchantOaId: string;
+    expiredAt: number;
     /**
-     * Logo merchant.
+     * Mã voucher; không truyền thì tự sinh QR OA của merchant.
      */
-    merchantLogoUrl?: string;
+    code?: string;
     /**
-     * Tên người nhận voucher.
+     * Loại mã hiển thị. Mặc định là `qr_code`.
      */
-    ownerName: string;
+    display?: VoucherDisplayType;
     /**
-     * Điều kiện sử dụng tóm tắt.
+     * Khoảng thời gian trước hạn để gửi nhắc, tính bằng milliseconds.
      */
-    condition: string;
+    remindBefore: number;
     /**
-     * Điều kiện sử dụng đầy đủ.
+     * Tên khách hàng sở hữu; không truyền thì không hiển thị trên vé.
      */
-    conditionDetail?: string;
+    ownerName?: string;
     /**
-     * Thời điểm bắt đầu hiệu lực, epoch milliseconds.
+     * OA ID của merchant trên Zalo.
      */
-    validAt?: number;
+    merchantOaId: string;
     /**
-     * Thời điểm hết hạn, epoch milliseconds.
+     * Tên OA / thương hiệu phát hành voucher.
      */
-    expiredAt: number;
+    merchantName: string;
     /**
-     * Thời điểm gửi nhắc hạn, epoch milliseconds.
+     * Logo OA, dùng làm logo hiển thị trên voucher.
      */
-    remindAt?: number;
+    merchantLogoUrl: string;
     /**
-     * Danh sách CTA hiển thị trên thẻ.
+     * Danh sách CTA hiển thị trên thẻ (tối đa 2).
      */
     actions?: VoucherAction[];
 };
@@ -5371,15 +5355,18 @@ declare function addRating(args?: AsyncVoidCallback): Promise<void>;
  * @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} code Nội dung encode vào QR hoặc barcode.
- * @param {"qr_code" | "bar_code"} [display="qr_code"] Loại mã hiển thị.
- * @param {string} merchantName Tên thương hiệu / cửa hàng phát hành voucher.
+ * @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} ownerName Tên người nhận voucher.
- * @param {string} condition Điều kiện sử dụng tóm tắt.
- * @param {number} expiredAt Thời điểm hết hạn, epoch milliseconds.
- * @param {number} [remindAt] Thời điểm gửi nhắc hạn, epoch milliseconds.
- * @param {VoucherAction[]} [actions] Danh sách CTA hiển thị trên thẻ.
+ * @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 {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.
@@ -5387,14 +5374,13 @@ declare function addRating(args?: AsyncVoidCallback): Promise<void>;
  * @example Thêm voucher vào Ví QR:
  * ```ts
  * await addVoucher({
- *   name: "Giảm 50k cho đơn từ 150k",
- *   code: "SPFOOD50K",
- *   merchantName: "Shopee Food",
- *   merchantOaId: "2712772826697148176",
- *   ownerName: "Nguyễn Văn A",
- *   condition: "Áp dụng cho đơn từ 150.000đ.",
- *   expiredAt: 1751299200000,
- *   remindAt: 1751212800000,
+ *   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",
  * });
  * ```
  */