confirmPayment()

2026-06-26 11:26

Note: Translation in progress.

confirmPayment() 方法由商户应用调用，用于针对当前组件实例提交并确认支付。

注意：
通常应在 setOnSubmitPayListener() 的回调中调用此方法。
该方法与 createComponent() 互斥。
paymentSessionData 必须从服务端 createPaymentSession（单笔支付）接口响应中获取。

方法签名

copy
Future<void> confirmPayment(
  String paymentSessionData,
  void Function(AMSStatusResult) onResult,
)

参数	类型	是否必需	描述
paymentSessionData	String	是	支付会话数据。将从 createPaymentSession（单笔支付）接口响应中获取的完整 paymentSessionData 传入此参数。
onResult	Function	是	支付确认结果回调函数。用于返回支付确认成功或失败的结果。

confirmPayment() 方法的结果回调，接收一个 AMSStatusResult 对象，指示支付确认是否成功。

参数	类型	是否必需	描述
result	AMSStatusResult	是	包含支付确认状态和错误详情的状态结果。

此方法无返回值，确认结果通过 onResult 回调异步返回。

结果（code）	状态（status）	建议给买家的提示（message）	描述	操作建议
`PARAM_INVALID`	N/A	请求异常，交易无法发起。	SDK 入参异常。	集成代码异常，请自行排查。有问题联系 Antom 技术支持。
`UI_STATE_ERROR`	N/A	请求异常，交易无法发起。	创建 SDK 实例或 `createComponent()` 时机异常。	集成代码异常，请自行排查。有问题联系 Antom 技术支持。
`INITIALIZE_WEB_TIMEOUT`	N/A	请求异常，交易无法发起。	收银台静态资源加载超时。	用户网络异常或 Antom 服务异常，建议重试 `createComponnet()`。