大数跨境

向 OrderTransactionErrorCode 枚举新增支付失败代码

向 OrderTransactionErrorCode 枚举新增支付失败代码 Shopify电商独立站
2026-03-16
6
导读:我们正在向 OrderTransactionErrorCode 枚举添加新的错误代码,以更细致地描述交易失败的原因。您可以利用这些更详细的响应来优化客户交互体验。

我们正在向 OrderTransactionErrorCode 枚举添加新的错误代码,以提供有关交易失败的更详细信息。您可以利用这些更详细的响应来改善客户互动体验。

更新内容

这些错误代码有助于精确定位交易问题:

错误代码 说明
AMOUNT_TOO_LARGE 交易金额超过了允许的最大金额。
AMOUNT_TOO_SMALL 交易金额低于允许的最小金额。
AUTHENTICATION_FAILED 3D Secure 身份验证失败。
AUTHENTICATION_REQUIRED 交易需要 3D Secure 身份验证,但未进行身份验证即尝试发起交易。
AUTHORIZATION_EXPIRED 授权已过期。
CANCELLED_PAYMENT 交易已被取消。
CARD_TESTING 由于怀疑存在卡片测试活动,交易被拒绝。
DO_NOT_HONOR 发卡行拒绝了该交易,未提供具体原因。
FRAUD_SUSPECTED 由于怀疑存在欺诈活动,交易被拒绝。
INSUFFICIENT_FUNDS 可用资金不足,无法完成交易。
INSTRUMENT_DECLINED 支付处理器拒绝了该支付工具。
INVALID_CURRENCY 不支持该货币。
INVALID_PAYMENT_METHOD 支付方式无效或不存在。
INVALID_PURCHASE_TYPE 此支付方式不支持所请求的交易类型。
MERCHANT_ACCOUNT_ERROR 由于商户账户存在问题,交易无法处理。
MERCHANT_RULE 由于商户自定义的支付风控规则,交易被拦截。
PAYMENT_METHOD_UNSUPPORTED 不支持该支付方式。
PAYMENT_PROVIDER_ERROR 由于支付提供商出现意外错误,交易无法处理。
RETRY_DECLINED 交易重试尝试被拒绝。
TRANSACTION_LIMIT_EXCEEDED 支付工具已超过处理频率限制。

更新内容

RISKY 错误代码已弃用。当交易因疑似欺诈而被拒绝时,您现在将收到 FRAUD_SUSPECTED。RISKY 值仍保留在枚举中以确保向后兼容,但不再返回该值。

我们还更新了部分现有错误代码的描述,以提高清晰度。

您需要执行的操作

更新您的错误处理逻辑,以利用这些特定的错误代码提供更精准的客户提示。您现在可以根据具体的拒绝原因提供针对性的响应。

更多信息,请参阅 OrderTransactionErrorCode 枚举参考。

【声明】内容源于网络
0
0
Shopify电商独立站
1234
内容 7163
粉丝 0
Shopify电商独立站 1234
总阅读95.5k
粉丝0
内容7.2k