createComponent()

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

注意：

方法签名

Payment 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() 获取错误详情。

Payment Element 场景

结果码（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()。