inquiryPayment

2026-09-10 14:24

POST /v1/payments/inquiryPayment

使用此接口查询先前提交的支付请求的交易状态和其他信息。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：

注意：将每个参数（除数组外）的数据类型设置为字符串，即参数的值必须使用英文双引号（" "）包裹起来。例如：
如果参数的数据类型为整数属性，且其值为 20，设置为 "20"。
如果参数的数据类型为布尔属性，且其值为 true，设置为 "true"。

入参

paymentRequestId String

商户为识别支付请求而分配的专属 ID。paymentRequestId 和 paymentId 不能都为null。如果两者都指定，paymentId 优先。

更多信息：

最大长度：64 字符

paymentId String

Antom 为识别支付而分配的支付 ID。paymentRequestId 和 paymentId 不能都为null。paymentId 与 paymentRequestId 之间存在一一对应的关系。如果同时指定了两者，paymentId 优先。

更多信息：

最大长度：64 字符

merchantAccountId String

用于识别商户账户的商户 ID。

注意：当您在多个地点使用同一个客户端 ID 时，请指定此参数。

更多信息：

最大长度：32 字符

出参

result Result REQUIRED

请求调用结果的信息。

注意：此字段不表示支付结果。此字段仅表示查询支付接口是否调用成功。

Show child parameters

paymentStatus String

表明支付结果。有效值为：

SUCCESS：支付成功。
FAIL：支付失败。
PROCESSING：支付处理中。
CANCELLED：支付已取消。
PENDING：支付完成，等待最终支付结果。

注意：
此参数在接口调用成功（result.resultStatus 的值为S）时返回。
收到返回后的后续操作指引详见更多信息中的 paymentStatus 后续操作。

paymentResultCode String

不同支付状态的结果代码。可能的支付结果代码列在此页面的 支付结果代码表 中。

注意：此字段在接口调用成功（result.resultStatus 的值为S）时返回。

更多信息：

最大长度：64 字符

paymentResultMessage String

解释支付结果代码的返回消息。

注意：此字段在接口调用成功（result.resultStatus 的值为S）时返回。

更多信息：

最大长度：256 字符

paymentRequestId String

商户为识别支付请求而分配的专属 ID。

注意：此字段在接口调用成功（result.resultStatus 的值为S）时返回。

更多信息：

最大长度：64 字符

paymentId String

Antom 为识别支付而分配的支付 ID。

注意：此字段在接口调用成功（result.resultStatus 的值为S）时返回。

更多信息：

最大长度：64 字符

paymentAmount Amount

商家在订单币种中请求接收的支付金额。

Show child parameters

paymentCreateTime Datetime

支付创建的日期和时间。

注意：此字段在接口调用成功（result.resultStatus 的值为S）时返回。

更多信息：

值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

paymentTime Datetime

支付成功达到最终状态的日期和时间。

注意：此字段仅在支付达到最终成功状态（paymentStatus的值为SUCCESS）时返回。

更多信息：

值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

pspCustomerInfo PspCustomerInfo

电子钱包的客户信息。

注意：当电子钱包能够提供相关信息时，此字段会被返回。

Show child parameters

redirectActionForm RedirectActionForm

关于跳转操作的信息。

注意：当 paymentResultCode 的值为PAYMENT_IN_PROCESS时，此字段会被返回。

Show child parameters

acquirerReferenceNo String

非 Antom 收单机构为交易分配的交易 ID。

更多信息：

最大长度：64 字符

transactions Array<Transaction>

交易明细列表。

注意：当交易存在退款或请款时，此参数会被返回。

Show child parameters

customsDeclarationAmount Amount

用于海关报关的总金额。

注意：此字段仅在支付成功且钱包为 Alipay 时返回。

Show child parameters

grossSettlementAmount Amount

此字段的值等于交易金额乘以 settlementQuote 的值。

注意：当汇率在交易时被锁定时返回此参数。

Show child parameters

settlementQuote Quote

结算币种与交易币种之间的汇率。

注意：当 grossSettlementAmount 返回时，此字段会返回。

Show child parameters

paymentResultInfo PaymentResultInfo

支付结果信息。

