@bi-nova/services 1.3.4 → 1.4.0-beta.202606161442

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -228,16 +228,62 @@ declare function handleJdInsurance(options: {
228
228
  */
229
229
  declare function handleJdInsuranceExt(businessParams: JdInsuranceExternalOptions): Promise<BuildResultReturn>;
230
230
 
231
+ /** 支付结果返回类型 */
232
+ type DyPayReturnType = 'h5' | 'ulink' | 'jsapi';
233
+ /** 抖音 SDK 支付参数 */
234
+ interface DyPayInfo {
235
+ /** 支付时间戳 */
236
+ timeStamp: string;
237
+ /** 支付随机字符串 */
238
+ nonceStr: string;
239
+ /** 预支付包信息 */
240
+ package: string;
241
+ /** 签名类型 */
242
+ signType: string;
243
+ /** 支付签名 */
244
+ paySign: string;
245
+ }
246
+
231
247
  /** 客户端类型 */
232
248
  type ClientType = 'weapp' | 'h5';
249
+ /** 支付结果返回类型 */
250
+ type ReturnType = DyPayReturnType;
233
251
  /** 小程序页面跳转方式 */
234
252
  type BackWay = 'switchTab' | 'reLaunch' | 'redirectTo' | 'navigateTo';
253
+ /** 抖音支付回调结果 */
254
+ type DouyinPayResult = any;
255
+ /** 抖音 JSAPI 授权支付聚合流程入参 */
256
+ interface HandleDyJsapiPayFlowParams extends Omit<HandleDyPayFlowParams, 'returnType' | 'client'> {
257
+ /** 当前授权 token,不传则从 createServices().getAuthToken 读取 */
258
+ authToken?: string;
259
+ /** 无授权 token 时是否自动跳转抖音授权,默认 true */
260
+ autoAuth?: boolean;
261
+ /** 抖音授权完成后的回跳页面地址,默认取当前浏览器地址 */
262
+ redirectUrl?: string;
263
+ /** 授权 token 参数名,默认 url_token */
264
+ tokenParamName?: string;
265
+ /** 抖音开放 SDK 地址,不传则使用默认 CDN 地址 */
266
+ sdkUrl?: string;
267
+ /** JSSDK 签名 URL,不传则根据当前页面地址自动生成 */
268
+ signatureUrl?: string;
269
+ }
270
+ /** 抖音 JSAPI 授权支付聚合流程返回数据 */
271
+ interface HandleDyJsapiPayFlowResult {
272
+ /** 结果类型:auth_redirect 表示已跳转授权,pay_result 表示已完成支付调起 */
273
+ type: 'auth_redirect' | 'pay_result';
274
+ /** 抖音授权地址,type 为 auth_redirect 时返回 */
275
+ authUrl?: string;
276
+ /** 商户订单号,type 为 pay_result 时返回 */
277
+ outTradeNo?: string;
278
+ /** 抖音支付回调结果,type 为 pay_result 时返回 */
279
+ payResult?: DouyinPayResult;
280
+ }
235
281
  /** handleDyPayFlow 入参 */
236
282
  interface HandleDyPayFlowParams {
237
283
  /** 商品金额(必传,单位:元) */
238
284
  price: number;
239
- /** 手机号(必传) */
240
- telephone: string;
285
+ /** 手机号(returnType 为 h5 或未传时必传) */
286
+ telephone?: string;
241
287
  /** 设备编号(必传) */
242
288
  equipmentValue: string;
243
289
  /** 业务类型(必传) */
@@ -246,6 +292,13 @@ interface HandleDyPayFlowParams {
246
292
  platformActivities?: Record<string, any>;
247
293
  /** 客户端(可传,默认 weapp) */
248
294
  client?: ClientType;
295
+ /**
296
+ * 支付结果返回类型(可传,默认 h5)
297
+ * - h5:返回 H5 收银台中转页 URL(data.h5Url)
298
+ * - ulink:返回抖音 ulink 中转页 URL(data.ulinkUrl)
299
+ * - jsapi:返回抖音 SDK 支付参数(data.payInfo)
300
+ */
301
+ returnType?: ReturnType;
249
302
  /** 下单参数透传(非必传) */
250
303
  douyinOrderExtendData?: string;
251
304
  /** 是否是虚拟商品(非必传) */
@@ -277,17 +330,23 @@ interface HandleDyPayFlowParams {
277
330
  }
278
331
  /** handleDyPayFlow 返回数据 */
279
332
  interface HandleDyPayFlowResult {
280
- /** H5 收银台地址 */
281
- h5Url: string;
333
+ /** H5 收银台地址(returnType 为 'h5' 或未传时返回) */
334
+ h5Url?: string;
335
+ /** 抖音 ulink 中转页地址(returnType 为 'ulink' 时返回) */
336
+ ulinkQueryParams?: Record<string, any>;
282
337
  /** 订单号 */
283
- outTradeNo: string;
338
+ outTradeNo?: string;
339
+ /** 抖音 SDK 支付参数,JSAPI 模式返回 */
340
+ payInfo?: DyPayInfo;
341
+ /** JSAPI 支付应用标识,JSAPI 模式返回 */
342
+ appId?: string;
284
343
  }
285
344
  /** GetDyPayRtaDataParams 入参 */
286
345
  interface GetDyPayRtaDataParams {
287
346
  /** 商品金额(非必传,单位:元) */
288
347
  price?: number;
289
- /** 手机号(必传) */
290
- telephone: string;
348
+ /** 手机号(非必传) */
349
+ telephone?: string;
291
350
  /** 设备编号(必传) */
292
351
  equipmentValue: string;
293
352
  }
@@ -306,6 +365,30 @@ interface GetDyPayRtaDataResult {
306
365
  /** 优惠金额(预留) */
307
366
  discountAmount: boolean;
308
367
  }
368
+ /** handleDyPayCommandFlow 入参 */
369
+ interface HandleDyPayCommandFlowParams {
370
+ /** 用户手机号,未传时 RTA 和口令接口按空字符串透传 */
371
+ telephone?: string;
372
+ /** 设备编号 */
373
+ equipmentValue: string;
374
+ /** RTA 查询金额,可选;不传则按 RTA 接口默认逻辑处理 */
375
+ price?: number;
376
+ /** 指定生成口令的地址,不传则使用服务端默认地址 */
377
+ commandUrl?: string;
378
+ /** 是否自动复制口令,默认 false */
379
+ autoCopy?: boolean;
380
+ /** 自动复制成功后是否返回口令文本,默认 false */
381
+ returnCommand?: boolean;
382
+ }
383
+ /** handleDyPayCommandFlow 返回数据 */
384
+ interface HandleDyPayCommandFlowResult {
385
+ /** 是否符合获取口令条件 */
386
+ eligible: boolean;
387
+ /** 结果类型 */
388
+ type: 'command' | 'copy_success' | 'not_eligible';
389
+ /** 抖音支付口令 */
390
+ command?: string;
391
+ }
309
392
 
310
393
  /**
311
394
  * 处理抖音支付流程
@@ -318,13 +401,18 @@ interface GetDyPayRtaDataResult {
318
401
  * @param {Record<string, any>} params.platformActivities 平台活动(非必传)
319
402
  * @param {boolean} params.douyinCommodityVirtualFlag 是否是虚拟商品(非必传)
320
403
  * @param {string} params.client 客户端(必传,默认是weapp)weapp 或者 h5
404
+ * @param {'h5' | 'ulink' | 'jsapi'} params.returnType 支付结果返回类型(非必传,默认 h5)。h5 返回 H5 收银台中转页 URL(data.h5Url),ulink 返回抖音 ulink 中转页 URL(data.ulinkUrl),jsapi 返回抖音 SDK 支付参数(data.payInfo)
321
405
  * @param {string} params.backUrl 抖音支付成功后返回的页面地址(必传,不传则不跳转)根据client值来决定跳转方式。如果跳转地址有带参数,backUrl一定要记得编码
322
406
  * @param {string} params.backWay 小程序页面跳转方式(仅在小程序环境下生效,H5 环境忽略)可传 switchTab | reLaunch | redirectTo | navigateTo
323
407
  * @param {string} params.fromUrl 抖音支付完成后返回的上一级页面地址(仅在小程序环境下生效,H5 环境忽略)
324
408
  * @param {Record<string, any>} params.unifiedOrderExtendData 下单接口额外透传参数(非必传)
325
- * @returns 返回标准化结果,接入方自行打开 webview 或 H5 跳转
409
+ * @returns 返回标准化结果,returnType 为 h5 时返回 h5Url,ulink 时返回 ulinkUrl,jsapi 时返回 payInfo,接入方自行调起支付
326
410
  */
327
411
  declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildResultReturn<HandleDyPayFlowResult>>;
412
+ /**
413
+ * 构建抖音支付ulink链接
414
+ * @returns lyy ulink支付中转页
415
+ */
328
416
  /**
329
417
  * 获取rta信息
330
418
  * @param params.price 套餐金额(必传)
@@ -333,13 +421,34 @@ declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildRe
333
421
  * @returns 返回标准化结果,包含 showFlag 表示是否展示活动
334
422
  */
335
423
  declare function getDyPayRtaData(params: GetDyPayRtaDataParams): Promise<BuildResultReturn<GetDyPayRtaDataResult>>;
424
+ /**
425
+ * 处理抖音支付口令完整流程
426
+ * @param params.telephone 用户手机号,非必传;未传时 RTA 和口令接口按空字符串透传
427
+ * @param params.equipmentValue 设备编号
428
+ * @param params.price RTA 查询金额,可选
429
+ * @param params.commandUrl 指定生成口令的地址,不传则使用服务端默认地址
430
+ * @param params.autoCopy 是否自动复制口令,默认 false
431
+ * @param params.returnCommand 自动复制成功后是否返回口令文本,默认 false
432
+ * @returns 返回标准化结果,包含资格判断、口令或复制结果
433
+ */
434
+ declare function handleDyPayCommandFlow(params: HandleDyPayCommandFlowParams): Promise<BuildResultReturn<HandleDyPayCommandFlowResult>>;
435
+ /**
436
+ * 处理抖音 JSAPI 授权支付聚合流程
437
+ *
438
+ * 内部完成授权 token 检查、抖音开放 SDK 加载、JSAPI 模式下单、JSSDK 验签初始化和 dypay 调起。
439
+ * 无授权 token 且 autoAuth 不为 false 时,会自动跳转抖音授权。
440
+ *
441
+ * @param params 抖音 JSAPI 授权支付聚合流程入参
442
+ * @returns 返回标准化结果,授权跳转时 type=auth_redirect,支付调起完成时 type=pay_result
443
+ */
444
+ declare function handleDyJsapiPayFlow(params: HandleDyJsapiPayFlowParams): Promise<BuildResultReturn<HandleDyJsapiPayFlowResult>>;
336
445
 
337
446
  /**
338
447
  * @Description: 业务错误码定义
339
448
  * @Author: wutao
340
449
  * @Date: 2026-03-30
341
450
  * @LastEditors: wutao
342
- * @LastEditTime: 2026-03-30
451
+ * @LastEditTime: 2026-06-08 10:30:00
343
452
  *
344
453
  * 错误码分段规则:
345
454
  * - 0: 成功
@@ -436,7 +545,43 @@ declare enum DyErrorCode {
436
545
  /** 无效的小程序跳转方式 */
437
546
  DY_PAY__INVALID_BACK_WAY = 3016,
438
547
  /** 缺少业务类型参数 */
439
- DY_PAY__MISSING_BUSINESS_TYPE = 3017
548
+ DY_PAY__MISSING_BUSINESS_TYPE = 3017,
549
+ /** 无效的返回地址类型 */
550
+ DY_PAY__INVALID_RETURN_TYPE = 3018,
551
+ /** 获取 JSAPI 支付信息失败 */
552
+ DY_PAY__JSAPI_INFO_FAILED = 3019,
553
+ /** 获取 JSAPI 支付信息请求失败 */
554
+ DY_PAY__REQUEST_JSAPI_INFO_FAILED = 3020,
555
+ /** 缺少 JSAPI 支付参数 */
556
+ DY_PAY__MISSING_JSAPI_PAY_INFO = 3021,
557
+ /** JSAPI 支付参数格式不正确 */
558
+ DY_PAY__INVALID_JSAPI_PAY_INFO = 3022,
559
+ /** 获取 JSAPI 支付签名失败 */
560
+ DY_PAY__JSAPI_SIGNATURE_FAILED = 3023,
561
+ /** 获取 JSAPI 支付签名请求失败 */
562
+ DY_PAY__REQUEST_JSAPI_SIGNATURE_FAILED = 3024,
563
+ /** 当前环境不支持抖音 JSAPI 支付 */
564
+ DY_PAY__JSAPI_UNSUPPORTED_ENV = 3025,
565
+ /** 抖音授权跳转失败 */
566
+ DY_PAY__JSAPI_AUTH_REDIRECT_FAILED = 3026,
567
+ /** 抖音开放 SDK 加载失败 */
568
+ DY_PAY__JSAPI_SDK_LOAD_FAILED = 3027,
569
+ /** 抖音 JSSDK 初始化失败 */
570
+ DY_PAY__JSAPI_CONFIG_FAILED = 3028,
571
+ /** 抖音 JSAPI 支付调起失败 */
572
+ DY_PAY__JSAPI_INVOKE_FAILED = 3029,
573
+ /** 缺少抖音授权 token */
574
+ DY_PAY__MISSING_AUTH_TOKEN = 3030,
575
+ /** 缺少抖音支付口令金额 */
576
+ DY_PAY_COMMAND__MISSING_ORDER_AMOUNT = 3031,
577
+ /** 获取抖音支付口令失败 */
578
+ DY_PAY_COMMAND__GET_FAILED = 3032,
579
+ /** 获取抖音支付口令请求失败 */
580
+ DY_PAY_COMMAND__REQUEST_FAILED = 3033,
581
+ /** 抖音支付口令复制失败 */
582
+ DY_PAY_COMMAND__COPY_FAILED = 3034,
583
+ /** 抖音支付口令 RTA 数据无效 */
584
+ DY_PAY_COMMAND__INVALID_RTA_DATA = 3035
440
585
  }
441
586
  /**
442
587
  * 抖音业务错误信息映射
@@ -643,4 +788,4 @@ declare function normalizeDisplayAdData(advertConfigs: AdvertConfigItem[], fallb
643
788
  */
644
789
  declare function getDisplayAdConfig(options: GetDisplayAdOptions): Promise<BuildResultReturn<DisplayAdResult>>;
645
790
 
646
- 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 };
791
+ 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 };
package/dist/index.d.ts CHANGED
@@ -228,16 +228,62 @@ declare function handleJdInsurance(options: {
228
228
  */
229
229
  declare function handleJdInsuranceExt(businessParams: JdInsuranceExternalOptions): Promise<BuildResultReturn>;
230
230
 
231
+ /** 支付结果返回类型 */
232
+ type DyPayReturnType = 'h5' | 'ulink' | 'jsapi';
233
+ /** 抖音 SDK 支付参数 */
234
+ interface DyPayInfo {
235
+ /** 支付时间戳 */
236
+ timeStamp: string;
237
+ /** 支付随机字符串 */
238
+ nonceStr: string;
239
+ /** 预支付包信息 */
240
+ package: string;
241
+ /** 签名类型 */
242
+ signType: string;
243
+ /** 支付签名 */
244
+ paySign: string;
245
+ }
246
+
231
247
  /** 客户端类型 */
232
248
  type ClientType = 'weapp' | 'h5';
249
+ /** 支付结果返回类型 */
250
+ type ReturnType = DyPayReturnType;
233
251
  /** 小程序页面跳转方式 */
234
252
  type BackWay = 'switchTab' | 'reLaunch' | 'redirectTo' | 'navigateTo';
253
+ /** 抖音支付回调结果 */
254
+ type DouyinPayResult = any;
255
+ /** 抖音 JSAPI 授权支付聚合流程入参 */
256
+ interface HandleDyJsapiPayFlowParams extends Omit<HandleDyPayFlowParams, 'returnType' | 'client'> {
257
+ /** 当前授权 token,不传则从 createServices().getAuthToken 读取 */
258
+ authToken?: string;
259
+ /** 无授权 token 时是否自动跳转抖音授权,默认 true */
260
+ autoAuth?: boolean;
261
+ /** 抖音授权完成后的回跳页面地址,默认取当前浏览器地址 */
262
+ redirectUrl?: string;
263
+ /** 授权 token 参数名,默认 url_token */
264
+ tokenParamName?: string;
265
+ /** 抖音开放 SDK 地址,不传则使用默认 CDN 地址 */
266
+ sdkUrl?: string;
267
+ /** JSSDK 签名 URL,不传则根据当前页面地址自动生成 */
268
+ signatureUrl?: string;
269
+ }
270
+ /** 抖音 JSAPI 授权支付聚合流程返回数据 */
271
+ interface HandleDyJsapiPayFlowResult {
272
+ /** 结果类型:auth_redirect 表示已跳转授权,pay_result 表示已完成支付调起 */
273
+ type: 'auth_redirect' | 'pay_result';
274
+ /** 抖音授权地址,type 为 auth_redirect 时返回 */
275
+ authUrl?: string;
276
+ /** 商户订单号,type 为 pay_result 时返回 */
277
+ outTradeNo?: string;
278
+ /** 抖音支付回调结果,type 为 pay_result 时返回 */
279
+ payResult?: DouyinPayResult;
280
+ }
235
281
  /** handleDyPayFlow 入参 */
236
282
  interface HandleDyPayFlowParams {
237
283
  /** 商品金额(必传,单位:元) */
238
284
  price: number;
239
- /** 手机号(必传) */
240
- telephone: string;
285
+ /** 手机号(returnType 为 h5 或未传时必传) */
286
+ telephone?: string;
241
287
  /** 设备编号(必传) */
242
288
  equipmentValue: string;
243
289
  /** 业务类型(必传) */
@@ -246,6 +292,13 @@ interface HandleDyPayFlowParams {
246
292
  platformActivities?: Record<string, any>;
247
293
  /** 客户端(可传,默认 weapp) */
248
294
  client?: ClientType;
295
+ /**
296
+ * 支付结果返回类型(可传,默认 h5)
297
+ * - h5:返回 H5 收银台中转页 URL(data.h5Url)
298
+ * - ulink:返回抖音 ulink 中转页 URL(data.ulinkUrl)
299
+ * - jsapi:返回抖音 SDK 支付参数(data.payInfo)
300
+ */
301
+ returnType?: ReturnType;
249
302
  /** 下单参数透传(非必传) */
250
303
  douyinOrderExtendData?: string;
251
304
  /** 是否是虚拟商品(非必传) */
@@ -277,17 +330,23 @@ interface HandleDyPayFlowParams {
277
330
  }
278
331
  /** handleDyPayFlow 返回数据 */
279
332
  interface HandleDyPayFlowResult {
280
- /** H5 收银台地址 */
281
- h5Url: string;
333
+ /** H5 收银台地址(returnType 为 'h5' 或未传时返回) */
334
+ h5Url?: string;
335
+ /** 抖音 ulink 中转页地址(returnType 为 'ulink' 时返回) */
336
+ ulinkQueryParams?: Record<string, any>;
282
337
  /** 订单号 */
283
- outTradeNo: string;
338
+ outTradeNo?: string;
339
+ /** 抖音 SDK 支付参数,JSAPI 模式返回 */
340
+ payInfo?: DyPayInfo;
341
+ /** JSAPI 支付应用标识,JSAPI 模式返回 */
342
+ appId?: string;
284
343
  }
285
344
  /** GetDyPayRtaDataParams 入参 */
286
345
  interface GetDyPayRtaDataParams {
287
346
  /** 商品金额(非必传,单位:元) */
288
347
  price?: number;
289
- /** 手机号(必传) */
290
- telephone: string;
348
+ /** 手机号(非必传) */
349
+ telephone?: string;
291
350
  /** 设备编号(必传) */
292
351
  equipmentValue: string;
293
352
  }
@@ -306,6 +365,30 @@ interface GetDyPayRtaDataResult {
306
365
  /** 优惠金额(预留) */
307
366
  discountAmount: boolean;
308
367
  }
368
+ /** handleDyPayCommandFlow 入参 */
369
+ interface HandleDyPayCommandFlowParams {
370
+ /** 用户手机号,未传时 RTA 和口令接口按空字符串透传 */
371
+ telephone?: string;
372
+ /** 设备编号 */
373
+ equipmentValue: string;
374
+ /** RTA 查询金额,可选;不传则按 RTA 接口默认逻辑处理 */
375
+ price?: number;
376
+ /** 指定生成口令的地址,不传则使用服务端默认地址 */
377
+ commandUrl?: string;
378
+ /** 是否自动复制口令,默认 false */
379
+ autoCopy?: boolean;
380
+ /** 自动复制成功后是否返回口令文本,默认 false */
381
+ returnCommand?: boolean;
382
+ }
383
+ /** handleDyPayCommandFlow 返回数据 */
384
+ interface HandleDyPayCommandFlowResult {
385
+ /** 是否符合获取口令条件 */
386
+ eligible: boolean;
387
+ /** 结果类型 */
388
+ type: 'command' | 'copy_success' | 'not_eligible';
389
+ /** 抖音支付口令 */
390
+ command?: string;
391
+ }
309
392
 
310
393
  /**
311
394
  * 处理抖音支付流程
@@ -318,13 +401,18 @@ interface GetDyPayRtaDataResult {
318
401
  * @param {Record<string, any>} params.platformActivities 平台活动(非必传)
319
402
  * @param {boolean} params.douyinCommodityVirtualFlag 是否是虚拟商品(非必传)
320
403
  * @param {string} params.client 客户端(必传,默认是weapp)weapp 或者 h5
404
+ * @param {'h5' | 'ulink' | 'jsapi'} params.returnType 支付结果返回类型(非必传,默认 h5)。h5 返回 H5 收银台中转页 URL(data.h5Url),ulink 返回抖音 ulink 中转页 URL(data.ulinkUrl),jsapi 返回抖音 SDK 支付参数(data.payInfo)
321
405
  * @param {string} params.backUrl 抖音支付成功后返回的页面地址(必传,不传则不跳转)根据client值来决定跳转方式。如果跳转地址有带参数,backUrl一定要记得编码
322
406
  * @param {string} params.backWay 小程序页面跳转方式(仅在小程序环境下生效,H5 环境忽略)可传 switchTab | reLaunch | redirectTo | navigateTo
323
407
  * @param {string} params.fromUrl 抖音支付完成后返回的上一级页面地址(仅在小程序环境下生效,H5 环境忽略)
324
408
  * @param {Record<string, any>} params.unifiedOrderExtendData 下单接口额外透传参数(非必传)
325
- * @returns 返回标准化结果,接入方自行打开 webview 或 H5 跳转
409
+ * @returns 返回标准化结果,returnType 为 h5 时返回 h5Url,ulink 时返回 ulinkUrl,jsapi 时返回 payInfo,接入方自行调起支付
326
410
  */
327
411
  declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildResultReturn<HandleDyPayFlowResult>>;
412
+ /**
413
+ * 构建抖音支付ulink链接
414
+ * @returns lyy ulink支付中转页
415
+ */
328
416
  /**
329
417
  * 获取rta信息
330
418
  * @param params.price 套餐金额(必传)
@@ -333,13 +421,34 @@ declare function handleDyPayFlow(params: HandleDyPayFlowParams): Promise<BuildRe
333
421
  * @returns 返回标准化结果,包含 showFlag 表示是否展示活动
334
422
  */
335
423
  declare function getDyPayRtaData(params: GetDyPayRtaDataParams): Promise<BuildResultReturn<GetDyPayRtaDataResult>>;
424
+ /**
425
+ * 处理抖音支付口令完整流程
426
+ * @param params.telephone 用户手机号,非必传;未传时 RTA 和口令接口按空字符串透传
427
+ * @param params.equipmentValue 设备编号
428
+ * @param params.price RTA 查询金额,可选
429
+ * @param params.commandUrl 指定生成口令的地址,不传则使用服务端默认地址
430
+ * @param params.autoCopy 是否自动复制口令,默认 false
431
+ * @param params.returnCommand 自动复制成功后是否返回口令文本,默认 false
432
+ * @returns 返回标准化结果,包含资格判断、口令或复制结果
433
+ */
434
+ declare function handleDyPayCommandFlow(params: HandleDyPayCommandFlowParams): Promise<BuildResultReturn<HandleDyPayCommandFlowResult>>;
435
+ /**
436
+ * 处理抖音 JSAPI 授权支付聚合流程
437
+ *
438
+ * 内部完成授权 token 检查、抖音开放 SDK 加载、JSAPI 模式下单、JSSDK 验签初始化和 dypay 调起。
439
+ * 无授权 token 且 autoAuth 不为 false 时,会自动跳转抖音授权。
440
+ *
441
+ * @param params 抖音 JSAPI 授权支付聚合流程入参
442
+ * @returns 返回标准化结果,授权跳转时 type=auth_redirect,支付调起完成时 type=pay_result
443
+ */
444
+ declare function handleDyJsapiPayFlow(params: HandleDyJsapiPayFlowParams): Promise<BuildResultReturn<HandleDyJsapiPayFlowResult>>;
336
445
 
337
446
  /**
338
447
  * @Description: 业务错误码定义
339
448
  * @Author: wutao
340
449
  * @Date: 2026-03-30
341
450
  * @LastEditors: wutao
342
- * @LastEditTime: 2026-03-30
451
+ * @LastEditTime: 2026-06-08 10:30:00
343
452
  *
344
453
  * 错误码分段规则:
345
454
  * - 0: 成功
@@ -436,7 +545,43 @@ declare enum DyErrorCode {
436
545
  /** 无效的小程序跳转方式 */
437
546
  DY_PAY__INVALID_BACK_WAY = 3016,
438
547
  /** 缺少业务类型参数 */
439
- DY_PAY__MISSING_BUSINESS_TYPE = 3017
548
+ DY_PAY__MISSING_BUSINESS_TYPE = 3017,
549
+ /** 无效的返回地址类型 */
550
+ DY_PAY__INVALID_RETURN_TYPE = 3018,
551
+ /** 获取 JSAPI 支付信息失败 */
552
+ DY_PAY__JSAPI_INFO_FAILED = 3019,
553
+ /** 获取 JSAPI 支付信息请求失败 */
554
+ DY_PAY__REQUEST_JSAPI_INFO_FAILED = 3020,
555
+ /** 缺少 JSAPI 支付参数 */
556
+ DY_PAY__MISSING_JSAPI_PAY_INFO = 3021,
557
+ /** JSAPI 支付参数格式不正确 */
558
+ DY_PAY__INVALID_JSAPI_PAY_INFO = 3022,
559
+ /** 获取 JSAPI 支付签名失败 */
560
+ DY_PAY__JSAPI_SIGNATURE_FAILED = 3023,
561
+ /** 获取 JSAPI 支付签名请求失败 */
562
+ DY_PAY__REQUEST_JSAPI_SIGNATURE_FAILED = 3024,
563
+ /** 当前环境不支持抖音 JSAPI 支付 */
564
+ DY_PAY__JSAPI_UNSUPPORTED_ENV = 3025,
565
+ /** 抖音授权跳转失败 */
566
+ DY_PAY__JSAPI_AUTH_REDIRECT_FAILED = 3026,
567
+ /** 抖音开放 SDK 加载失败 */
568
+ DY_PAY__JSAPI_SDK_LOAD_FAILED = 3027,
569
+ /** 抖音 JSSDK 初始化失败 */
570
+ DY_PAY__JSAPI_CONFIG_FAILED = 3028,
571
+ /** 抖音 JSAPI 支付调起失败 */
572
+ DY_PAY__JSAPI_INVOKE_FAILED = 3029,
573
+ /** 缺少抖音授权 token */
574
+ DY_PAY__MISSING_AUTH_TOKEN = 3030,
575
+ /** 缺少抖音支付口令金额 */
576
+ DY_PAY_COMMAND__MISSING_ORDER_AMOUNT = 3031,
577
+ /** 获取抖音支付口令失败 */
578
+ DY_PAY_COMMAND__GET_FAILED = 3032,
579
+ /** 获取抖音支付口令请求失败 */
580
+ DY_PAY_COMMAND__REQUEST_FAILED = 3033,
581
+ /** 抖音支付口令复制失败 */
582
+ DY_PAY_COMMAND__COPY_FAILED = 3034,
583
+ /** 抖音支付口令 RTA 数据无效 */
584
+ DY_PAY_COMMAND__INVALID_RTA_DATA = 3035
440
585
  }
441
586
  /**
442
587
  * 抖音业务错误信息映射
@@ -643,4 +788,4 @@ declare function normalizeDisplayAdData(advertConfigs: AdvertConfigItem[], fallb
643
788
  */
644
789
  declare function getDisplayAdConfig(options: GetDisplayAdOptions): Promise<BuildResultReturn<DisplayAdResult>>;
645
790
 
646
- 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 };
791
+ 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 };