PayPal 出错处理

[Queen]

错误代码可以被分成好几组来处理. 有需要采取行动的,也有可以不用理的.具体描述如下:

可修复错误(Fix): 很多错误在做过QA后一般都不会出现,这些错误包括但不限于 10004,10007, 811xx 和部分104xx,105xx 和107xx错误.

可忽略错误(Ignore):理想状态下,所有的错误都必须按照下面的方法来处理, 但是也有些错误仅仅是”成功但有警告”性质的,如’10215 Soft Descriptor truncated’,对于这类错误可以忽略.

需上报错误(Escalate): 错误代码如’10001 Internal Error’ 或者 ’10002 Authentication/Authorization Failed’ 通常表示PayPal网站或者商家账户遇到了问题, 这种情况下一般来说只需要重新执行一下原来的动作即可解决,如果还是解决不了,那就需要上报到PayPal的客服部门或者技术支持部门.

需通知错误(Message): 有一些错误则表示买家的账户或者其潜在的资金来源有问题;在某些情况下,只要在稍后重新做一下API 的调用或许就可以解决.但是,如果此时客户正在商家网站付款或者重试后失败时则需要通知买家采取一些必要的动作或者放弃付款. 比如说在DoExpressCheckout中, 错误10422 和10424 表示买家必须要在其PayPal账户中选择一个新的资金来源方式, 而 10417则表示客户必须要选择另外的支付方式.

可重试错误(Retry):有些错误可以被视为Soft Declines(软拒绝)，这些错误商家可以重试多次直至获取到一个成功的响应。他们往往是由于PayPal的系统错误或者是买家的账户问题所造成的, 这些问题也都是可以被修复的. 如果错误一直无法解决, 那商家就需要根据错误代码向买家或PayPal告知.以下是处理重试的一般准则：

1 小时内(PayPal系统问题)

1 天内 (PayPal系统和账户问题)

3 天内 (账户问题)

一般错误代码处理:
811xx Escalate / Fix – 配置或者代码问题, 如有需要可以联系PayPal
100XX Escalate / Fix – 配置或者代码问题, 如有需要可以联系PayPal
10001 Retry (1 hour) – PayPal内部系统错误, 大部分系统可以自行解决问题
101XX Retry (1 hour) – PayPal API 服务不工作, 大部分系统可以自行解决问题
102XX Retry (1 day) – 基本上是各种可以自行解决的错误, 只需修正参数重试即可
10201 Message – 用户协议到期,需要联系客户
10209 Escalate / Fix – 配置或者代码问题, 如有需要可以联系PayPal
10211 Message – 用户协议到期,需要联系客户
10212 Escalate / Fix – 配置或者代码问题, 如有需要可以联系PayPal
104XX Escalate / Fix – 配置或者代码问题, 如有需要可以联系PayPal
10412 *是由于有重复的InvoiceID造成的,只需要保证该值对于商家来说是唯一的订单号即可*
10414 Message – 交易金额超出了买家账户金额,通常需要买家账户先通过PayPal认证
10417 Message – 用户协议到期,需要联系客户
105XX Message – 各种原因导致买家的信用卡遭拒绝,通知客户拒绝的原因
106XX Message – 各种原因导致买家的PayPal账户遭拒绝,通知客户拒绝的原因
107XX Escalate / Fix – 配置或者代码问题, 如有需要可以联系PayPal
113XX Escalate / Fix – 配置或者代码问题, 如有需要可以联系PayPal
114XX Escalate / Fix – 配置或者代码问题, 如有需要可以联系PayPal
116XX Message – 由于商家的风险过滤模型导致拒付,通知客户拒绝的原因
180XX Escalate / Fix – 配置或者代码问题, 如有需要可以联系PayPal
** 如果错误代码不在上述的列表中,则需要将其视为拒绝,同时需要通知到PayPal.**

可以重试的错误代码:

SetExpressCheckout:
10001 内部错误
10102 付款行为(PaymentAction)为Order 暂时失效. 可以稍后再试或者更改为其他的付款行为(PaymentAction).
10103 你的解决方案类型(Solution Type)暂时失效. 如有可能,可以用另外一个解决方案类型(Solution Type).
11547 重复付款暂时失效; 稍后重试

GetExpressCheckout:
10001 内部错误

DoExpressCheckoutPayment:
10001 内部错误
10445 该笔交易暂时无法处理,稍后再试.

Capture:
10001 内部错误
10009 由于买家账户被锁或不活跃导致付款拒绝
10603 买家账户受限;
10606 交易被拒绝,联系买家.
资金来源没有足够余额. 通知买家更换资金来源
10607 授权或者失败暂时失效
10626 该笔交易存在风险.
10628 当前无法处理该笔交易,请稍后重试.

RefundTransaction:
10001 内部错误
10009 交易被拒因为你没有一个验证过的ACH
10009 交易被拒因为你账户被锁或在非激活状态.
10009 交易被拒因为你账户受限.
[NOTE: 并不是所有的10009错误都可以重试,需要检查错误的详细信息]