注意：当 pay（单笔支付）接口中 paymentMethodType 的值为CARD, GRABPAY_MY, 或 GRABPAY_SG，且 paymentStatus 的值为 SUCCESS或FAIL 时返回此参数。

请选择场景

Card

cardNo String

部分显示的卡号，仅显示卡号的一部分，可用于向用户展示。

注意：当在 pay（单笔支付）接口中的 paymentMethodType 值为CARD，且商户没有 PCI 合规时，此参数返回。

更多信息：

最大长度：32 字符

cardBrand String

银行卡的品牌，可用于向用户展示。

注意：当在 pay（单笔支付）接口中的 paymentMethodType 值为CARD时，此参数会被返回。

更多信息：

最大长度：256 字符

cardToken String

银行卡的令牌。此参数的值在后续支付中由参数 paymentMethodId 用于 pay（单笔支付）接口中。

注意：当 paymentMethodType 在 pay（单笔支付）接口中的值为CARD并且商户没有 PCI 合规时，此参数会被返回。

更多信息：

最大长度：128 字符

issuingCountry String

银行卡的发行国家。此参数的值遵循 ISO 3166 国家代码标准的二位字母国家代码。

注意：当在 pay（单笔支付）接口中的 paymentMethodType 值为CARD时，此参数会被返回。

更多信息：

最大长度：2 字符

funding String

银行卡的资金类型。有效值包括：

CREDIT: 表示信用卡。
DEBIT: 表示借记卡。
PREPAID: 表示预付卡。
CHARGE: 表示充值卡。
DEFERRED_DEBIT: 表示延期借记卡。

注意：当在 pay（单笔支付）接口或 createPaymentSession（单笔支付）接口中的 paymentMethodType 值为 CARD 时，返回此参数。

更多信息：

最大长度：32 字符

paymentMethodRegion String

代表支付方式所属国家或地区的地区代码。此参数的值为二位字母的 ISO 国家代码或 GLOBAL。

注意：当在 pay（单笔支付）接口中的 paymentMethodType 值为 CARD时，返回此参数。

更多信息：

最大长度：6 字符

threeDSResult ThreeDSResult

3D Secure 验证的结果。

注意：当在 pay（单笔支付）接口中的 paymentMethodType 值为 CARD，且银行卡验证类型为 3D Secure 时，返回此参数。

Show child parameters

avsResultRaw String

原始的地址验证服务（AVS）结果。请参考 AVS 结果代码来查看有效值。

注意：当发卡行将此信息传递给 Antom 时，此参数会被返回。

更多信息：

最大长度：128 字符

cvvResultRaw String

原始的卡验证值 (CVV)，卡安全码 (CSC)，或卡验证码 (CVC)结果。请参考 CVV结果代码来查看有效值。

注意：当发卡行将此信息传递给 Antom 时，此参数会被返回。

更多信息：

最大长度：128 字符

networkTransactionId String

银行卡组织为识别交易而分配的专属 ID。该参数的值会在后续支付中用于 pay（单笔支付）接口请求中的同一参数。

注意：当 pay（单笔支付）接口中的 paymentMethodType 值为 CARD，且 3D Secure 或非 3D Secure 认证成功时，此参数会被返回。

更多信息：

最大长度：128 字符

cardCategory String

支付卡类别。有效值为：

CONSUMER：个人卡
COMMERCIAL：商务卡

当以下所有条件满足时，此参数将返回：

参数 paymentMethodType 的值为 CARD。
参数 cardNo 的值有效。
在 Antom 的卡库中可以获取到相关信息。

更多信息：

最大长度：32 字符

creditPayPlan creditPayPlan

分期付款的分期计划信息。

注意：当用户成功用卡进行分期付款时，返回此参数。

Show child parameters

cardholderName String

持卡人姓名。

注意：针对指定地区的特定商户，当在 pay（单笔支付）接口中的 paymentMethodType 值为 CARD 时，返回此参数。

更多信息：

最大长度：64 字符

cardBin String

银行卡号码的前六位数字，用于识别银行卡的发行银行和卡片类型。

注意：针对指定地区的特定商户，当在 pay（单笔支付）接口中的 paymentMethodType 值为 CARD 时，返回此参数。

