antom.confirmCardSetup()

2026-04-17 17:37

antom.confirmCardSetup() 方法用于绑卡（Vaulting）场景，接收一个已挂载的 VaultingElement 实例以提交绑定请求，并返回一个仅会被解析的 Promise 对象，用于承载绑定结果。

注意：
调用 antom.confirmCardSetup() 前，必须先调用 element.mount() 将元素挂载到 DOM。
如果绑定流程需要 3D 验证，SDK 会自动弹出验证窗口，用户完成验证后继续流程。
PROCESSING 状态表示绑定仍在处理中，建议通过服务端 API 轮询查询最终状态。

方法签名

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

JavaScript

TypeScript

copy
antom.confirmCardSetup(options)

参数

此方法包含以下参数：

参数	类型	是否必需	描述
options	Object	是	独立绑卡确认所需的参数对象，包含已挂载的 Element 实例和重定向策略配置。

options

参数类型 是否必需 描述

elements

String

是

已挂载的 VaultingElement 实例。

redirect

String

否

重定向策略。有效值为：

always：SDK 自动跳转或唤端。
if_required：仅当支付方式强制需要时跳转，其余情况返回 URL 由商户自行处理。

返回值

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

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

error

参数	类型	是否必需	描述
code	String	是	错误码。
message	String	是	错误信息。
traceId	String	否	追踪 ID，用于问题排查。
context	Any	否	错误上下文信息。

错误码

调用 element.on() 方法监听 antom.confirmCardSetup() 方法相关的错误码。具体错误码列表请参见错误码。