createComponent()

2026-06-26 11:26

Note: Translation in progress.

createComponent() 方法用于创建并展示支付或绑卡组件 UI。

注意：
此方法必须在主线程中调用。
该方法与confirmPayment() 互斥。

方法签名

Java

Kotlin

copy
public void createComponent(Activity activity, String sessionData)

参数

类型

是否必需

描述

activity

Activity

是

用于展示支付或绑卡组件的当前 Activity 上下文。

sessionData

String

是

支付或资产绑定会话数据。根据不同的场景完成对应的配置：

Payment Element 支付场景：将从 createPaymentSession（单笔支付） 接口响应中获取的完整 paymentSessionData 传入此参数。
Vaulting Element 绑卡场景：将从 createVaultingSession 接口响应中获取的完整 vaultingSessionData 传入此参数。

返回值

此方法无返回值。

错误码

Payment Element 场景

结果码（code）	状态（status）	建议给买家的提示（message）	描述	操作建议
`UNKNOWN_EXCEPTION`	`PROCESSING`	未知异常。请检查付款情况并联系商户。	由于未知原因，方法调用失败。	详细原因请咨询 Antom 技术支持。建议商户尝试从服务端轮询支付结果。若未查到支付结果，可以在会话有效期内使用原有的 paymentSessionData 重新调用 `createComponent()`。
`ORDER_IS_CANCELLED`	`FAIL`	订单状态异常。请检查付款情况并联系商户。	订单已撤销。	商户主动撤销订单，请自行排查。
`ORDER_IS_CLOSED`	`FAIL`	订单状态异常。请检查付款情况并联系商户。	您发起的请求具有与已关闭交易相同的 paymentRequestId。	订单已超时关单，使用新的 paymentRequestId 重新发起支付。
`INQUIRY_PAYMENT_SESSION_FAILED`	`FAIL`	订单状态异常。请检查付款情况并联系商户	支付会话过期。	订单已超时关单，使用新的 paymentRequestId 重新发起支付。
`PARAM_INVALID`	N/A	请求异常，交易无法发起。	SDK 入参异常。	集成代码异常，请自行排查。有问题联系 Antom 技术支持。
`UI_STATE_ERROR`	N/A	请求异常，交易无法发起。	创建 SDK 实例或调用 `createComponent()` 的时机异常。	集成代码异常，请自行排查。有问题联系 Antom 技术支持。
`INITIALIZE_WEB_TIMEOUT`	N/A	请求异常，交易无法发起。	收银台静态资源加载超时。	用户网络异常或 Antom 服务异常，建议重新调用 `createComponent()`。
`PAYMENT_IN_PROCESS`	`PROCESSING`	支付正在处理中，请等待支付完成。	支付正在处理中。	支付正在处理中，建议商户尝试从服务端轮询支付结果。若未查到支付结果，可以在会话有效期内使用原有的 paymentSessionData 重新调用 `createComponent()`。
`PAYMENT_RESULT_TIMEOUT`	`PROCESSING`	请求异常，交易无法发起。	获取支付结果时网络异常。	尝试从服务端轮询支付结果。
`USER_CANCELED`	`PROCESSING`	无。	用户手动关闭展码/引导页弹窗。	可以在会话有效期内使用原有的 paymentSessionData 重新调用 `createComponent()`。
`INVALID_TRANSACTION`	`FAIL`	交易失败。请稍后重试或选择其他付款方式。	无效交易。	交易被判定为无效，可能原因：交易参数缺失/格式错误、风控规则拦截、交易重复提交、或渠道不支持该交易类型。建议检查请求参数完整性，引导用户稍后重试或更换支付方式。