更多信息：

最大长度：8 字符

lastFour String

银行卡卡号后 4 位。

注意：针对指定地区的特定商户，当在 pay（单笔支付）接口中的 paymentMethodType 值为 CARD 时，返回此参数。

更多信息：

最大长度：4 字符

expiryMonth String

银行卡的过期月份。传入表示月份的两位数字。例如，如果过期月份是二月，此参数的值为 02。

注意：当 pay（单笔支付）接口中 paymentMethodType 的值为 CARD 时，返回此参数。

更多信息：

最大长度：2 字符

expiryYear String

银行卡的到期年份。输入年份的最后两位数字。例如，如果到期年份是 2025，此参数的值为 25。

注意：当 pay（单笔支付）接口中 paymentMethodType 的值为 CARD 时，返回此参数。

更多信息：

最大长度：2 字符

refusalCodeRaw String

发卡行拒绝交易的响应代码。有效值请参阅 ISO codes。

当满足以下条件时返回此参数：
交易失败。
参数 paymentMethodType 的值为 CARD。
发卡行有返回此数据。

更多信息：

最大长度：16 字符

refusalReasonRaw String

拒绝交易响应代码的错误信息。

当满足以下条件时返回此参数：
交易失败。
参数 paymentMethodType 的值为 CARD。
发卡行有返回此数据。

更多信息：

最大长度：256 字符

merchantAdviceCode String

商户建议码（MAC）包含万事达卡交易详情及拒付原因说明。如遇支付失败，此代码会提示是否允许以及何时可发起重试。有效值请参阅 Merchant Advice Code。

注意：当参数 paymentMethodType 的值为 CARD 且发卡行有返回此数据时，此字段返回。

更多信息：

最大长度：128 字符

credentialTypeUsed String

表示交易使用的是主账号（PAN）还是卡组令牌。有效值为：

PAN：表示交易使用了 PAN。
NETWORK_TOKEN：表示交易使用了商户侧的卡组令牌或 Antom 侧的卡组令牌。

更多信息：

最大长度：8 字符

exemptionRequested String

对于授权交易，Antom 申请豁免所使用的豁免类别。有效值为：

lowValue：满足特定的累计金额和交易次数标准，30 欧元以下的小额交易或可豁免强客户认证要求。
transactionRiskAnalysis：根据支付服务提供商的风险评估，若交易被认定为欺诈风险较低，则可能豁免强客户认证要求。

更多信息：

最大长度：64 字符

issuerName String

发卡行。

当 paymentMethodType 的值为 CARD 时，系统会返回此参数。

更多信息：

最大长度：256 字符

authorizationCode String

支付方式授权成功后返回的授权码。

注意：当支付方法在支付过程中返回授权码时，返回该参数。

incrementalAuthorizationAvailable Boolean

表示本次预授权是否支持增量授权。有效值为：

true：表示本次预授权支持增量授权。
false：表示本次预授权不支持增量授权。

注意：当 result.resultStatus 的值为 S 时返回此参数。

extendedAuthorizationAvailable Boolean

表示本次预授权是否支持延长授权。有效值为：

true：表示本次预授权支持延长授权。
false：表示本次预授权不支持延长授权。

注意：当 result.resultStatus 的值为 S 时返回此参数。

refundOnAuthorizationAvailable Boolean

表示预授权成功后是否支持通过 paymentId 发起退款。有效值为：

true：表示支持后续退款通过 paymentId 进行。
false：表示不支持后续退款通过 paymentId 进行，需要指定 captureId。

注意：当 result.resultStatus 的值为 S 时返回此参数。

Wallet

funding String

支付方式的支付类型。

当 paymentMethodType 的值为GRABPAY_MY或GRABPAY_SG时返回此参数。有效值包括：
WALLETS: 表示使用钱包余额的普通钱包支付。
BNPL_POSTPAID: 表示先买后付，用户支付全额。
BNPL_INSTALLMENT: 表示先买后付，用户分期付款。

更多信息：

最大长度：20 字符

creditPayPlan CreditPayPlan

分期付款的分期计划信息。

注意：当 paymentResultInfo.funding 的值为 BNPL_INSTALLMENT时，返回此参数。

