confirmPayment()

2026-07-10 18:40

confirmPayment()

方法用于 Payment Element 的已存卡支付，直接进入支付确认流程。

注意：

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

方法签名

Java

Kotlin

参数

参数	类型	是否必需	描述
activity	Activity	是	当前 Activity 上下文。
sessionData	String	是	支付会话数据。将从 createPaymentSession（单笔支付）接口响应中获取的完整 paymentSessionData 传入此参数。

返回值

此方法无返回值。

错误码

结果码（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	用户余额不足。请充值或选择其它支付方式。	由于对应支付方式的用户余额不足，支付无法完成。	建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
ORDER_NOT_EXIST	FAIL	系统异常。请检查付款情况并联系商户	订单不存在。	请联系 Antom 技术支持获取详细原因。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
PROCESS_FAIL	FAIL	未知异常。请检查付款情况并联系商户	发生了常见的业务失败。	请联系 Antom 技术支持获取详细原因。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
ORDER_IS_CANCELLED	FAIL	系统异常。请检查付款情况并联系商户	订单已撤销。	订单已取消，如需再次支付，请使用新的 paymentRequestId 重新发起支付。
RISK_REJECT	FAIL	风控拒绝。建议换卡重试或联系发卡行。	由于风险控制，交易无法进一步处理。如果用户已为交易付款，交易将被退款。	弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
ORDER_IS_CLOSED	FAIL	系统异常。请检查付款情况并联系商户	您发起的请求具有与已关闭交易相同的 paymentRequestId。	订单已超时关单，使用新的 paymentRequestId 重新发起支付。
ACCESS_DENIED	FAIL	未知异常。请检查付款情况并联系商户	访问被拒绝。	请联系 Antom 技术支持获取详细原因。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
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 时，您可从响应中读取 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 技术支持获取详细原因。
SYSTEM_ERROR	FAIL	系统异常。请检查付款情况并联系商户	发生系统错误。	请联系 Antom 技术支持获取详细原因。建议弹窗提示买家。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。
USER_AMOUNT_EXCEED_LIMIT	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	N/A	要素信息错误。	Antom 已为您提示买家，您无需进行操作。可以在会话有效期内使用原有的 paymentSessionData 重新调用 confirmPayment() 。