createComponent()

2026-07-10 18:40

createComponent()

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

注意：

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

声明

Objective-C

Swift

参数

参数	类型	是否必需	描述
sessionData	String	是	支付或资产绑定会话数据。根据不同的场景完成对应的配置： Payment Element 支付场景：将从 createPaymentSession（单笔支付）接口响应中获取的完整 paymentSessionData 传入此参数。 Vaulting Element 绑卡场景：将从 createVaultingSession 接口响应中获取的完整 vaultingSessionData 传入此参数。
completion	(AMSStatusResult) -> Void	否	组件创建完成的回调。

返回值

此方法无返回值。

错误码

Payment Element 场景

Vaulting Element 场景

	状态（status）	建议给买家的提示（message）	描述	操作建议
UNKNOWN_EXCEPTION	PROCESSING	未知异常。请检查付款情况并联系商户	由于未知原因，方法调用失败。	详细原因请咨询 Antom 技术支持。建议商户尝试从服务端轮询支付结果。若未查到支付结果，在会话有效期内可以使用原有的 paymentSessionData 重新发起支付。
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 服务异常，建议重试 createComponnet() 。
PAYMENT_IN_PROCESS	PROCESSING	支付正在处理中，请等待支付完成。	支付正在处理中。	支付正在处理中，建议商户尝试从服务端轮询支付结果。若未查到支付结果，在会话有效期内可以使用原有的 paymentSessionData 重新发起支付。
PAYMENT_RESULT_TIMEOUT	PROCESSING	请求异常，交易无法发起。	获取支付结果时网络异常。	尝试从服务端轮询支付结果。
USER_CANCELED	PROCESSING	无。	用户手动关闭展码或引导页弹窗。	在会话有效期内可以使用原有的 paymentSessionData 重新发起支付。
INVALID_TRANSACTION	FAIL	如果交易失败，请不要重试。请联系 Antom 技术支持以获取更多信息。	无效交易。	交易被判定为无效，可能原因：交易参数缺失/格式错误、风控规则拦截、交易重复提交、或渠道不支持该交易类型。建议检查请求参数完整性。

	状态（status）	建议给买家的提示（message）	描述	操作建议