Show child parameters

authExpirytime Datetime

预授权过期时间。

注意：
当 pay（单笔支付）接口中 paymentMethodType 的值为 CARD 时，此参数会被返回。
当 result.resultStatus 的值为 S 时返回此参数。
请款必须在该时间之前发起，超时授权自动失效。
本参数在首笔预授权返回后即锁定，后续通过 updateAmount 接口调额不会重置或延长该时间。

更多信息：

值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

promotionResult Array <PromotionResult>

优惠方案结果。

注意：当买家在下单时使用了优惠方案活动时，会返回此参数。

Show child parameters

reversalType string

交易逆转类型。有效值为：

PAYMENT_REVERSAL: 表示 Antom 未及时收到支付成功通知导致交易超时关闭，触发退款但支付方式不支持或退款操作失败。

注意：当发生交易逆转时，会返回此参数。

paymentMethodType String

支付方式选项中包含的支付方式类型。参见支付方式以查看有效值。

注意：当选用 Antom Checkout Page 集成时，返回此字段。

更多信息：

最大长度：64 字符

API Explorer

请求

URL

Method

POST

请求体

响应

Case

Payment successful

响应体

结果码

结果码	值	结果码信息	行动建议
USER_NOT_SUBMITTED	F	用户超时未提交支付。当使用中间页/SDK 集成时，用户拉起支付要素填写页面后，未点提交会触发超时。	重新发起支付。
USER_AUTHENTICATION_NOT_FINISHED	F	用户超时未完成核身。当用户支付时，拉起 3D 安全页面后未完成核身时返回此错误码。	重新发起支付。
PICKUP_CARD	F	发卡行要求商户扣留支付卡。此类情况通常出现在疑似伪卡或盗刷场景中。	请立即联系发卡行，或使用其他卡完成支付。
DOMESTIC_DEBIT_TRANSACTION_NOT_ALLOWED	F	不允许国内借记卡交易（仅限区域使用）	请立即联系发卡行，或使用其他卡完成支付。
BLOCKED_BY_CARDHOLDER	F	该卡被用户锁定。	请立即联系发卡行，或使用其他卡完成支付。
RESTRICTED_CARD	F	发卡行限制了该卡的使用范围。	请立即联系发卡行，或使用其他卡完成支付。
CARD_EXPIRED	F	银行卡过期。	检查 paymentMethod.paymentMethodMetaData.expiryYear 或 paymentMethod.paymentMethodMetaData.expiryMonth 的值是否正确：如果不正确，请输入正确的值。如果正确，请联系 Antom 技术支持以获取详细原因。
ACCOUNT_CLOSED	F	账户已关闭。请核实账户号码的准确性，同一银行卡号或令牌请勿再次处理。	请立即联系发卡行，或使用其他卡完成支付。
INVALID_CVV	F	CVV 代码无效。	提示用户检查输入的 CVV 是否正确。
INSTALLMENT_NOT_SUPPORTED	F	该卡或商户不支持分期。	该卡不支持分期，请换卡支付。
PAYMENT_METHOD_SYSTEM_ERROR	F	支付方式系统错误。	发卡行系统错误，请联系发卡行。
INVALID_INSTALLMENT_PLAN	F	分期付款次数或间隔不正确。	请修改分期数后重试。
SUCCESS	S	成功	接口调用成功。通过 paymentStatus 获取订单状态。
ACCESS_DENIED	F	访问被拒绝。	详细原因请咨询 Antom 技术支持。
INVALID_API	F	调用的接口无效或未激活。	请联系 Antom 技术支持解决此问题。
KEY_NOT_FOUND	F	找不到 Antom 或商户的私钥或公钥。	检查私钥或公钥是否存在。如果不存在，请在 Antom 开发者中心上传私钥。
NO_INTERFACE_DEF	F	接口未定义。	检查链接是否正确。请参考接口文档中的端点。
ORDER_NOT_EXIST	F	订单不存在。	检查 paymentId 是否正确。如果正确，请联系 Antom 技术支持了解具体原因。
PARAM_ILLEGAL	F	缺少必需的参数，或者存在非法参数。例如，非数字输入、无效的日期，或者参数的长度和类型错误。	检查并验证当前接口所需的请求字段（包括头部字段和正文字段）是否正确传递并有效。
PAYMENT_IN_PROCESS	U	支付正在处理中。	对于单笔支付，您发起的请求具有与已存在交易相同的 paymentRequestId，这可能是已完成或正在进行的交易。检查响应中是否返回了 redirectActionForm.redirectUrl。如果返回了，将用户重定向到 redirectUrl 指定的地址以完成支付。如果没有返回，支付可能已经完成。详情请参阅结果处理逻辑。对于令牌支付，支付正在处理中。等待异步通知或调用 inquiryPayment 接口来查询最终的支付状态。
PROCESS_FAIL	F	发生了常见的业务失败。	建议您联系 Antom 技术支持以排查问题。
SYSTEM_ERROR	F	发生系统错误。	获取 Antom 技术支持前请勿重试。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	请求流量超过限制。	再次调用接口来解决问题。如果问题未解决，请联系 Antom 技术支持。
UNKNOWN_EXCEPTION	U	由于未知原因，接口调用失败。	再次调用接口来解决问题。如果问题未解决，请联系 Antom 技术支持。
INVALID_CPF	F	提供的 CPF 号码无效。	请确认您的身份信息并重试。
REFERRAL_ISSUER	F	交易被发卡行拒绝。	持卡人应联系发卡行以确认原因，并在解决问题后重试。
TRANSACTION_NOT_PERMITTED	F	发卡行拒绝了该卡/账户的交易。	持卡人可选择其他支付方式或联系发卡行寻求帮助。
INVALID_PIN	F	提供的 PIN 码不正确或不符合要求。	请确保持卡人输入正确的 PIN 码，并检查其长度和格式是否符合要求。
LIFECYCLE	F	由于无效的卡片数据，交易被拒绝。	请确保持卡人输入正确的卡片信息，并检查其长度和格式是否符合要求。
LAW_VIOLATION	F	发卡行拒绝了该交易。	持卡人应联系发卡行以确认原因，并在解决问题后重试。
PIN_REQUIRED	F	处理交易必须提供 PIN 码，但持卡人未提供。	请使用有效的 PIN 码重试。
LOST_CARD	F	挂失卡（欺诈账户）。	持卡人应联系发卡行以确认原因。
STOLEN_CARD	F	被盗卡（欺诈账户）。	持卡人应联系发卡行以确认原因。
SECURITY_REJECT	F	由于发卡行检测到安全问题，交易被拒绝。	核对信息：确保所有卡片信息（包括 CVV/CVC 和账单地址）输入正确；联系发卡行：向发卡行咨询更多信息或寻求帮助；使用其他支付方式：如需立即支付，可尝试其他卡片或支付方式。
BLOCKED_FIRST_USED	F	卡片可能因以下原因被临时冻结：未激活首次使用，或受特殊条件限制（例如新卡未激活）。	请持卡人激活新卡，或联系发卡行确认临时冻结状态及适用条件。
CANNOT_VERIFY_PIN	F	无法验证 PIN 码。	可尝试以非 PIN 交易方式完成交易。
SURCHARGE_NOT_ALLOWED	F	该卡不支持附加费。	持卡人应联系发卡行以确认原因。
EXCEEDS_PREAUTHORIZED_AMOUNT_LIMIT	F	交易金额超出预授权限额。	请持卡人降低交易金额至限额内，或联系发卡行申请提高预授权限额。
STOP_RECURRING_PAYMENT	F	持卡人已取消复购。	持卡人应联系发卡行以确认原因，并在解决问题后重试。
POLICY	F	政策限制。	持卡人应联系发卡行以确认原因。
INVALID_TRANSACTION	F	无效交易。	请勿重试，并联系 Antom 技术支持获取详情。
RE_ENTER_TRANSACTION	F	交易暂时无法处理。	持卡人应联系发卡行以确认原因，并在解决问题后重试。
TRANSACTION_NOT_ALLOWED_AT_TERMINAL	F	终端不允许该交易。	持卡人应联系发卡行以确认原因，并在解决问题后重试。
INVALID_MCC	F	无效的 MCC（商户类别代码）。	请勿重试，并联系 Antom 技术支持获取详情。
NO_SELECTED_ACCOUNT	F	持卡人选择了不存在的指定账户。	可尝试使用正确的账户类型重试。
INVALID_ISSUER	F	无法联系持卡人的发卡行进行交易授权。	请勿重试，并联系发卡行确认卡片状态。

支付结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	成功	支付成功，无需进一步操作。
ACCESS_DENIED	F	访问被拒绝。	详细原因请咨询 Antom 技术支持。
CURRENCY_NOT_SUPPORT	F	币种不受支持。	详细原因请咨询 Antom 技术支持。
FRAUD_REJECT	F	由于风险控制，交易无法进一步处理。如果用户已为交易付款，交易将被退款。	当满足以下条件之一时，请联系 Antom 技术支持：您想要提出申诉。用户在两周内未收到退款。
INVALID_API	F	调用的接口无效或未激活。	请联系 Antom 技术支持解决此问题。
INVALID_CARD	F	银行卡无效。可能是银行卡号无法识别，银行卡没有对应的发卡行，或者卡号格式错误。	使用新卡发起支付，或联系发卡行。
INVALID_EXPIRY_DATE_FORMAT	F	expiryYear 或 expiryMonth 的格式不正确。	检查传递的参数 expiryYear 和 expiryMonth 的格式。
ISSUER_REJECTS_TRANSACTION	F	发卡行拒绝了交易。	使用新卡发起支付，或联系发卡行。
INVALID_ACCESS_TOKEN	F	访问令牌已过期、被撤销或不存在。	检查 accessToken 是否过期、被撤销或不存在。重新签署合同并重新发起授权签名流程。
INVALID_MERCHANT_STATUS	F	由于存在限制，商户状态异常。	详细原因请咨询 Antom 技术支持。
KEY_NOT_FOUND	F	找不到 Antom 或商户的私钥或公钥。	检查私钥或公钥是否存在。如果不存在，请在 Antom 开发者中心上传私钥。
MERCHANT_KYB_NOT_QUALIFIED	F	由于商户的 KYB 状态，支付失败。商户要么未完成 KYB，要么 KYB 状态不适用于此交易。	详细原因请咨询 Antom 技术支持。
NO_INTERFACE_DEF	F	接口未定义。	检查链接是否正确。请参考接口文档中的端点。
NO_PAY_OPTIONS	F	没有可用的支付选项。	请联系 Antom 技术支持以获取详细原因。
ORDER_IS_CLOSED	F	您发起的请求具有与已关闭交易相同的 paymentRequestId。	使用新的 paymentRequestId 重新发起支付。
PARAM_ILLEGAL	F	缺少必需的参数，或者存在非法参数。例如，非数字输入、无效的日期，或者参数的长度和类型错误。	检查并验证当前接口所需的请求字段（包括头部字段和正文字段）是否正确传递并有效。
PAYMENT_AMOUNT_EXCEED_LIMIT	F	支付金额超过了合同或支付方式允许的最大金额。	检查支付金额是否超过限制，或使用较低金额再试一次。请联系 Antom 技术支持了解具体限制。
PAYMENT_COUNT_EXCEED_LIMIT	F	支付次数超过了支付方式规定的限制。	请联系 Antom 技术支持了解具体限制。
PAYMENT_NOT_QUALIFIED	F	商户不具备支付资格，可能是因为未注册、未签订自动扣款协议或被禁止支付。	详细原因请咨询 Antom 技术支持。
PROCESS_FAIL	F	发生了常见的业务失败。	获取 Antom 技术支持前请勿重试。
RISK_REJECT	F	由于风险控制，交易无法进一步处理。如果用户已为交易付款，交易将被退款。	如果用户在两周内未收到退款，请联系 Antom 技术支持。
SUSPECTED_CARD	F	银行卡涉嫌欺诈。例如，银行卡可能被盗或受限。	使用新卡发起支付，或联系发卡行。
SUSPECTED_RISK	F	由于疑似安全问题，交易无法进一步处理。您可以等待一个工作日后重试交易。如果交易不安全且用户已付款，交易将被退款。	当满足以下条件之一时，请联系 Antom 技术支持：重试后交易无法进一步处理。用户在两周内未收到退款。
SYSTEM_ERROR	F	发生系统错误。	获取 Antom 技术支持前请勿重试。
USER_AMOUNT_EXCEED_LIMIT	F	支付金额超过了用户的支付限额。	使用不超过账户可用余额的金额创建新支付，或联系 Antom 技术支持。
USER_BALANCE_NOT_ENOUGH	F	由于对应支付方式的用户余额不足，支付无法完成。	请充值账户或选择其他支付方式。
USER_KYC_NOT_QUALIFIED	F	由于用户的 KYC 状态，支付失败。用户要么未完成 KYC，要么 KYC 状态不满足此交易要求（例如，支付金额或产品信息的限制）。	请先完成 KYC 验证。
USER_PAYMENT_VERIFICATION_FAILED	F	用户在支付方式端被限制支付。	请联系 Antom 技术支持了解具体原因。
USER_STATUS_ABNORMAL	F	用户在支付方式端的状态异常。	请联系 Antom 技术支持了解具体原因。
PAYMENT_IN_PROCESS	U	支付正在处理中。	对于单笔支付，您发起的请求中的 paymentRequestId 与已存在的交易（可能是成功或进行中的交易）相同。请检查响应中是否返回了 redirectActionForm.redirectUrl。如果返回了，将用户重定向到`redirectUrl`指定的地址以完成支付。如果没有返回，支付可能已经完成。详细结果处理逻辑请参阅相关说明。对于令牌支付，支付正在处理中。等待异步通知或调用 inquiryPayment 接口来查询最终的支付状态。
UNKNOWN_EXCEPTION	U	由于未知原因，接口调用失败。	对于单笔支付，使用新的 paymentRequestId 再次调用支付接口来解决此问题。如果问题未解决，请联系 Antom 技术支持。对于令牌支付，可以再次调用 pay（单笔支付）接口或调用 inquiryPayment 接口来查询最终支付状态。如果问题仍未解决，请联系 Antom 技术支持。
CARD_NOT_SUPPORTED	F	用于交易的银行卡不被支持。	请使用其他银行卡支付交易。
INVALID_EXPIRATION_DATE	F	paymentMethod.paymentMethodMetaData.expiryYear 或 paymentMethod.paymentMethodMetaData.expiryDate 的值无效。	检查 paymentMethod.paymentMethodMetaData.expiryYear 或 paymentMethod.paymentMethodMetaData.expiryDate 的值是否正确：如果不正确，请传入正确值。如果正确，请联系 Antom 技术支持获取详细原因。
INVALID_CARD_NUMBER	F	用于交易的银行卡号无效。	检查 pay（单笔支付）接口字段里的 paymentMethod.paymentMethodMetaData.cardNo 的值是否正确：如果值不正确，请传入正确值并重试。如果值正确，该卡不支持此交易，请使用其他卡进行支付。
DO_NOT_HONOR	F	支付被发卡行拒绝。	请尝试使用其他银行卡支付，或联系发卡行。

