Antom, leading provider of tailored payment solutions

SDK 事件码

本文为您介绍在集成 Antom SDK 过程中，可能通过回调函数或不同方法返回的事件码、卡支付信息以及风控信息。

onEventCallback
回调函数事件码

回调函数事件码在不同时机通过不同回调函数返回，主要包括以下三种：
  • 状态码
  • 错误码
  • 支付结果码

状态码

在组件运行生命周期内，通过
onEventCallback
回调函数返回，可根据具体事件进行后续处理。
  • SDK_START_OF_LOADING
    ：配置
    showLoading
    为
    false
    时，使用自定义动画，您可在这个时机渲染并展示自定义加载动画。
  • SDK_END_OF_LOADING
    ：配置
    showLoading
    为
    false
    时，使用自定义动画，您可在这个时机结束自定义加载动画。
  • SDK_PAYMENT_CANCEL
    ：表示用户取消支付，即用户未提交订单退出支付页面。可使用有效期内的 paymentSessionData 重新调用 SDK。如已过期，需要重新发起 支付会话创建 请求。
  • SDK_CALL_URL_ERROR
    ：此事件码代表以下事件信息中的一种情况：
    • 跳转商户页面失败。
    • 跳转支付方式 App 或页面失败。
    • 调用 支付会话创建 请求时 paymentRedirectUrl 参数未传入或未正确传入。
Web/WAP 场景下通常不会出现跳转异常，如果出现异常建议您校验重定向链接。App 场景下，如果频繁出现跳转异常，请联系 Antom 技术支持，排查跳转或唤端问题。
  • SDK_CALL_URL_SUCCESS
    ：跳转支付方式/商户页面成功。
  • SDK_DUPLICATE_SUBMISSION_BEHAVIOR
    ：表单重复提交。您可以设置提示，避免用户重复点击提交。
  • SDK_FORM_VERIFICATION_FAILED
    ：提交表单后校验不通过。SDK 会在要素收集页面展示表单错误码，用户可以重新提交支付。
  • SDK_PAYMENT_AUTHORIZATION_SUCCESSFUL
    ：支付流程已完成。如果配置了支付后不跳转的方法，建议继续监听相应的支付事件码以处理后续流程。否则，可以忽略此事件码并跳转到您的支付结果页面。
  • SDK_PAYMENT_CHALLENGE
    ：触发3D验证，发卡行需要与买家进行进一步交互才能验证支付。无需处理，SDK 会自动跳转到验证页面。

错误码

在组件初始化阶段，通过
onEventCallback
或
onError
回调函数返回，可根据具体事件进行后续处理。
  • SDK_INTERNAL_ERROR
    ：SDK 内部错误。请联系 Antom 技术支持。
  • SDK_CREATEPAYMENT_PARAMETER_ERROR
    ：
    createComponent
    函数传入参数异常。请检查参数是否正确并重新初始化组件。
  • SDK_INIT_PARAMETER_ERROR
    ：
    AMSCashierPayment
    函数传入参数异常。请检查参数是否正确并重新实例化 SDK。
  • SDK_CREATECOMPONENT_ERROR
    ：组件初始化异常。请联系 Antom 技术支持。
  • SDK_SUBMIT_NETWORK_ERROR
    ：因网络原因，接口调用失败。在
    submit
    函数提交中可能会出现。请尝试再次提交。

支付结果码

在支付流程结束时，通过
onEventCallback
回调函数返回，可根据具体事件进行后续处理。
  • SDK_PAYMENT_SUCCESSFUL
    ：表示支付成功。建议您重定向到支付结果页。
  • SDK_PAYMENT_FAIL
    ：表示支付失败。建议您根据 paymentResultCode 错误码提示信息进行处理，并引导重新支付。
  • SDK_PAYMENT_PROCESSING
    ：表示支付处理中。建议您的服务端查询支付状态或等待支付结果通知，同时可询问用户是否完成，如果用户未完成支付，可以引导重新支付。
  • SDK_PAYMENT_ERROR
    ：表示支付状态异常。建议您的服务端查询支付状态或等待支付结果通知。
  • SDK_PAYMENT_RETRY
    ：支付失败后重试。 在开启失败可重试的情况下，引导用户修改信息后再支付。

支付失败或异常说明

以下表格为支付失败或异常时的支付结果信息以及对应的处理建议，您可以根据收到的支付结果码作进一步处理。
支付结果码（paymentResultCode）
支付结果信息（paymentResultMessage）
处理建议
ACCESS_DENIED
访问被拒绝。
无权限。请联系 Antom 技术支持了解具体原因。
CURRENCY_NOT_SUPPORT
币种不受支持。
币种不受支持。请联系 Antom 技术支持了解具体原因。
FRAUD_REJECT
由于风险控制，交易无法进一步处理。如果买家已为交易付款，交易将被退款。
如下情况请联系 Antom 技术支持：
  • 您需要申诉。
  • 买家两周内未收到退款。
