antom.confirmPayment()

2026-04-17 09:37

antom.confirmPayment() 方法用于已存卡支付场景。当您指定一张已存卡发起支付后，该方法将根据配置参数自动决策是否收集 CVV 认证信息以及如何处理支付后的跳转流程。

方法签名

调用此方法时，请使用以下标准方法签名格式：

JavaScript

TypeScript

copy
antom.confirmPayment(params)

此方法包含以下参数：

参数	类型	是否必需	描述
params	Object	是	支付确认参数对象，包含会话数据、Element 实例、重定向策略等配置。

参数	类型	是否必需	描述
sessionData	String	是	支付会话数据，用于标识本次支付。
appearance	Object	否	外观设置，仅在不收集 CVV（即无 UI 支付）场景生效。更多信息请参阅自定义外观样式。
elements	String	否	已挂载的 `CVVElement` 实例。不传：无 UI 支付，不收集 CVV。传入自定义 CVV 元素：由该元素收集 CVV。
redirect	String	否	重定向策略。 `always`：SDK 自动跳转或唤端。 `if_required`：仅当支付方式强制需要时跳转，其余情况由商户自行处理。

此方法返回一个 Promise 对象，解析为支付结果对象，包括以下子参数：

参数	类型	是否必需	描述
status	String	是	支付状态。可根据 status 的值简化集成处理。您也可根据 `error?.code` 来进行精细化的异常处理。 `SUCCESS`：支付成功。 `PROCESSING`：支付处理中。 `CANCELLED`：支付已取消。 `FAIL`：支付失败。
userCanceled3D	Boolean	否	表示买家是否主动关闭 3D 安全认证弹窗。有效值为： `true`：买家主动中止 3D 过程。返回 `true` 时建议从服务端轮询结果。 `false`：非买家主动中止 3D 过程。
error	Object	否	该参数在操作失败时返回，且为错误对象，包含 code 和 message 参数。若无返回则操作成功。

参数	类型	是否必需	描述
code	String	是	错误码。
message	String	是	错误信息。
traceId	String	否	追踪 ID，用于日志链路查询。
context	Any	否	错误上下文信息。
needChangeSessionForRetry	Boolean	否	是否需要更换会话进行重试。