@bi-nova/services 1.3.4-beta.202605281745 → 1.3.4-beta.202606031412

package/dist/index.d.mts

@@ -246,6 +246,8 @@ interface DyPayInfo {
 
 /** 客户端类型 */
 type ClientType = 'weapp' | 'h5';
+/** 返回地址类型 */
+type ReturnType = 'h5' | 'ulink';
 /** 小程序页面跳转方式 */
 type BackWay = 'switchTab' | 'reLaunch' | 'redirectTo' | 'navigateTo';
 /** handleDyPayFlow 入参 */
@@ -262,6 +264,12 @@ interface HandleDyPayFlowParams {
     platformActivities?: Record<string, any>;
     /** 客户端（可传，默认 weapp） */
     client?: ClientType;
+    /**
+     * 返回地址类型（可传，默认 h5）
+     * - h5：返回 H5 收银台中转页 URL（data.h5Url）
+     * - ulink：返回抖音 ulink 中转页 URL（data.ulinkUrl）
+     */
+    returnType?: ReturnType;
     /** 支付下单客户端类型，jsapi 模式统一下单 fixedClientType 传 22，默认传 21 */
     payClientType?: PayClientType;
     /** 下单参数透传（非必传） */
@@ -295,8 +303,10 @@ interface HandleDyPayFlowParams {
 }
 /** handleDyPayFlow 返回数据 */
 interface HandleDyPayFlowResult {
-    /** H5 收银台地址，H5 模式返回 */
+    /** H5 收银台地址（returnType 为 'h5' 或未传时返回） */
     h5Url?: string;
+    /** 抖音 ulink 中转页地址（returnType 为 'ulink' 时返回） */
+    ulinkUrl?: string;
     /** 订单号 */
     outTradeNo: string;
     /** 抖音 SDK 支付参数，JSAPI 模式返回 */
@@ -341,11 +351,12 @@ interface GetDyPayRtaDataResult {
  * @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 {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 返回标准化结果，默认/H5 模式返回 h5Url，jsapi 模式返回 payInfo，接入方自行调起支付
+ * @returns 返回标准化结果，returnType 为 h5 时返回 h5Url，ulink 时返回 ulinkUrl，接入方自行打开 webview 或 H5 跳转;jsapi 模式返回 payInfo，接入方自行调起支付
  */
 declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildResultReturn<HandleDyPayFlowResult>>;
 /**
@@ -460,14 +471,16 @@ declare enum DyErrorCode {
     DY_PAY__INVALID_BACK_WAY = 3016,
     /** 缺少业务类型参数 */
     DY_PAY__MISSING_BUSINESS_TYPE = 3017,
+    /** 无效的返回地址类型 */
+    DY_PAY__INVALID_RETURN_TYPE = 3018,
     /** 获取 JSAPI 支付信息失败 */
-    DY_PAY__JSAPI_INFO_FAILED = 3018,
+    DY_PAY__JSAPI_INFO_FAILED = 3019,
     /** 获取 JSAPI 支付信息请求失败 */
-    DY_PAY__REQUEST_JSAPI_INFO_FAILED = 3019,
+    DY_PAY__REQUEST_JSAPI_INFO_FAILED = 3020,
     /** 缺少 JSAPI 支付参数 */
-    DY_PAY__MISSING_JSAPI_PAY_INFO = 3020,
+    DY_PAY__MISSING_JSAPI_PAY_INFO = 3021,
     /** JSAPI 支付参数格式不正确 */
-    DY_PAY__INVALID_JSAPI_PAY_INFO = 3021
+    DY_PAY__INVALID_JSAPI_PAY_INFO = 3022
 }
 /**
  * 抖音业务错误信息映射

package/dist/index.d.ts

@@ -246,6 +246,8 @@ interface DyPayInfo {
 
 /** 客户端类型 */
 type ClientType = 'weapp' | 'h5';
+/** 返回地址类型 */
+type ReturnType = 'h5' | 'ulink';
 /** 小程序页面跳转方式 */
 type BackWay = 'switchTab' | 'reLaunch' | 'redirectTo' | 'navigateTo';
 /** handleDyPayFlow 入参 */
@@ -262,6 +264,12 @@ interface HandleDyPayFlowParams {
     platformActivities?: Record<string, any>;
     /** 客户端（可传，默认 weapp） */
     client?: ClientType;
+    /**
+     * 返回地址类型（可传，默认 h5）
+     * - h5：返回 H5 收银台中转页 URL（data.h5Url）
+     * - ulink：返回抖音 ulink 中转页 URL（data.ulinkUrl）
+     */
+    returnType?: ReturnType;
     /** 支付下单客户端类型，jsapi 模式统一下单 fixedClientType 传 22，默认传 21 */
     payClientType?: PayClientType;
     /** 下单参数透传（非必传） */
@@ -295,8 +303,10 @@ interface HandleDyPayFlowParams {
 }
 /** handleDyPayFlow 返回数据 */
 interface HandleDyPayFlowResult {
-    /** H5 收银台地址，H5 模式返回 */
+    /** H5 收银台地址（returnType 为 'h5' 或未传时返回） */
     h5Url?: string;
+    /** 抖音 ulink 中转页地址（returnType 为 'ulink' 时返回） */
+    ulinkUrl?: string;
     /** 订单号 */
     outTradeNo: string;
     /** 抖音 SDK 支付参数，JSAPI 模式返回 */
@@ -341,11 +351,12 @@ interface GetDyPayRtaDataResult {
  * @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 {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 返回标准化结果，默认/H5 模式返回 h5Url，jsapi 模式返回 payInfo，接入方自行调起支付
+ * @returns 返回标准化结果，returnType 为 h5 时返回 h5Url，ulink 时返回 ulinkUrl，接入方自行打开 webview 或 H5 跳转;jsapi 模式返回 payInfo，接入方自行调起支付
  */
 declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildResultReturn<HandleDyPayFlowResult>>;
 /**
@@ -460,14 +471,16 @@ declare enum DyErrorCode {
     DY_PAY__INVALID_BACK_WAY = 3016,
     /** 缺少业务类型参数 */
     DY_PAY__MISSING_BUSINESS_TYPE = 3017,
+    /** 无效的返回地址类型 */
+    DY_PAY__INVALID_RETURN_TYPE = 3018,
     /** 获取 JSAPI 支付信息失败 */
-    DY_PAY__JSAPI_INFO_FAILED = 3018,
+    DY_PAY__JSAPI_INFO_FAILED = 3019,
     /** 获取 JSAPI 支付信息请求失败 */
-    DY_PAY__REQUEST_JSAPI_INFO_FAILED = 3019,
+    DY_PAY__REQUEST_JSAPI_INFO_FAILED = 3020,
     /** 缺少 JSAPI 支付参数 */
-    DY_PAY__MISSING_JSAPI_PAY_INFO = 3020,
+    DY_PAY__MISSING_JSAPI_PAY_INFO = 3021,
     /** JSAPI 支付参数格式不正确 */
-    DY_PAY__INVALID_JSAPI_PAY_INFO = 3021
+    DY_PAY__INVALID_JSAPI_PAY_INFO = 3022
 }
 /**
  * 抖音业务错误信息映射