getOrderPayment
使用预下单返回的平台交易订单号拉起用户收银台。
支持版本
前端库版本不低于 0.0.28。
支持平台
支持场景
接入准备
前置条件
- Android:需用户已登录并完成抖音账号绑定,且当前处于前台可见页面
- iOS:需用户已登录并完成抖音账号绑定
使用说明
直接调用此 API 时,业务只传入 orderId,用于普通支付收银台流程。
豆包平台免密支付应使用 DoubaoPaymentButton,由组件查询当前用户的免密可用状态,
并在用户选择免密支付时携带平台返回的免密支付方式参数;业务不能自行构造该参数。
当账号未绑定、发生换绑或平台判断免密不可用时,应以组件展示的普通支付路径为准。
此 API 成功仅表示收银台已正常拉起并完成前端交互,不代表订单支付成功。 最终支付状态必须以业务服务端查询订单详情的结果或业务服务端收到的支付结果回调为准。
- 调用会拉起收银台并需要用户交互,请在用户明确触发支付的交互场景中调用;请勿在无用户操作的后台逻辑中调用。
调用方式
异步 API
入参
调用示例
成功返回
返回示例
错误处理
错误对象和通用错误码见 通用错误处理。
失败示例
错误码
通用错误码
平台差异
- Android:需在前台可见的 Activity 中调用,应用退至后台或无有效页面时会返回失败。
- Android:用户主动取消支付时返回顶层 errNo 114(operation cancelled);iOS 在该场景不返回顶层专属 errNo。