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

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;
     /** 是否是虚拟商品（非必传） */
@@ -338,6 +337,28 @@ interface GetDyPayRtaDataResult {
     /** 优惠金额（预留） */
     discountAmount: boolean;
 }
+/** handleDyPayCommandFlow 入参 */
+interface HandleDyPayCommandFlowParams {
+    /** 用户手机号，RTA 和口令接口都会使用 */
+    telephone: string;
+    /** 设备编号 */
+    equipmentValue: string;
+    /** RTA 查询金额，可选；不传则按 RTA 接口默认逻辑处理 */
+    price?: number;
+    /** 是否自动复制口令，默认 false */
+    autoCopy?: boolean;
+    /** 自动复制成功后是否返回口令文本，默认 false */
+    returnCommand?: boolean;
+}
+/** handleDyPayCommandFlow 返回数据 */
+interface HandleDyPayCommandFlowResult {
+    /** 是否符合获取口令条件 */
+    eligible: boolean;
+    /** 结果类型 */
+    type: 'command' | 'copy_success' | 'not_eligible';
+    /** 抖音支付口令 */
+    command?: string;
+}
 
 /**
  * 处理抖音支付流程
@@ -349,14 +370,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>>;
 /**
@@ -367,13 +387,23 @@ declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildRe
  * @returns 返回标准化结果，包含 showFlag 表示是否展示活动
  */
 declare function getDyPayRtaData(params: GetDyPayRtaDataParams): Promise<BuildResultReturn<GetDyPayRtaDataResult>>;
+/**
+ * 处理抖音支付口令完整流程
+ * @param params.telephone 用户手机号，RTA 和口令接口都会使用
+ * @param params.equipmentValue 设备编号
+ * @param params.price RTA 查询金额，可选
+ * @param params.autoCopy 是否自动复制口令，默认 false
+ * @param params.returnCommand 自动复制成功后是否返回口令文本，默认 false
+ * @returns 返回标准化结果，包含资格判断、口令或复制结果
+ */
+declare function handleDyPayCommandFlow(params: HandleDyPayCommandFlowParams): Promise<BuildResultReturn<HandleDyPayCommandFlowResult>>;
 
 /**
  * @Description: 业务错误码定义
  * @Author: wutao
  * @Date: 2026-03-30
  * @LastEditors: wutao
- * @LastEditTime: 2026-03-30
+ * @LastEditTime: 2026-06-04 17:49:38
  *
  * 错误码分段规则：
  * - 0: 成功
@@ -480,7 +510,17 @@ declare enum DyErrorCode {
     /** 缺少 JSAPI 支付参数 */
     DY_PAY__MISSING_JSAPI_PAY_INFO = 3021,
     /** JSAPI 支付参数格式不正确 */
-    DY_PAY__INVALID_JSAPI_PAY_INFO = 3022
+    DY_PAY__INVALID_JSAPI_PAY_INFO = 3022,
+    /** 缺少抖音支付口令金额 */
+    DY_PAY_COMMAND__MISSING_ORDER_AMOUNT = 3030,
+    /** 获取抖音支付口令失败 */
+    DY_PAY_COMMAND__GET_FAILED = 3031,
+    /** 获取抖音支付口令请求失败 */
+    DY_PAY_COMMAND__REQUEST_FAILED = 3032,
+    /** 抖音支付口令复制失败 */
+    DY_PAY_COMMAND__COPY_FAILED = 3033,
+    /** 抖音支付口令 RTA 数据无效 */
+    DY_PAY_COMMAND__INVALID_RTA_DATA = 3034
 }
 /**
  * 抖音业务错误信息映射
@@ -687,4 +727,4 @@ declare function normalizeDisplayAdData(advertConfigs: AdvertConfigItem[], fallb
  */
 declare function getDisplayAdConfig(options: GetDisplayAdOptions): Promise<BuildResultReturn<DisplayAdResult>>;
 
-export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type HandleDyPayFlowParams, type HandleDyPayFlowResult, JdErrorCode, JdErrorMessage, type JdInsuranceExternalOptions, type JdInsuranceOptions, type JdInsuranceResult, type JdjrCashLoanExternalOptions, type JdjrCashLoanOptions, type ServicesOptions, createServices, getDisplayAdConfig, getDyPayRtaData, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };
+export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type HandleDyPayCommandFlowParams, type HandleDyPayCommandFlowResult, type HandleDyPayFlowParams, type HandleDyPayFlowResult, JdErrorCode, JdErrorMessage, type JdInsuranceExternalOptions, type JdInsuranceOptions, type JdInsuranceResult, type JdjrCashLoanExternalOptions, type JdjrCashLoanOptions, type ServicesOptions, createServices, getDisplayAdConfig, getDyPayRtaData, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };

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;
     /** 是否是虚拟商品（非必传） */
