跳到主要内容

交易错误代码

所有交易错误代码的列表。

交易的 error_code 值对于成功的交易可能为 null，或者对于失败和被拒绝的交易为以下之一。

核心失败​

我们的系统可能会拒绝或使交易失败，与连接器或支付服务拒绝交易相对。当这种情况发生时，可以将以下错误代码之一设置为 error_code 值。

error_code描述
incomplete_buyer_approval当买家批准重定向超时时发生，这通常意味着买家在没有认证的情况下关闭了重定向页面/弹出窗口。此错误代码可能在买家关闭重定向页面/弹出窗口后最多10分钟内出现
failed_buyer_approval当买家通过3DS认证失败时发生。此交易可以再次尝试
missing_redirect_url当交易需要重定向但创建时没有 payment_method.redirect_url 时发生。添加 payment_method.redirect_url 并重试
flow_decline当交易被流程规则拒绝时发生。这可能是由于欺诈或替代系统配置拒绝交易
all_attempts_skipped当交易失败是因为匹配的流程规则中的任何结果都不能可靠地处理交易时发生。为避免这种情况，请确保为每个可能的交易场景定义一个默认的合适结果

连接器拒绝​

当支付服务拒绝或使交易失败时，可以根据从支付服务收到的响应设置以下 error_code 值。从支付服务收到的原始值将在交易记录的 raw_response_* 字段中可用。

下表中的金额列指定了在使用卡模拟器连接器时可用于模拟 error_code 的 amount。

error_code描述模拟器金额可重试？
canceled_payment_method支付方式报告丢失、被盗或以其他方式取消，请求另一种支付方式200001
expired_authorization授权已过期，创建新的授权并使用新的授权200004
expired_payment_method支付方式已过期，使用另一种支付方式200005
incorrect_billing_address账单地址与帐户不匹配。提示客户更正账单地址并重试200006
incorrect_country国家代码被服务或发卡机构拒绝，请求另一种支付方式200007是
incorrect_currency货币代码被服务或发卡机构拒绝，请求另一种支付方式200008是
incorrect_cvvCVV不正确。提示客户更正CVV并重试200009
incorrect_expiry_date到期日期不正确或支付方式已过期。提示客户更正到期日期并重试或请求另一种支付方式200010
insufficient_funds金额超过支付方式的可用余额。提示客户检查其余额200011
issuer_decline支付被发卡机构拒绝。提示客户与其发卡机构核实200012是
other_decline交易因未知原因失败，如果重试可能会成功200013是
refused_transaction交易因法律原因被拒绝（例如观察名单、禁运、制裁），请求另一种支付方式200015
service_decline支付被服务拒绝，请求另一种支付方式200016是
suspected_fraud服务将交易标记为疑似欺诈。提示客户与其发卡机构核实200017

连接器失败​

error_code描述模拟器金额可重试？
cancelled_buyer_approval交易被客户取消200022
disputed_transaction由于已发起拒付，无法退款交易200002
duplicate_transaction交易是先前交易的重复。检查以确保交易仅提交一次200003
insufficient_service_permissions服务凭据缺乏执行请求操作的权限，检查相关配置300001是
invalid_amount服务不支持金额，检查相关配置300002是
invalid_payment_method服务不支持支付方式（例如不支持卡片方案），请求另一种支付方式300003是
invalid_service_configuration服务配置不正确，检查相关配置300004是
invalid_service_credentials服务凭据无效，检查相关配置300005
invalid_service_response无法解析服务响应，检查相关配置300006是
invalid_tax_identifier税务标识符无效（例如GB增值税号格式无效，或类型错误），更正标识符300007
missing_billing_address需要账单地址。添加账单地址并重试300008是
missing_cvv需要CVV。添加CVV并重试300009是
missing_shipping_address需要送货地址。添加送货地址并重试300010是
missing_tax_identifier需要税务标识符。添加税务标识符并重试300011是
refund_period_expired由于退款期限已过期，无法执行退款，以其他方式给客户退款300012
requires_buyer_authentication发卡机构要求额外凭据，例如安全码（CVV）。添加这些凭据并重试200014
service_error服务报告内部服务器错误或上游处理错误，检查相关配置300013是
service_network_error服务无法访问或遇到超时，等待后重试300014是
service_rate_limit服务响应速率限制错误，等待后重试300015是
internal_error发生内部错误，检查相关配置400001
invalid_billing_address账单地址无效。更正账单地址并重试400002
invalid_operation服务/方法未实现，此请求不支持操作，检查相关配置400003是
invalid_request_parameters一个或多个请求参数无效，检查有效负载并重试400004
invalid_service_request无法解析服务请求，检查有效负载并重试400005是
invalid_shipping_address送货地址无效。更正送货地址并重试400006
service_resource_conflict由于冲突，服务无法创建资源，检查相关配置400007是
unavailable_payment_method支付方式暂时冻结或不可用。提示客户与其发卡机构核实或请求另一种支付方式200018
unexpected_state服务配置在意外状态，检查相关配置400008
unknown_error发生未知错误，检查相关配置400009
unknown_payment_method帐户未知，请求另一种支付方式200019是
unknown_service_resource服务找不到资源，检查相关配置400010是
unrecognised_country国家无效，更正国家并重试400013
unrecognised_currency货币无效，更正货币并重试400014
unrecognised_payment_method支付方式无效，请求另一种支付方式400015
unrecognised_scheme支付方案无效，请求另一种支付方式400016
unsupported_country服务不支持该国家，更正国家并重试400011是
unsupported_currency服务不支持该货币，更正货币并重试400012是
unsupported_payment_method服务不支持支付方式（例如不支持卡片方案），请求另一种支付方式200021
unsupported_scheme服务不支持支付方案，请求另一种支付方式400017
unsupported_transaction支付方式不支持此类购买（例如限制赌博），请求另一种支付方式200020

连接器捕获/撤销/退款/支付测试​

error_code描述模拟器金额可重试？
service_network_error[捕获] 服务无法访问或遇到超时，等待后重试500001
refused_transaction[捕获] 交易被拒绝500002
service_network_error[撤销] 服务无法访问或遇到超时，等待后重试510001
issuer_decline[撤销] 支付被发卡机构拒绝。提示客户与其发卡机构核实510002
disputed_transaction[退款] 由于已发起拒付，无法退款交易520001
issuer_decline[退款] 支付被发卡机构拒绝。提示客户与其发卡机构核实520002
service_error[退款] 服务报告内部服务器错误或上游处理错误520003
service_decline[支付] 服务拒绝交易530001
service_error[支付] 服务报告内部服务器错误或上游处理错误530002

服务端错误 (5XX)

如果我们系统中出现服务端错误，我们的API将返回HTTP状态码在500到599范围内的错误。

这些错误都无法在客户端解决。请联系支持以提出任何 5XX 错误。

示例​

{
    "type": "error",
    "code": "server_error",
    "status": 500,
    "message": "Request could not be processed",
    "details": []
}

字段​

type​

string, 必需

返回的对象类型。这始终是 error。

code​

string, 必需

此错误的机器可读代码。这是以下值之一。

  • server_error
  • bad_gateway
  • gateway_timeout

status​

number, 必需

错误的HTTP状态码。这可以是 500、502 或 504。

message​

string, 必需

此错误的人类可读描述。

details​

array

请求的验证错误列表。对于服务器错误，这始终是一个空数组。

Powered by Docusaurus