交易结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	成功	接口调用成功。从 refundStatus 获取退款状态。
ACCESS_DENIED	F	访问被拒绝。	详细原因请咨询 Antom 技术支持。
INVALID_API	F	调用的接口无效或未激活。	请联系 Antom 技术支持解决此问题。
CLIENT_INVALID	F	客户端 ID 无效。Antom 对客户端 ID 有限制。	检查客户端 ID 是否正确，或联系 Antom 技术支持获取详细原因。
KEY_NOT_FOUND	F	找不到 Antom 或商户的私钥或公钥。	检查私钥或公钥是否存在。如果不存在，请在 Antom 开发者中心上传私钥。
NO_INTERFACE_DEF	F	接口未定义。	检查链接是否正确。请参考接口文档中的端点。
ORDER_NOT_EXIST	F	订单不存在。	请在 15 秒后再次调用接口。如果尝试三次后仍没有返回结果，说明订单未创建成功。
PARAM_ILLEGAL	F	缺少必需的参数，或者存在非法参数。例如，非数字输入、无效的日期，或者参数的长度和类型错误。	检查并验证当前接口所需的请求字段（包括头部字段和正文字段）是否正确传递并有效。
PROCESS_FAIL	F	发生了常见的业务失败。	获取 Antom 技术支持前请勿重试。
SYSTEM_ERROR	F	发生系统错误。	获取 Antom 技术支持前请勿重试。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	请求流量超过限制。	再次调用接口来解决问题。如果问题未解决，请联系 Antom 技术支持。
UNKNOWN_EXCEPTION	U	由于未知原因，接口调用失败。	再次调用接口以解决问题。如果问题未解决，请联系 Antom 技术支持。
PAYMENT_IN_PROCESS	U	支付正在处理中。	对于单笔支付，您发起的请求中 paymentRequestId 与已存在的交易（可能是成功或进行中的交易）相同。请检查响应中是否返回了 redirectActionForm.redirectUrl。如果返回了，将用户重定向到 redirectUrl 指定的地址以完成支付。如果没有返回，支付可能已经完成。详情请参阅结果处理逻辑。对于令牌支付，支付正在处理中。等待异步通知或调用 inquiryPayment 接口来查询最终的支付状态。
AUTHENTICATION_REQUIRED	F	需要进行 3D Secure 验证。	重新初始化支付并重定向用户进行 3D Secure 验证。
PAYMENT_PROHIBITED	F	因商品在该国禁止销售，无法处理支付。	您不允许对这笔交易提出异议。
INVALID_AMOUNT	F	发卡行因各种原因拒绝交易，例如指定金额无效或超过最大金额限制。	请联络 Antom 技术支持获取详细原因。

result.resultStatus	信息	后续操作
`S`	inquiryPayment 接口调用成功。	从接口响应的 paymentStatus 字段获取支付结果。
`F`	inquiryPayment 接口调用失败。	您无法从接口响应中获取支付结果。
`U`	inquiryPayment 接口调用的状态未知。	使用相同的请求参数重试 inquiryPayment 接口。

paymentStatus	信息	后续操作
`SUCCESS`	支付或授权成功。	在常规支付模式下，可进行发货；在授权-请款支付模式下，可进行请款。
`FAIL`	支付或授权失败。	建议关闭当前订单或使用新的 paymentRequestId 重新发起支付。
`PROCESSING`	支付或授权处理中。	建议继续查询或在关单时间后再次查询确认最终状态。
`CANCELLED`	支付或授权已取消。	建议关闭当前订单或使用新的 paymentRequestId 重新发起支付。
`PENDING`	支付或授权完成，等待最终结果。	建议继续查询或等待 notifyPayment 接口的异步通知。

inquiryPayment

结构

入参

paymentRequestId String

paymentId String

merchantAccountId String

出参

result Result REQUIRED

paymentStatus String

paymentResultCode String

paymentResultMessage String

paymentRequestId String

paymentId String

paymentAmount Amount

paymentCreateTime Datetime

