getOrderPaymentWithSign
使用预下单号和签约参数拉起支付并签约收银台。
支持版本
前端库版本不低于 0.0.28。
支持平台
支持场景
接入准备
前置条件
- Android:需用户已登录并完成抖音账号绑定,且当前处于前台可见页面
- iOS:需用户已登录并完成抖音账号绑定
使用说明
此 API 属于三方支付并签约流程,与支付按钮组件根据平台签约状态发起的豆包平台免密支付不是同一流程。
支付是主流程,签约是附带流程。如果签约参数无效,收银台会降级为仅支付。
signData 和 signDbAuthorization 必须由业务服务端生成,不能在前端自行构造。
此 API 成功不代表支付或签约成功,最终状态必须由业务服务端分别通过查询接口或结果回调确认。
- 调用会拉起收银台并需要用户交互,请在用户明确触发支付的交互场景中调用;请勿在无用户操作的后台逻辑中调用。
调用方式
异步 API
入参
调用示例
成功返回
返回示例
错误处理
错误对象和通用错误码见 通用错误处理。
失败示例
错误码
通用错误码
平台差异
- Android:需在前台可见的 Activity 中调用,应用退至后台或无有效页面时会返回失败。
- Android:用户主动取消支付时返回顶层 errNo 114(operation cancelled);iOS 在该场景不返回顶层专属 errNo。