confirmPayment()

2026-07-10 18:40

confirmPayment()

方法用于 Payment Element 确认支付（无 UI 支付场景）。适用于已存卡支付等不需要展示 UI 的场景。

注意：此方法与

createComponent()

互斥。

声明

Objective-C

Swift

参数

参数	类型	是否必需	描述
sessionData	String	是	支付会话数据。将从 createPaymentSession（单笔支付）接口响应中获取的完整 paymentSessionData 传入此参数。
completion	(AMSStatusResult) -> Void	否	支付确认完成的回调。

返回值

此方法无返回值。

错误码

结果码（code）	状态（status）	建议给买家的提示（message）	描述	操作建议

	状态（status）	建议给买家的提示（message）	描述	操作建议
UNKNOWN_EXCEPTION	PROCESSING	未知异常。请检查付款情况并联系商户。	由于未知原因，方法调用失败。	详细原因请咨询 Antom 技术支持。建议商户尝试从服务端轮询支付结果。若未查到支付结果，可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
INQUIRY_PAYMENT_SESSION_FAILED	FAIL	您的支付会话已过期。请刷新页面并重试。	支付会话过期。	订单已超时关单，使用新的 paymentRequestId 重新发起支付。
PARAM_INVALID	N/A	请求异常，交易无法发起。	SDK 入参异常。	集成代码异常，请自行排查。有问题联系 Antom 技术支持。
UI_STATE_ERROR	N/A	请求异常，交易无法发起。	创建 SDK 实例或调用 confirmPayment() 的时机异常。	集成代码异常，请自行排查。有问题联系 Antom 技术支持。
INITIALIZE_WEB_TIMEOUT	N/A	请求异常，交易无法发起。	收银台静态资源加载超时。	用户网络异常或 Antom 服务异常，建议重试 confirmPayment() 。
USER_BALANCE_NOT_ENOUGH	FAIL	用户余额不足。请充值或选择其它支付方式。	由于对应支付方式的用户余额不足，支付无法完成。	弹窗提示用户
ORDER_NOT_EXIST	FAIL	订单状态异常。请检查付款情况并联系商户。	订单不存在。	详细原因请咨询 Antom 技术支持。
PROCESS_FAIL	FAIL	系统异常。请检查付款情况并联系商户	发生了常见的业务失败。	详细原因请咨询 Antom 技术支持。
ORDER_IS_CANCELLED	FAIL	订单状态异常。请检查付款情况并联系商户。	订单已撤销。	商户主动撤销订单，请自行排查。
RISK_REJECT	FAIL	风控拒绝。建议换卡重试或联系发卡行。	由于风险控制，交易无法进一步处理。如果用户已为交易付款，交易将被退款。	弹窗提示用户
ORDER_IS_CLOSED	FAIL	订单状态异常。请检查付款情况并联系商户。	您发起的请求具有与已关闭交易相同的 paymentRequestId。	订单已超时关单，使用新的 paymentRequestId 重新发起支付。
ACCESS_DENIED	FAIL	系统异常。请检查付款情况并联系商户	访问被拒绝。	详细原因请咨询 Antom 技术支持。
CARD_EXPIRED	FAIL	卡片已过期，请核对过期日期或使用其他卡片。	用于交易的银行卡已过期。	Antom 已为您提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
INVALID_EXPIRY_DATE_FORMAT	FAIL	卡片过期时间不正确，请核对过期日期或使用其他卡片。	expiryYear 或 expiryMonth 的格式不正确。	Antom 已为您提示买家，您无需进行操作。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
INVALID_EXPIRATION_DATE	FAIL	卡片过期时间不正确，请核对过期日期或使用其他卡片。	paymentMethod.paymentMethodMetaData.expiryYear 或 paymentMethod.paymentMethodMetaData.expiryDate 的值无效。	Antom 已为您提示买家，您无需进行操作。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
INVALID_CVV	FAIL	卡片CVV不正确，请核对CVV或使用其他卡片。	用于交易的银行卡 CVV 无效。	Antom 已为您提示买家，您无需进行操作。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
INVALID_CARD_NUMBER	FAIL	卡号不正确。建议换卡重试或联系发卡行。	用于交易的银行卡号无效。	Antom 已为您提示买家，您无需进行操作。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
SELECTED_CARD_BRAND_NOT_AVAILABLE	FAIL	卡品牌不支持。建议换卡重试或联系发卡行。	商户指定用于交易的银行卡卡品牌不被支持。	您指定的银行卡品牌不支持，请自行排查。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
CARD_NOT_SUPPORTED	FAIL	卡片不支持。建议换卡重试或联系发卡行。	用于交易的银行卡不被支持。	Antom 已为您提示买家，您无需进行操作。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
CARD_BIN_QUERY_ERROR	FAIL	卡号不正确。建议换卡重试或联系发卡行。	用于交易的银行卡号无效。	Antom 已为您提示买家，您无需进行操作。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
PAYMENT_IN_PROCESS	PROCESSING PENDING	支付正在处理中，请等待支付完成。	支付正在处理中。	PROCESSING 代表 SDK 轮询后未查询到支付结果，建议从服务端轮询支付结果。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。您可从响应中读取 userCanceled3D 字段判断买家是否主动关闭 3D 弹窗： true ：表示买家主动中止 3D 过程。 false : 表示非买家主动中止 3D 过程。
CURRENCY_NOT_SUPPORT	FAIL	商户不支持该币种，交易无法发起。	币种不受支持。	请联系 Antom 技术支持获取详细原因。可以在支付会话的有效期内使用原paymentSessionData重新发起 confirmPayment
INVALID_CARD	FAIL	卡号无效，请核对卡片详细信息或使用其他卡片。	银行卡无效。可能是银行卡号无法识别，银行卡没有对应的发卡行，或者卡号格式错误。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
ISSUER_REJECTS_TRANSACTION	FAIL	发卡行拒绝交易，建议换卡重试或联系发卡行。	发卡行拒绝了交易。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
INVALID_MERCHANT_STATUS	FAIL	商户状态异常，交易无法发起。	由于存在限制，商户状态异常。	详细原因请咨询 Antom 技术支持。
KEY_NOT_FOUND	FAIL	系统异常。请检查付款情况并联系商户	找不到 Antom 或商户的私钥或公钥。	详细原因请咨询 Antom 技术支持。
MERCHANT_KYB_NOT_QUALIFIED	FAIL	商户状态异常，交易无法发起。	由于商户的 KYB 状态，支付失败。商户要么未完成 KYB，要么 KYB 状态不适用于此交易。	详细原因请咨询 Antom 技术支持。
NO_PAY_OPTIONS	FAIL	商户不支持该币种，交易无法发起。	没有可用的支付选项。	详细原因请咨询 Antom 技术支持。
PARAM_ILLEGAL	FAIL	系统异常。请检查付款情况并联系商户	缺少必需的参数，或者存在非法参数。例如，非数字输入、无效的日期，或者参数的长度和类型错误。	详细原因请咨询 Antom 技术支持。
PAYMENT_AMOUNT_EXCEED_LIMIT	FAIL	商户支付金额超过限额，交易无法发起。	支付金额超过了合同或支付方式允许的最大金额。	检查支付金额是否超过限制，或使用较低金额重试支付。使用新的 paymentRequestId 更换金额后重新发起支付。
PAYMENT_COUNT_EXCEED_LIMIT	FAIL	商户支付次数超过限制使用次数，交易无法发起。	支付次数超过了支付方式规定的限制。	详细原因请咨询 Antom 技术支持。
PAYMENT_NOT_QUALIFIED	FAIL	商户状态异常，交易无法发起。	商户不具备支付资格，可能是因为未注册、未签订自动扣款协议或被禁止支付。	详细原因请咨询 Antom 技术支持。
SUSPECTED_CARD	FAIL	风控拒绝。建议换卡重试或联系发卡行。	银行卡涉嫌欺诈。例如，银行卡可能被盗或受限。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
SYSTEM_ERROR	FAIL	系统异常。请检查付款情况并联系商户	发生系统错误。	请联系 Antom 技术支持获取详细原因。建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
USER_AMOUNT_EXCEED_LIMIT	FAIL	金额超限。使用小于或等于账户可用余额的金额重新发起支付。	支付金额超过了用户的支付限额。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
USER_BALANCE_NOT_ENOUGH	FAIL	用户余额不足。请充值或选择其它支付方式。	由于对应支付方式的用户余额不足，支付无法完成。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
USER_KYC_NOT_QUALIFIED	FAIL	用户状态异常。建议换卡重试或联系发卡行。	由于用户的 KYC 状态，支付失败。用户要么未完成 KYC，要么 KYC 状态不满足此交易要求（例如，支付金额或产品信息的限制）。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
USER_PAYMENT_VERIFICATION_FAILED	FAIL	用户状态异常。建议换卡重试或联系发卡行。	用户在支付方式端被限制支付。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
USER_STATUS_ABNORMAL	FAIL	用户状态异常。建议换卡重试或联系发卡行。	用户在支付方式端的状态异常。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
DO_NOT_HONOR	FAIL	支付被发卡行拒绝。建议换卡重试或联系发卡行。	支付被发卡行拒绝。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
SUBMIT_PAYMENT_TIMEOUT	PROCESSING	请求异常，交易无法发起。	提交支付时网络异常。	买家网络异常或 Antom 服务异常，尝试从服务端轮询支付结果。若未查到支付结果，可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
PAYMENT_RESULT_TIMEOUT	PROCESSING	请求异常，交易无法发起。	获取支付结果时网络异常。	尝试从服务端轮询支付结果。若未查到支付结果，可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
FORM_INVALID	FAIL	无。	要素信息填写错误。	Antom 已为您提示买家，您无需进行操作。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。