INVALID_CARD
无效卡。可能是信用卡号无法识别，没有对应的发卡行，或者卡号格式错误。
建议换卡重试。
INVALID_EXPIRY_DATE_FORMAT
expiryYear 或 expiryMonth 格式错误。
卡有效期格式错误。建议检查卡有效期的填写格式。
ISSUER_REJECTS_TRANSACTION
发卡行拒绝交易。
建议换卡重试或联系发卡行。
INVALID_MERCHANT_STATUS
由于存在限制，商户状态异常。
请联系 Antom 技术支持了解具体原因。
MERCHANT_KYB_NOT_QUALIFIED
由于商户的 KYB 状态，支付失败。商户可能未完成 KYB，或者 KYB 状态不适用于此交易。
请联系 Antom 技术支持了解具体原因。
NO_PAY_OPTIONS
没有可用的支付选项。
币种不支持。检查支付方式是否支持该币种，或支付方式和币种是否与合同中所签约一致。如有问题，请联系 Antom 技术支持了解具体原因。
ORDER_IS_CLOSED
您发起的请求具有与已关闭交易相同的 paymentRequestId。
订单关闭。请重新发起请求。
PAYMENT_AMOUNT_EXCEED_LIMIT
支付金额超过了合同或支付方式允许的最大金额。
超过限制金额。检查支付金额是否超过限额或使用较低的金额重试。请联系 Antom 技术支持了解具体支付限额。
PAYMENT_COUNT_EXCEED_LIMIT
支付次数超过了支付方式规定的限制。
超过限制使用次数。联系 Antom 技术支持了解具体支付限额。
PAYMENT_NOT_QUALIFIED
商户不具备支付资格，可能是因为未注册、未签订自动扣款协议或被禁止支付。
商户无权限。请联系 Antom 技术支持了解具体原因。
PROCESS_FAIL
发生了常见的业务失败。
支付失败。请联系 Antom 技术支持。
RISK_REJECT
由于风险控制，该交易无法进一步处理。如果买家已为交易付款，交易将被退款。
风控拒绝。如果买家两周内未收到退款，请联系 Antom 技术支持。
SUSPECTED_CARD
该卡疑似存在欺诈行为。例如，卡片可能被盗或受到限制。
风控拒绝。建议换卡重试或联系发卡行。
SUSPECTED_RISK
由于怀疑存在安全问题，无法进一步处理该交易。您可以在一个工作日后重试该交易。如果交易不安全但用户已付款，则该交易将被退款。
风控拒绝。如下情况下请联系 Antom 技术支持：
  • 您需要申诉。
  • 买家两周内未收到退款。
USER_AMOUNT_EXCEED_LIMIT
支付金额超过了用户的支付限额。
金额超限。使用小于或等于账户可用余额的金额重新发起支付，或联系 Antom 技术支持。
USER_BALANCE_NOT_ENOUGH
由于对应支付方式的用户余额不足，支付无法完成。
用户余额不足。请充值或选择其它支付方式。
USER_KYC_NOT_QUALIFIED
由于用户的 KYC 状态，支付失败。用户要可能不符合 KYC 要求，或其 KYC 状态不符合此交易的要求（例如，支付金额或产品信息的限制）。
用户 KYC 验证异常，请先完成 KYC 认证。
USER_PAYMENT_VERIFICATION_FAILED
用户在支付方式方面受到限制，无法进行支付。
用户验证失败。请联系 Antom 技术支持了解具体原因。
USER_STATUS_ABNORMAL
用户在支付方式端的状态异常。
用户状态异常。请联系 Antom 技术支持了解具体原因。
PAYMENT_IN_PROCESS
支付正在处理中。
支付处理中。
UNKNOWN_EXCEPTION
由于未知原因，接口调用异常。
未知异常。请联系 Antom 技术支持了解具体原因。
CARD_NOT_SUPPORTED
用于交易的卡不支持。
卡不支持。请换卡重试。
INVALID_EXPIRATION_DATE
paymentMethod.paymentMethodMetaData.expiryYear 或者 paymentMethod.paymentMethodMetaData.expiryDate 的值无效。
卡的有效期不正确。建议检查卡有效期是否填写及是否填写正确。
INVALID_CARD_NUMBER
用于交易的卡号无效。
卡号不正确。建议换卡重试。如重试后还有问题，请联系 Antom 技术支持了解具体原因。

卡支付信息

