拒绝码
PayPal 拒绝代码：每个代码的含义和处理方法
核实日期
PayPal 以两种方式报告支付失败。银行卡支付会带有一个处理器响应代码，例如 0500 DO_NOT_HONOR 或 5120 INSUFFICIENT_FUNDS，由银行或处理器设置。任何 PayPal 支付也可能因 Orders API 错误而失败，例如 INSTRUMENT_DECLINED 或 PAYER_ACTION_REQUIRED。下面每个页面都提供了 PayPal 自己的含义、买家和商家可以做什么，以及 PlatformDTC 如何处理该拒绝。
| 代码 | 含义 |
|---|---|
| 0100 | Referral：发卡银行希望持卡人在批准前联系银行。 |
| 0390 | 账户未找到：银行没有与这些卡片详细信息匹配的账户。 |
| 0500 | Do not honor：发卡银行拒绝了支付，且未给出任何理由。 |
| 0580 | Unauthorized transaction：此银行卡未授权此支付。 |
| 0960 | 系统故障：技术故障阻止了付款，不是银行拒绝。 |
| 10BR | 发卡方拒绝：这张卡的银行拒绝了这笔付款。 |
| 1310 | 金额无效：付款金额因无效而被拒绝。 |
| 1320 | 无效货币代码：此处的支付货币无法使用。 |
| 1330 | 无效账户：该卡的账户对支付无效。 |
| 1380 | 无效有效期：发送的有效期与有效卡不匹配。 |
| 1382 | 无效的银行卡验证值：安全码 (CVV) 被拒绝。 |
| 5100 | 通用拒绝：银行卡被拒绝，但未给出原因。 |
| 5110 | CVV2 失败：银行卡的安全码不匹配。 |
| 5120 | 资金不足: 该卡没有足够的资金或信用额度来支付此款项。 |
| 5140 | 卡已关闭: 该卡的账户已被银行或持卡人关闭。 |
| 5150 | 收回卡片，特殊情况：银行希望停用此卡。 |
| 5160 | 未经授权的用户：支付者无权使用此卡。 |
| 5170 | AVS 失败：账单地址与银行记录不符。 |
| 5180 | 无效或受限卡：此卡无法使用；PayPal 建议尝试其他卡。 |
| 5200 | 重复交易：已提交了一笔匹配的付款。 |
| 5400 | 过期卡：卡片已过有效期。 |
| 5650 | 需要 SCA：银行需要持卡人验证支付。 |
| 5700 | 交易不允许：超出了此银行卡接受的业务范围。 |
| 5710 | 尝试次数超出限制：此银行卡支付尝试次数过多。 |
| 5910 | 发卡行不可用，不可重试：无法联系到银行，PayPal 说不要重试。 |
| 5920 | 发卡行不可用，可重试：无法联系到银行；请稍后再试。 |
| 5930 | 银行卡未激活：银行卡尚未被持卡人激活。 |
| 5950 | 账户已更新：已发行一张更新的银行卡，因此旧的详细信息被拒绝。 |
| 6300 | 账户未备案：银行没有此卡账户的记录。 |
| 7710 | 身份验证失败：3-D Secure 验证未通过。 |
| 8000 | 处理器系统错误：处理器出现技术故障，导致支付停止。 |
| 9100 | 已拒绝，请重试：一次临时拒绝；PayPal 的建议是重试。 |
| 9500 | 疑似欺诈：该支付被标记；PayPal建议使用另一张卡。 |
| 9510 | 安全违规：该支付违反了安全规则并被拒绝。 |
| 9520 | 丢失或被盗：该卡已被报告丢失或被盗；PayPal 建议使用另一张卡。 |
| 9530 | 保留，呼叫中心：商家必须拨打卡片背面的电话号码。 |
| 9540 | 银行卡被拒：此笔付款银行卡被拒绝。 |
| 00N7 | CVV2 失败，使用 CVV 重试：安全码失败；请使用正确的安全码重试。 |
| PCVV | CVV 失败：卡片安全码检查失败。 |
| PP06 | 账户已关闭：之前开立的账户现已关闭。 |
| PPRN | 不允许再次尝试：不允许对该支付进行另一次尝试。 |
| PPAB | 发卡行已阻止账户：银行卡的发卡行已阻止该账户。 |
| PPAD | 账单地址：支付因账单地址而被拒绝。 |
| PPAX | 金额超出：支付金额超过了卡或账户的限额。 |
| PPCT | 不支持的卡类型：此卡类型不接受用于此支付。 |
| PPD3 | 3-D Secure 错误：卡验证步骤出现错误。 |
| PPEF | 资金工具已过期：用于支付的卡或账户已过期。 |
| PPEL | 超出频率限制：此卡在一段时间内支付次数过多。 |
| PPEX | 有效期：支付因卡的有效期而被拒绝。 |
| PPFR | 受限资金工具：卡或账户受到限制。 |
| INSTRUMENT_DECLINED | 支付工具被拒绝：买家 PayPal 账户中的银行卡或银行账户被拒绝。 |
| PAYER_ACTION_REQUIRED | 需要付款人操作：买家必须返回 PayPal 完成支付。 |
| PAYER_CANNOT_PAY | 付款人无法付款：该买家和该卖家的 PayPal 设置不允许此付款。 |
| TRANSACTION_REFUSED | 交易被拒绝：PayPal 拒绝了请求，但没有给出具体原因。 |
| PAYEE_ACCOUNT_RESTRICTED | 收款人账户受限：商家的 PayPal 账户受限。 |
| PAYER_ACCOUNT_LOCKED_OR_CLOSED | 付款人账户被锁定或关闭：买家的 PayPal 账户无法使用。 |
| COMPLIANCE_VIOLATION | 合规违规：PayPal 因合规原因拒绝了付款。 |
| MAX_NUMBER_OF_PAYMENT_ATTEMPTS_EXCEEDED | 超出最大付款尝试次数：此订单尝试次数过多。 |
| CARD_EXPIRED | 银行卡过期：通过PayPal使用的银行卡已过期。 |
| CARD_TYPE_NOT_SUPPORTED | 不支持的银行卡类型：这种银行卡无法处理；请使用其他银行卡。 |
| AGREEMENT_ALREADY_CANCELLED | 协议已取消：买家的 PayPal 账单协议已取消。 |
| REDIRECT_PAYER_FOR_ALTERNATE_FUNDING | 重定向以选择其他资金来源：将买家送回以选择其他资金来源。 |
| TRANSACTION_BLOCKED_BY_PAYEE | 被收款人阻止：商家自己的 PayPal 欺诈设置阻止了付款。 |
| PAYEE_BLOCKED_TRANSACTION | 收款人阻止交易：商家的 PayPal 欺诈工具拒绝了它。 |
| TRANSACTION_LIMIT_EXCEEDED | 交易限额超出：总金额超过了PayPal的交易限额。 |
| PAYMENT_DENIED | 付款被拒绝：PayPal拒绝处理该交易。 |
处理器响应代码和 Orders API 错误
处理器响应代码是 PayPal 在银行卡捕获或授权被拒绝时返回的四字符值，位于 `processor_response.response_code` 中。它们来自发卡银行或处理器，是 PayPal 提供的最接近银行拒绝原因的信息。PayPal 发布每个代码时都带有一个短名称（例如 9500 SUSPECTED_FRAUD），对于少数代码，还会提供一条说明，例如“尝试使用另一张卡。不要重试同一张卡。”
Orders API 错误是 PayPal 在请求失败时返回的问题名称，例如当买家的资金来源被拒绝时返回 INSTRUMENT_DECLINED，或者当买家需要返回 PayPal 时返回 PAYER_ACTION_REQUIRED。它们同样适用于 PayPal 钱包支付和银行卡支付。
PayPal 银行卡支付和 PayPal 钱包支付
当购物者在 PayPal 的银行卡字段中输入银行卡信息时，拒绝通常会附带发卡银行的处理器响应代码，因此原因可以具体到银行卡过期或安全码错误。
当购物者使用他们的 PayPal 钱包支付时，PayPal 会选择钱包内的资金来源，并通常将失败报告为 Orders API 错误，例如 INSTRUMENT_DECLINED。PayPal 对这种情况的指导是重新开始支付，以便买家可以选择另一个资金来源。
PlatformDTC 如何处理 PayPal 拒绝
PlatformDTC 将其识别的每个 PayPal 银行卡处理器代码转换为一种简单的拒绝类型（资金不足、银行卡过期、银行无理由拒绝、临时错误、需要身份验证或无效卡），并将原始代码保留在失败消息中以供支持。
启用智能重试后，因资金不足或一般性 PayPal 拒绝而失败的 PayPal 订阅续订会获得比银行卡更长的重试阶梯：最多 7 次尝试，每次至少间隔 3 天，如果其中一次尝试落在订阅者下一个发薪日的一周内，则会移至该发薪日，总共在至少 24 天的窗口期内。无效协议以及已关闭或锁定的 PayPal 账户绝不会重试：无论设置如何，订阅都会立即取消。硬拒绝（无效、过期或受限银行卡，PAYER_CANNOT_PAY）在任何计划下都不会重试，包括默认的固定计划：订阅将被标记为逾期，并要求客户提供新的支付方式。由商家自己的 PayPal 账户引起的拒绝（PAYEE_ACCOUNT_RESTRICTED, PAYEE_BLOCKED_TRANSACTION）绝不会归咎于客户：续订会暂停，自动重试，并且商家会收到仪表板警报。
常见问题
- 我在哪里可以找到订单的 PayPal 拒绝代码？
- 对于银行卡支付，在捕获或授权的 `processor_response.response_code` 中。对于任何 PayPal 支付，失败请求的错误正文会在 `details[0].issue` 中指出问题，例如 INSTRUMENT_DECLINED。
- 哪些 PayPal 拒绝代码绝不应该重试？
- PayPal 自己表示，对于 5150、5180、9500 和 9520，不要重试同一张卡。过期、已关闭或无效的银行卡、错误的安全码以及已取消的账单协议在重试时也不会成功。
- 为什么 PayPal 会说 INSTRUMENT_DECLINED 而没有给出原因？
- 该错误涵盖了处理器或银行对买家所选资金来源的任何拒绝。PayPal 的建议是重新开始支付，以便买家可以选择另一个来源。
- PlatformDTC 会重试 PayPal 订阅支付吗？
- 是的，对于可以恢复的拒绝。启用智能重试后，资金不足和一般性拒绝会在至少 24 天内获得最多 7 次尝试，临时错误最多 4 次，无理由的银行拒绝 1 次；在默认的固定计划下，它们会分别在 1、3、5 和 7 天后重试。无效卡、过期卡和已关闭账户在任何计划下都不会重试。
来源
- Orders v2 API 架构：`processor_response.response_code` — PayPal
- Orders v2 API 错误 — PayPal
- 处理资金失败 — PayPal