paymentTime Datetime

pspCustomerInfo PspCustomerInfo

redirectActionForm RedirectActionForm

acquirerReferenceNo String

transactions Array<Transaction>

customsDeclarationAmount Amount

grossSettlementAmount Amount

settlementQuote Quote

paymentResultInfo PaymentResultInfo

Card

cardNo String

cardBrand String

cardToken String

issuingCountry String

funding String

paymentMethodRegion String

threeDSResult ThreeDSResult

avsResultRaw String

cvvResultRaw String

networkTransactionId String

cardCategory String

creditPayPlan creditPayPlan

cardholderName String

cardBin String

lastFour String

expiryMonth String

expiryYear String

refusalCodeRaw String

refusalReasonRaw String

merchantAdviceCode String

credentialTypeUsed String

exemptionRequested String

issuerName String

authorizationCode String

incrementalAuthorizationAvailable Boolean

extendedAuthorizationAvailable Boolean

refundOnAuthorizationAvailable Boolean

Wallet

funding String

creditPayPlan CreditPayPlan

authExpirytime Datetime

promotionResult Array <PromotionResult>

reversalType string

paymentMethodType String

请求

响应

更多信息

特殊参数说明

结果处理逻辑

paymentStatus 后续操作

结果码

支付结果码

交易结果码