@bi-nova/services 1.3.4-beta.202606041618 → 1.3.4-beta.202606041644

package/dist/index.d.mts

@@ -228,8 +228,8 @@ declare function handleJdInsurance(options: {
  */
 declare function handleJdInsuranceExt(businessParams: JdInsuranceExternalOptions): Promise<BuildResultReturn>;
 
-/** 支付下单客户端类型，独立于中转页 client */
-type PayClientType = 'default' | 'jsapi';
+/** 支付结果返回类型 */
+type DyPayReturnType = 'h5' | 'ulink' | 'jsapi';
 /** 抖音 SDK 支付参数 */
 interface DyPayInfo {
     /** 支付时间戳 */
@@ -246,16 +246,16 @@ interface DyPayInfo {
 
 /** 客户端类型 */
 type ClientType = 'weapp' | 'h5';
-/** 返回地址类型 */
-type ReturnType = 'h5' | 'ulink';
+/** 支付结果返回类型 */
+type ReturnType = DyPayReturnType;
 /** 小程序页面跳转方式 */
 type BackWay = 'switchTab' | 'reLaunch' | 'redirectTo' | 'navigateTo';
 /** handleDyPayFlow 入参 */
 interface HandleDyPayFlowParams {
     /** 商品金额（必传，单位：元） */
     price: number;
-    /** 手机号（必传） */
-    telephone: string;
+    /** 手机号（returnType 为 h5 或未传时必传） */
+    telephone?: string;
     /** 设备编号（必传） */
     equipmentValue: string;
     /** 业务类型（必传） */
@@ -265,13 +265,12 @@ interface HandleDyPayFlowParams {
     /** 客户端（可传，默认 weapp） */
     client?: ClientType;
     /**
-     * 返回地址类型（可传，默认 h5）
+     * 支付结果返回类型（可传，默认 h5）
      * - h5：返回 H5 收银台中转页 URL（data.h5Url）
      * - ulink：返回抖音 ulink 中转页 URL（data.ulinkUrl）
+     * - jsapi：返回抖音 SDK 支付参数（data.payInfo）
      */
     returnType?: ReturnType;
-    /** 支付下单客户端类型，jsapi 模式统一下单 fixedClientType 传 22，默认传 21 */
-    payClientType?: PayClientType;
     /** 下单参数透传（非必传） */
     douyinOrderExtendData?: string;
     /** 是否是虚拟商品（非必传） */
@@ -349,14 +348,13 @@ interface GetDyPayRtaDataResult {
  * @param {string} params.douyinOrderExtendData 业务透传下单参数（非必传）
  * @param {Record<string, any>} params.platformActivities 平台活动（非必传）
  * @param {boolean} params.douyinCommodityVirtualFlag 是否是虚拟商品（非必传）
- * @param {'default' | 'jsapi'} params.payClientType 支付下单客户端类型（非必传），jsapi 模式会获取 JSAPI 支付信息并返回 payInfo
  * @param {string} params.client 客户端（必传，默认是weapp）weapp 或者 h5
- * @param {'h5' | 'ulink'} params.returnType 返回地址类型（非必传，默认 h5）h5 返回 H5 收银台中转页 URL（data.h5Url），ulink 返回抖音 ulink 中转页 URL（data.ulinkUrl）
+ * @param {'h5' | 'ulink' | 'jsapi'} params.returnType 支付结果返回类型（非必传，默认 h5）。h5 返回 H5 收银台中转页 URL（data.h5Url），ulink 返回抖音 ulink 中转页 URL（data.ulinkUrl），jsapi 返回抖音 SDK 支付参数（data.payInfo）
  * @param {string} params.backUrl 抖音支付成功后返回的页面地址（必传，不传则不跳转）根据client值来决定跳转方式。如果跳转地址有带参数，backUrl一定要记得编码
  * @param {string} params.backWay 小程序页面跳转方式（仅在小程序环境下生效，H5 环境忽略）可传 switchTab | reLaunch | redirectTo | navigateTo
  * @param {string} params.fromUrl 抖音支付完成后返回的上一级页面地址（仅在小程序环境下生效，H5 环境忽略）
  * @param {Record<string, any>} params.unifiedOrderExtendData 下单接口额外透传参数（非必传）
- * @returns 返回标准化结果，returnType 为 h5 时返回 h5Url，ulink 时返回 ulinkUrl，接入方自行打开 webview 或 H5 跳转;jsapi 模式返回 payInfo，接入方自行调起支付
+ * @returns 返回标准化结果，returnType 为 h5 时返回 h5Url，ulink 时返回 ulinkUrl，jsapi 时返回 payInfo，接入方自行调起支付
  */
 declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildResultReturn<HandleDyPayFlowResult>>;
 /**

package/dist/index.d.ts

@@ -228,8 +228,8 @@ declare function handleJdInsurance(options: {
  */
 declare function handleJdInsuranceExt(businessParams: JdInsuranceExternalOptions): Promise<BuildResultReturn>;
 
-/** 支付下单客户端类型，独立于中转页 client */
-type PayClientType = 'default' | 'jsapi';
+/** 支付结果返回类型 */
+type DyPayReturnType = 'h5' | 'ulink' | 'jsapi';
 /** 抖音 SDK 支付参数 */
 interface DyPayInfo {
     /** 支付时间戳 */
@@ -246,16 +246,16 @@ interface DyPayInfo {
 
 /** 客户端类型 */
 type ClientType = 'weapp' | 'h5';
-/** 返回地址类型 */
-type ReturnType = 'h5' | 'ulink';
+/** 支付结果返回类型 */
+type ReturnType = DyPayReturnType;
 /** 小程序页面跳转方式 */
 type BackWay = 'switchTab' | 'reLaunch' | 'redirectTo' | 'navigateTo';
 /** handleDyPayFlow 入参 */
 interface HandleDyPayFlowParams {
     /** 商品金额（必传，单位：元） */
     price: number;
-    /** 手机号（必传） */
-    telephone: string;
+    /** 手机号（returnType 为 h5 或未传时必传） */
+    telephone?: string;
     /** 设备编号（必传） */
     equipmentValue: string;
     /** 业务类型（必传） */
@@ -265,13 +265,12 @@ interface HandleDyPayFlowParams {
     /** 客户端（可传，默认 weapp） */
     client?: ClientType;
     /**
-     * 返回地址类型（可传，默认 h5）
+     * 支付结果返回类型（可传，默认 h5）
      * - h5：返回 H5 收银台中转页 URL（data.h5Url）
      * - ulink：返回抖音 ulink 中转页 URL（data.ulinkUrl）
+     * - jsapi：返回抖音 SDK 支付参数（data.payInfo）
      */
     returnType?: ReturnType;
-    /** 支付下单客户端类型，jsapi 模式统一下单 fixedClientType 传 22，默认传 21 */
-    payClientType?: PayClientType;
     /** 下单参数透传（非必传） */
     douyinOrderExtendData?: string;
     /** 是否是虚拟商品（非必传） */
@@ -349,14 +348,13 @@ interface GetDyPayRtaDataResult {
  * @param {string} params.douyinOrderExtendData 业务透传下单参数（非必传）
  * @param {Record<string, any>} params.platformActivities 平台活动（非必传）
  * @param {boolean} params.douyinCommodityVirtualFlag 是否是虚拟商品（非必传）
- * @param {'default' | 'jsapi'} params.payClientType 支付下单客户端类型（非必传），jsapi 模式会获取 JSAPI 支付信息并返回 payInfo
  * @param {string} params.client 客户端（必传，默认是weapp）weapp 或者 h5
- * @param {'h5' | 'ulink'} params.returnType 返回地址类型（非必传，默认 h5）h5 返回 H5 收银台中转页 URL（data.h5Url），ulink 返回抖音 ulink 中转页 URL（data.ulinkUrl）
+ * @param {'h5' | 'ulink' | 'jsapi'} params.returnType 支付结果返回类型（非必传，默认 h5）。h5 返回 H5 收银台中转页 URL（data.h5Url），ulink 返回抖音 ulink 中转页 URL（data.ulinkUrl），jsapi 返回抖音 SDK 支付参数（data.payInfo）
  * @param {string} params.backUrl 抖音支付成功后返回的页面地址（必传，不传则不跳转）根据client值来决定跳转方式。如果跳转地址有带参数，backUrl一定要记得编码
  * @param {string} params.backWay 小程序页面跳转方式（仅在小程序环境下生效，H5 环境忽略）可传 switchTab | reLaunch | redirectTo | navigateTo
  * @param {string} params.fromUrl 抖音支付完成后返回的上一级页面地址（仅在小程序环境下生效，H5 环境忽略）
  * @param {Record<string, any>} params.unifiedOrderExtendData 下单接口额外透传参数（非必传）
- * @returns 返回标准化结果，returnType 为 h5 时返回 h5Url，ulink 时返回 ulinkUrl，接入方自行打开 webview 或 H5 跳转;jsapi 模式返回 payInfo，接入方自行调起支付
+ * @returns 返回标准化结果，returnType 为 h5 时返回 h5Url，ulink 时返回 ulinkUrl，jsapi 时返回 payInfo，接入方自行调起支付
  */
 declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildResultReturn<HandleDyPayFlowResult>>;
 /**