在卡支付场景下，当支付流程达到成功或失败的最终状态时，您可以在调用
onEventCallback
函数后在响应中收到 cardPaymentResultInfo 参数。 请参阅下表了解 cardPaymentResultInfo 的子参数信息:
注意：如果支付流程完成，用户被重定向到跳转链接，您将不会收到 cardPaymentResultInfo 参数。
参数名称
是否必需
说明
cardNo
可选
String (32)
脱敏卡号，仅显示部分卡号，可用于向用户展示。
当 支付 接口中字段 paymentMethodType 的值为
CARD
且商户没有 PCI 资质时返回此参数。
cardBrand
可选
String (256)
卡品牌，可用于向用户展示。
当 支付 接口中字段 paymentMethodType 的值为
CARD
时返回此参数。
cardBin
可选
String (32)
卡号前 6 位。
lastFour
可选
String (4)
卡号后 4 位。
issuerName
可选
String (256)
发卡行。
issuingCountry
可选
String (2)
发卡国家。此参数的值为两个字母的国家/地区代码，遵循 ISO 3166 国家/地区代码标准。
当 支付 接口中字段 paymentMethodType 的值为
CARD
时返回此参数。
funding
可选
String (32)
卡片的资金类型。有效值包括：
  • CREDIT
    ：表示信用卡。
  • DEBIT
    ：表示借记卡。
  • PREPAID
    ：表示预付卡。
  • CHARGE
    ：表示充值卡。
  • DEFERRED_DEBIT
    ：表示延期借记卡。​
满足以下所有条件时，将返回此参数：
  • 参数 paymentMethodType 的值为
    CARD
    。
  • 参数 cardNo 传入的是有效值。
  • Antom 的卡数据库中包含此信息。
avsResultRaw
可选
String (128)
原始 AVS 结果。请参阅 AVS 结果代码查看有效值。
当发卡行将此信息传递给 Antom 时将返回此参数。
cvvResultRaw
可选
String (128)
原始卡验证值 (CVV)、卡安全码 (CSC) 或卡验证码 (CVC) 结果。请参阅 CVV 结果代码查看有效值。
当发卡行将此信息传递给 Antom 时将返回此参数。
holdName
可选
String (32)
持卡人姓名。
fingerprint
可选
String (256)
此特定卡号的唯一标识。您可以使用此参数检查两个已注册的客户是否使用相同的卡号。
expiryMonth
可选
String (2)
银行卡的过期月份。传入表示月份的两位数字。例如，如果过期月份是二月，此参数的值为
02
。​
满足以下所有条件时，将返回此参数：
  • 您已获得 PCI 资格。
  • 参数 paymentMethodType 的值为
    CARD
    。
  • Antom 的卡数据库中包含此信息。
expiryYear
可选
String (2)
银行卡的到期年份。输入年份的最后两位数字。例如，如果到期年份是2025，此参数的值为
25
。
满足以下所有条件时，将返回此参数：
  • 您已获得 PCI 资格。
  • 参数 paymentMethodType 的值为
    CARD
    。
  • Antom 的卡数据库中包含此信息。
返回的卡片信息的示例代码：
{
  "result": {
      "resultCode": "SUCCESS",
      "resultStatus": "S",
      "resultMessage": "Success"
  },
  "paymentStatus": "SUCCESS",
  "paymentResultCode": "SUCCESS",
  "paymentResultMessage": "success",
  "cardPaymentResultInfo": {
      "avsResultRaw": "4",
      "cardBin": "409280",
      "cardBrand": "VISA",
      "cardNo": "************8888",
      "cvvResultRaw": "1",
      "expiryMonth": "02",
      "expiryYear": "27",
      "fingerprint": "",
      "funding": "DEBIT",
      "holdName": "Tom Jay",
      "issuerName": "BANCO ITAUCARD, S.A.",
      "issuingCountry": "BR",
      "lastFour": "0000"
  }
}

风控信息

在卡支付场景下，当支付流程达到成功或失败的最终状态并且您与 Antom 签署了风控服务时，您可以在调用
onEventCallback
函数后在响应中收到 popRiskDecisionResultInfo 参数。 请参阅下表了解 popRiskDecisionResultInfo 的子参数信息:
注意：如果支付流程完成后用户被重定向，您将不会收到 popRiskDecisionResultInfo 参数。
参数名称
是否必需
说明
riskDecision
可选
Antom 的风险管理决策。有效值为：
•
ACCEPT
：表示 Antom 建议您接受付款。
•
REJECT
：表示 Antom 建议您拒绝付款。
当您与 Antom 签署风控服务时返回该参数。
riskAuthDecision
可选
Antom 推荐的身份验证方法。有效值为：
•
3D
：建议对此交易进行 3D 身份验证。
•
NON_3D
：建议对此交易进行非 3D 验证。
当您与 Antom 签署风控服务时返回此参数。
返回的风控信息示例代码：
{
  "result": {
      "resultCode": "SUCCESS",
      "resultStatus": "S",
      "resultMessage": "Success"
  },
  "paymentStatus": "SUCCESS",
  "paymentResultCode": "SUCCESS",
  "paymentResultMessage": "success",
  "popRiskDecisionResultInfo": {
      "riskDecision": "ACCEPT",
      "riskAuthDecision": "NON_3D"
  }
}