UNKNOWN_EXCEPTION	PROCESSING	未知异常。请检查付款情况并联系商户。	由于未知原因，接口调用失败。	尝试从服务端轮询结果。
PROCESS_FAIL	FAIL	系统异常。请检查付款情况并联系商户。	发生了常见的业务失败。	详细原因请咨询 Antom 技术支持。
SELECTED_CARD_BRAND_NOT_AVAILABLE	FAIL	卡品牌不支持。建议换卡重试或联系发卡行。	商户指定银行卡卡品牌不被支持。	商户指定的卡品牌不支持，请自行排查。
RISK_REJECT	FAIL	风控拒绝。建议换卡重试或联系发卡行。	由于风险控制，认证无法进一步处理。	详细原因请咨询 Antom 技术支持。
USER_BALANCE_NOT_ENOUGH	FAIL	用户余额不足。请充值或选择其它支付方式。	由于对应支付方式的用户余额不足，支付无法完成。	Antom 已提示用户，商户可忽略。
ACCESS_DENIED	FAIL	系统异常。请检查付款情况并联系商户	访问被拒绝。	请咨询 Antom 技术支持以获取详细原因。
CARD_EXPIRED	FAIL	卡片已过期，请核对过期日期或使用其他卡片。	银行卡过期。	Antom 已提示用户，商户可忽略。
INVALID_EXPIRATION_DATE	FAIL	卡片过期时间不正确，请核对过期日期或使用其他卡片。	paymentMethod.paymentMethodMetaData.expiryYear 或 paymentMethod.paymentMethodMetaData.expiryDate 的值无效。	Antom 已提示用户，商户可忽略。
INVALID_CVV	FAIL	卡片CVV不正确，请核对CVV或使用其他卡片。	CVV 代码无效。	Antom 已提示用户，商户可忽略。
INVALID_CARD_NUMBER	FAIL	卡号不正确。建议换卡重试或联系发卡行。	交易使用的卡号无效。	Antom 已提示用户，商户可忽略。
CARD_NOT_SUPPORTED	FAIL	卡片不支持。建议换卡重试或联系发卡行。	用于交易的银行卡不被支持。	Antom 已提示用户，商户可忽略。
FRAUD_REJECT	FAIL	我们很抱歉，但目前无法处理此交易。如果涉及付款，资金将自动退回到您的支付账户；无需进一步操作。	由于风险控制，交易无法进一步处理。如果用户已为交易付款，交易将被退款。	风控拦截：该笔交易因触发风险控制规则被终止。
DO_NOT_HONOR	FAIL	支付被发卡行拒绝。建议换卡重试或联系发卡行。	付款被发卡行拒绝。	请尝试使用其他银行卡支付，或联系发卡行。
PICKUP_CARD	FAIL	不允许使用该卡。请尝试其他卡片。	发卡行要求商户扣留支付卡。此类情况通常出现在疑似伪卡或盗刷场景中。	请立即联系发卡行，或使用其他卡完成支付。
ACCOUNT_CLOSED	FAIL	不允许使用该卡。请尝试其他卡片。	账户已关闭。请核实账户号码的准确性，同一银行卡号或令牌请勿再次处理。	请立即联系发卡行，或使用其他卡完成支付。
RESTRICTED_CARD	FAIL	卡片受限。请联系您的银行或尝试其他卡片。	发卡行限制了该卡的使用范围。	请立即联系发卡行，或使用其他卡完成支付。
BLOCKED_FIRST_USED	FAIL	被银行阻止。请联系您的银行或尝试其他卡片。	卡片可能因以下原因被临时冻结：未激活首次使用，或受特殊条件限制（例如新卡未激活）。	请持卡人激活新卡，或联系发卡行确认临时冻结状态及适用条件。
POLICY	FAIL	银行拒绝了付款。请重试或使用其他卡片。	政策限制。	持卡人应联系发卡行以确认原因。
PAYMENT_AMOUNT_EXCEED_LIMIT	FAIL	商户状态异常，交易无法发起。	支付金额超过了合同或支付方式允许的最大金额。	检查支付金额是否超过限制，或使用较低的金额再试一次请联系 Antom 技术支持了解具体限制。
CARD_BIN_QUERY_ERROR	FAIL	卡号不正确。建议换卡重试或联系发卡行。	用于交易的银行卡号无效。	Antom 已提示用户，商户可忽略。
VERIFICATION_IN_PROCESS	PROCESSING	正在绑定卡片，请稍候。	支付方式信息的验证正在进行中。	PROCESSING 代表 SDK 轮询后未查询到认证结果，建议从服务端轮询认证结果。
ORDER_IS_CLOSED	FAIL	订单状态异常。请检查付款情况并联系商户	交易已关闭，无法再次绑卡。	已超时关单，使用新的 vaultingRequestId 重新发起。
PARAM_ILLEGAL	FAIL	未知异常。请检查付款情况并联系商户	缺少必需的参数，或者存在非法参数。例如，非数字输入、无效的日期，或者参数的长度和类型错误。	检查并验证当前接口所需的请求字段（包括头字段和正文字段）是否正确传递并有效。
PAYMENT_COUNT_EXCEED_LIMIT	FAIL	商户支付次数超过限制使用次数，交易无法发起。	支付次数超过了支付方式规定的最大限制。	详细原因请咨询 Antom 技术支持。
STOLEN_CARD	FAIL	银行卡状态异常请联系发卡行或更换其他付款方式完成支付。	被盗卡（欺诈账户）。	持卡人应联系发卡行以确认原因。
LOST_CARD	FAIL	您的银行卡状态异常。请联系发卡银行或使用其他支付方式完成付款。	挂失卡（欺诈账户）。	持卡人应联系发卡行以确认原因。
AUTHENTICATION_REQUIRED	FAIL	需要额外的身份验证才能完成付款。	需要 3D Secure 验证。	重新启动支付并引导用户进行 3D Secure 认证。
VERIFY_TIMES_EXCEED_LIMIT	FAIL	验证码失败次数过多，请获取新验证码后重试	当前验证码在支付验证中失败次数过多。	用户必须获取新的验证代码。
USER_PAYMENT_VERIFICATION_FAILED	FAIL	用户状态异常。建议换卡重试或联系发卡行。	买家在 OTP 验证方式中未能通过支付验证。	弹窗提示用户。
PARAM_INVALID	N/A	请求异常，交易无法发起。	SDK 入参异常。	集成代码异常，请自行排查。有问题联系 Antom 技术支持
UI_STATE_ERROR	FAIL	请求异常，交易无法发起。	接口调用时机异常。	集成代码异常，请自行排查。有问题联系 Antom 技术支持
INITIALIZE_WEB_TIMEOUT	N/A	请求异常，交易无法发起。	收银台静态资源加载超时。	用户网络异常或 Antom 服务异常，建议重试。
UNKNOWN_ERROR	FAIL	发生了未知错误。请稍后再试或联系商家。	未知异常，兜底错误。	提示用户，让用户自行处理表单错误。
API_GATEWAY_TIMEOUT	PROCESSING	请求超时，请重试。	网关超时。	提示用户。
API_TIMEOUT	PROCESSING	请求超时，请重试。	接口响应超时。	提示用户。
API_GATEWAY_ERROR	FAIL	系统繁忙，请稍后重试或联系商户。	网关异常。	提示用户，让用户自行处理表单错误。
API_SYSTEM_ERROR	FAIL	系统繁忙，请稍后重试或联系商户。	接口调用报错。	提示用户，让用户自行处理表单错误。
VALIDATION_FAILED	FAIL	表单校验失败	表单校验失败。	提示用户，让用户自行处理表单错误。
INQUIRY_RESULT_TIMEOUT	PROCESSING	请求超时，请重试。	绑卡结果查询超时。	提示用户。
MISSING_SUCCESS_REDIRECT_URL	FAIL	系统繁忙，请稍后重试或联系商户。	缺少重定向跳转链接。	提示用户，详细原因请咨询 Antom 技术支持。
MISSING_3D_REDIRECT_URL	FAIL	系统繁忙，请稍后重试或联系商户。	缺少 3D 跳转链接。	提示用户，详细原因请咨询 Antom 技术支持。
NOT_SUPPORT_SUBMIT	FAIL	系统繁忙，请稍后重试或联系商户。	不支持提交的 Element。	修改集成代码，请不要使用不可提交的 Element 进行提交。
INVALID_MODAL_URL	FAIL	系统繁忙，请稍后重试或联系商户。	异常的弹框链接。	提示用户，详细原因请咨询 Antom 技术支持。
INVALID_REDIRECT_URL	FAIL	系统繁忙，请稍后重试或联系商户。	异常的跳转链接。	查看配置的回跳的 url 是否合法。
DDC_UPLOAD_PARAM_ILLEGAL	FAIL	系统繁忙，请稍后重试或联系商户。	DDC 上传参数错误。	提示用户，详细原因请咨询 Antom 技术支持。
DDC_UPLOAD_DATA_FAILED	FAIL	系统繁忙，请稍后重试或联系商户。	DDC 渠道页面异常。	提示用户，详细原因请咨询 Antom 技术支持。
DDC_QUERY_ID_MISSING	FAIL	系统繁忙，请稍后重试或联系商户。	DDC 查询结果错误。	提示用户，详细原因请咨询 Antom 技术支持。
DDC_QUERY_INFO_MISSING	FAIL	系统繁忙，请稍后重试或联系商户。	DDC 查询结果错误。	提示用户，详细原因请咨询 Antom 技术支持。
DDC_QUERY_INFO_UUID_MISSING	FAIL	系统繁忙，请稍后重试或联系商户。	DDC 查询结果错误。	提示用户，详细原因请咨询 Antom 技术支持。
DDC_PARAMETERS_INVALID	FAIL	系统繁忙，请稍后重试或联系商户。	缺少 3DE 必要参数。	提示用户，详细原因请咨询 Antom 技术支持。
DDC_INQUIRY_3D_REDIRECT_URL_PARAMS_MISSING	FAIL	系统繁忙，请稍后重试或联系商户。	缺少 3DE 必要参数。	提示用户，详细原因请咨询 Antom 技术支持。
DDC_QUERY_PAYMENT_REDIRECT_URL_TIMEOUT	PROCESSING	请求超时，请重试。	查询回跳链接超时。	提示用户。
NOT_SUPPORT_ELEMENT	FAIL	系统繁忙，请稍后重试或联系商户。	创建了不支持的 elementType。	修改集成代码，不要使用不支持的 Element 进行创建。
SESSION_DATA_INVALID	FAIL	系统繁忙，请稍后重试或联系商户。	传递了无效的 sessionData。	排查集成代码是否传递的 sessionData 是否正确
ELEMENT_INIT_FAILED	FAIL	系统繁忙，请稍后重试或联系商户。	初始化 Element 失败。	提示用户，详细原因请咨询 Antom 技术支持。
GENERATE_ELEMENT_KEY_FAILED	FAIL	系统繁忙，请稍后重试或联系商户。	Element 唯一 key 生成失败。	提示用户，详细原因请咨询 Antom 技术支持。
CANNOT_CREATE_SAME_ELEMENT_TWICE	FAIL	系统繁忙，请稍后重试或联系商户。	同时创建同一个 Element 多次。	修改集成代码，不要同时创建两次相同的 Element。
MOUNT_TIMEOUT	FAIL	系统繁忙，请稍后重试或联系商户。	挂载 Element 超时。	提示用户，详细原因请咨询 Antom 技术支持。
MOUNT_MISSING_CONTAINER	FAIL	系统繁忙，请稍后重试或联系商户。	挂载未传入 container 元素。	修改集成代码，传递正确的 container 元素
MOUNT_IFRAME_LOAD_ERROR	FAIL	系统繁忙，请稍后重试或联系商户。	iframe 加载失败。	提示用户，详细原因请咨询 Antom 技术支持。
MOUNT_NOT_SUPPORT	FAIL	系统繁忙，请稍后重试或联系商户。	当前状态不支持挂载，建议别销毁后，或者多次挂载。	修改集成代码，不要销毁 Element 后，再次挂载 Element。
MOUNT_INITIAL_FAILED	FAIL	系统繁忙，请稍后重试或联系商户。	挂载初始化失败。	提示用户，详细原因请咨询 Antom 技术支持。
MISSING_PAYMENT_METHOD	FAIL	系统繁忙，请稍后重试或联系商户。	未下发渲染模板。	提示用户，详细原因请咨询 Antom 技术支持。
USER_CLOSE_VAULTING	PROCESSING	无提示。	用户关闭绑卡半浮层。	商户无需进一步操作。