createComponent()

2026-06-26 10:40

createComponent() 方法由商户应用调用，用于创建并展示支付或绑卡组件 UI。

注意：
该方法必须在 init() 之后调用。
该方法与 confirmPayment() 互斥。
Payment Element 场景下 paymentSessionData 必须从服务端 createPaymentSession（单笔支付）接口响应中获取。
Vaulting Element 场景下 vaultingSessionData 必须从服务端 createVaultingSession 接口响应中获取。

方法签名

Payment Element 场景

Vaulting Element 场景

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

参数

参数	类型	是否必需	描述
paymentSessionData	String	是	支付会话数据。将从 createPaymentSession（单笔支付）接口响应中获取的完整 paymentSessionData 传入此参数。注意：Payment Element 场景下该参数为必传，且与 vaultSessionData 必须二者传入任一。
vaultSessionData	String	是	绑卡会话数据。将从 createVaultingSession 接口响应中获取的完整 vaultingSessionData 传入此参数。注意：Vaulting Element 场景下该参数为必传，且与 paymentSessionData 必须二者传入任一。
onResult	Function	是	组件创建结果回调函数。用于返回组件创建成功或失败的结果。详见 `onResult`。

onResult

createComponent() 方法的结果回调，接收一个 AMSStatusResult 对象，指示组件是否创建成功。

参数	类型	是否必需	描述
result	AMSStatusResult	是	包含组件创建状态和错误详情的状态结果。

返回值

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

错误码

错误信息通过 onResult 回调中的 AMSStatusResult 返回。当 getStatus() 返回 FAIL 时，可通过 getError() 获取错误详情。

结果码（code）	状态（status）	建议给买家的提示（message）	描述	操作建议
`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()`。