@@ -338,6 +337,28 @@ interface GetDyPayRtaDataResult {
     /** 优惠金额（预留） */
     discountAmount: boolean;
 }
+/** handleDyPayCommandFlow 入参 */
+interface HandleDyPayCommandFlowParams {
+    /** 用户手机号，RTA 和口令接口都会使用 */
+    telephone: string;
+    /** 设备编号 */
+    equipmentValue: string;
+    /** RTA 查询金额，可选；不传则按 RTA 接口默认逻辑处理 */
+    price?: number;
+    /** 是否自动复制口令，默认 false */
+    autoCopy?: boolean;
+    /** 自动复制成功后是否返回口令文本，默认 false */
+    returnCommand?: boolean;
+}
+/** handleDyPayCommandFlow 返回数据 */
+interface HandleDyPayCommandFlowResult {
+    /** 是否符合获取口令条件 */
+    eligible: boolean;
+    /** 结果类型 */
+    type: 'command' | 'copy_success' | 'not_eligible';
+    /** 抖音支付口令 */
+    command?: string;
+}
 
 /**
  * 处理抖音支付流程
@@ -349,14 +370,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>>;
 /**
@@ -367,13 +387,23 @@ declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildRe
  * @returns 返回标准化结果，包含 showFlag 表示是否展示活动
  */
 declare function getDyPayRtaData(params: GetDyPayRtaDataParams): Promise<BuildResultReturn<GetDyPayRtaDataResult>>;
+/**
+ * 处理抖音支付口令完整流程
+ * @param params.telephone 用户手机号，RTA 和口令接口都会使用
+ * @param params.equipmentValue 设备编号
+ * @param params.price RTA 查询金额，可选
+ * @param params.autoCopy 是否自动复制口令，默认 false
+ * @param params.returnCommand 自动复制成功后是否返回口令文本，默认 false
+ * @returns 返回标准化结果，包含资格判断、口令或复制结果
+ */
+declare function handleDyPayCommandFlow(params: HandleDyPayCommandFlowParams): Promise<BuildResultReturn<HandleDyPayCommandFlowResult>>;
 
 /**
  * @Description: 业务错误码定义
  * @Author: wutao
  * @Date: 2026-03-30
  * @LastEditors: wutao
- * @LastEditTime: 2026-03-30
+ * @LastEditTime: 2026-06-04 17:49:38
  *
  * 错误码分段规则：
  * - 0: 成功
@@ -480,7 +510,17 @@ declare enum DyErrorCode {
     /** 缺少 JSAPI 支付参数 */
     DY_PAY__MISSING_JSAPI_PAY_INFO = 3021,
     /** JSAPI 支付参数格式不正确 */
-    DY_PAY__INVALID_JSAPI_PAY_INFO = 3022
+    DY_PAY__INVALID_JSAPI_PAY_INFO = 3022,
+    /** 缺少抖音支付口令金额 */
+    DY_PAY_COMMAND__MISSING_ORDER_AMOUNT = 3030,
+    /** 获取抖音支付口令失败 */
+    DY_PAY_COMMAND__GET_FAILED = 3031,
+    /** 获取抖音支付口令请求失败 */
+    DY_PAY_COMMAND__REQUEST_FAILED = 3032,
+    /** 抖音支付口令复制失败 */
+    DY_PAY_COMMAND__COPY_FAILED = 3033,
+    /** 抖音支付口令 RTA 数据无效 */
+    DY_PAY_COMMAND__INVALID_RTA_DATA = 3034
 }
 /**
  * 抖音业务错误信息映射
@@ -687,4 +727,4 @@ declare function normalizeDisplayAdData(advertConfigs: AdvertConfigItem[], fallb
  */
 declare function getDisplayAdConfig(options: GetDisplayAdOptions): Promise<BuildResultReturn<DisplayAdResult>>;
 
-export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type HandleDyPayFlowParams, type HandleDyPayFlowResult, JdErrorCode, JdErrorMessage, type JdInsuranceExternalOptions, type JdInsuranceOptions, type JdInsuranceResult, type JdjrCashLoanExternalOptions, type JdjrCashLoanOptions, type ServicesOptions, createServices, getDisplayAdConfig, getDyPayRtaData, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };
+export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type HandleDyPayCommandFlowParams, type HandleDyPayCommandFlowResult, type HandleDyPayFlowParams, type HandleDyPayFlowResult, JdErrorCode, JdErrorMessage, type JdInsuranceExternalOptions, type JdInsuranceOptions, type JdInsuranceResult, type JdjrCashLoanExternalOptions, type JdjrCashLoanOptions, type ServicesOptions, createServices, getDisplayAdConfig, getDyPayRtaData, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };