@bi-nova/services 1.4.0 → 1.4.1-beta.202606181754

package/dist/index.d.mts

@@ -278,6 +278,17 @@ interface HandleDyJsapiPayFlowResult {
     /** 抖音支付回调结果，type 为 pay_result 时返回 */
     payResult?: DouyinPayResult;
 }
+/** 抖音授权代扣签约聚合流程返回数据 */
+interface HandleDyAuthDebitSignFlowResult {
+    /** 结果类型：auth_redirect 表示已跳转授权，sign_result 表示已完成签约 SDK 调起 */
+    type: 'auth_redirect' | 'sign_result';
+    /** 抖音授权地址，type 为 auth_redirect 时返回 */
+    authUrl?: string;
+    /** 签约订单号，type 为 sign_result 时返回 */
+    orderNo?: string;
+    /** 抖音支付/签约回调结果，type 为 sign_result 时返回 */
+    payResult?: DouyinPayResult;
+}
 /** handleDyPayFlow 入参 */
 interface HandleDyPayFlowParams {
     /** 商品金额（必传，单位：元） */
@@ -345,8 +356,8 @@ interface HandleDyPayFlowResult {
 interface GetDyPayRtaDataParams {
     /** 商品金额（非必传，单位：元） */
     price?: number;
-    /** 手机号（必传） */
-    telephone: string;
+    /** 手机号（非必传） */
+    telephone?: string;
     /** 设备编号（必传） */
     equipmentValue: string;
 }
@@ -367,8 +378,8 @@ interface GetDyPayRtaDataResult {
 }
 /** handleDyPayCommandFlow 入参 */
 interface HandleDyPayCommandFlowParams {
-    /** 用户手机号，RTA 和口令接口都会使用 */
-    telephone: string;
+    /** 用户手机号，未传时 RTA 和口令接口按空字符串透传 */
+    telephone?: string;
     /** 设备编号 */
     equipmentValue: string;
     /** RTA 查询金额，可选；不传则按 RTA 接口默认逻辑处理 */
@@ -423,7 +434,7 @@ declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildRe
 declare function getDyPayRtaData(params: GetDyPayRtaDataParams): Promise<BuildResultReturn<GetDyPayRtaDataResult>>;
 /**
  * 处理抖音支付口令完整流程
- * @param params.telephone 用户手机号，RTA 和口令接口都会使用
+ * @param params.telephone 用户手机号，非必传；未传时 RTA 和口令接口按空字符串透传
  * @param params.equipmentValue 设备编号
  * @param params.price RTA 查询金额，可选
  * @param params.commandUrl 指定生成口令的地址，不传则使用服务端默认地址
@@ -442,6 +453,15 @@ declare function handleDyPayCommandFlow(params: HandleDyPayCommandFlowParams): P
  * @returns 返回标准化结果，授权跳转时 type=auth_redirect，支付调起完成时 type=pay_result
  */
 declare function handleDyJsapiPayFlow(params: HandleDyJsapiPayFlowParams): Promise<BuildResultReturn<HandleDyJsapiPayFlowResult>>;
+/**
+ * 处理抖音授权代扣签约聚合流程
+ *
+ * 内部完成授权 token 检查、requestId 读取、授权代扣签约接口调用、JSSDK 验签初始化和 dypay 调起。
+ * 无授权 token 时，会自动跳转抖音授权；授权回跳地址会保留当前页面参数并移除 url_token。
+ *
+ * @returns 返回标准化结果，授权跳转时 type=auth_redirect，签约调起完成时 type=sign_result
+ */
+declare function handleDyAuthDebitSignFlow(): Promise<BuildResultReturn<HandleDyAuthDebitSignFlowResult>>;
 
 /**
  * @Description: 业务错误码定义
@@ -581,7 +601,13 @@ declare enum DyErrorCode {
     /** 抖音支付口令复制失败 */
     DY_PAY_COMMAND__COPY_FAILED = 3034,
     /** 抖音支付口令 RTA 数据无效 */
-    DY_PAY_COMMAND__INVALID_RTA_DATA = 3035
+    DY_PAY_COMMAND__INVALID_RTA_DATA = 3035,
+    /** 缺少授权代扣签约 requestId */
+    DY_PAY__MISSING_AUTH_DEBIT_SIGN_REQUEST_ID = 3036,
+    /** 授权代扣签约失败 */
+    DY_PAY__AUTH_DEBIT_SIGN_FAILED = 3037,
+    /** 授权代扣签约请求失败 */
+    DY_PAY__REQUEST_AUTH_DEBIT_SIGN_FAILED = 3038
 }
 /**
  * 抖音业务错误信息映射
@@ -788,4 +814,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 HandleDyJsapiPayFlowParams, type HandleDyJsapiPayFlowResult, 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, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };
+export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type HandleDyAuthDebitSignFlowResult, type HandleDyJsapiPayFlowParams, type HandleDyJsapiPayFlowResult, 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, handleDyAuthDebitSignFlow, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };

package/dist/index.d.ts

@@ -278,6 +278,17 @@ interface HandleDyJsapiPayFlowResult {
     /** 抖音支付回调结果，type 为 pay_result 时返回 */
     payResult?: DouyinPayResult;
 }
+/** 抖音授权代扣签约聚合流程返回数据 */
+interface HandleDyAuthDebitSignFlowResult {
+    /** 结果类型：auth_redirect 表示已跳转授权，sign_result 表示已完成签约 SDK 调起 */
+    type: 'auth_redirect' | 'sign_result';
+    /** 抖音授权地址，type 为 auth_redirect 时返回 */
+    authUrl?: string;
+    /** 签约订单号，type 为 sign_result 时返回 */
+    orderNo?: string;
+    /** 抖音支付/签约回调结果，type 为 sign_result 时返回 */
+    payResult?: DouyinPayResult;
+}
 /** handleDyPayFlow 入参 */
 interface HandleDyPayFlowParams {
     /** 商品金额（必传，单位：元） */
@@ -345,8 +356,8 @@ interface HandleDyPayFlowResult {
 interface GetDyPayRtaDataParams {
     /** 商品金额（非必传，单位：元） */
     price?: number;
-    /** 手机号（必传） */
-    telephone: string;
+    /** 手机号（非必传） */
+    telephone?: string;
     /** 设备编号（必传） */
     equipmentValue: string;
 }
@@ -367,8 +378,8 @@ interface GetDyPayRtaDataResult {
 }
 /** handleDyPayCommandFlow 入参 */
 interface HandleDyPayCommandFlowParams {
-    /** 用户手机号，RTA 和口令接口都会使用 */
-    telephone: string;
+    /** 用户手机号，未传时 RTA 和口令接口按空字符串透传 */
+    telephone?: string;
     /** 设备编号 */
     equipmentValue: string;
     /** RTA 查询金额，可选；不传则按 RTA 接口默认逻辑处理 */
@@ -423,7 +434,7 @@ declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildRe
 declare function getDyPayRtaData(params: GetDyPayRtaDataParams): Promise<BuildResultReturn<GetDyPayRtaDataResult>>;
 /**
  * 处理抖音支付口令完整流程
- * @param params.telephone 用户手机号，RTA 和口令接口都会使用
+ * @param params.telephone 用户手机号，非必传；未传时 RTA 和口令接口按空字符串透传
  * @param params.equipmentValue 设备编号
  * @param params.price RTA 查询金额，可选
  * @param params.commandUrl 指定生成口令的地址，不传则使用服务端默认地址
@@ -442,6 +453,15 @@ declare function handleDyPayCommandFlow(params: HandleDyPayCommandFlowParams): P
  * @returns 返回标准化结果，授权跳转时 type=auth_redirect，支付调起完成时 type=pay_result
  */
 declare function handleDyJsapiPayFlow(params: HandleDyJsapiPayFlowParams): Promise<BuildResultReturn<HandleDyJsapiPayFlowResult>>;
+/**
+ * 处理抖音授权代扣签约聚合流程
+ *
+ * 内部完成授权 token 检查、requestId 读取、授权代扣签约接口调用、JSSDK 验签初始化和 dypay 调起。
+ * 无授权 token 时，会自动跳转抖音授权；授权回跳地址会保留当前页面参数并移除 url_token。
+ *
+ * @returns 返回标准化结果，授权跳转时 type=auth_redirect，签约调起完成时 type=sign_result
+ */
+declare function handleDyAuthDebitSignFlow(): Promise<BuildResultReturn<HandleDyAuthDebitSignFlowResult>>;
 
 /**
  * @Description: 业务错误码定义
@@ -581,7 +601,13 @@ declare enum DyErrorCode {
     /** 抖音支付口令复制失败 */
     DY_PAY_COMMAND__COPY_FAILED = 3034,
     /** 抖音支付口令 RTA 数据无效 */
-    DY_PAY_COMMAND__INVALID_RTA_DATA = 3035
+    DY_PAY_COMMAND__INVALID_RTA_DATA = 3035,
+    /** 缺少授权代扣签约 requestId */
+    DY_PAY__MISSING_AUTH_DEBIT_SIGN_REQUEST_ID = 3036,
+    /** 授权代扣签约失败 */
+    DY_PAY__AUTH_DEBIT_SIGN_FAILED = 3037,
+    /** 授权代扣签约请求失败 */
+    DY_PAY__REQUEST_AUTH_DEBIT_SIGN_FAILED = 3038
 }
 /**
  * 抖音业务错误信息映射
@@ -788,4 +814,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 HandleDyJsapiPayFlowParams, type HandleDyJsapiPayFlowResult, 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, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };
+export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type HandleDyAuthDebitSignFlowResult, type HandleDyJsapiPayFlowParams, type HandleDyJsapiPayFlowResult, 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, handleDyAuthDebitSignFlow, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };