PayPal创建订阅后捕获支付报错及沙箱资源不可见问题咨询

问题1：创建订阅后立即调用捕获支付接口报错 #

在PAYPAL中创建订阅后立即捕获授权支付会触发业务校验错误，复现代码如下：

$provider = new PayPalClient;
$provider->getAccessToken();
$response = $provider->captureSubscriptionPayment($request->input('subscription_id'), 'capturing payment', (float)$package->price);

报错详情 #

接口返回两类UNPROCESSABLE_ENTITY错误：

1. 零待结余额错误

{
    "name":"UNPROCESSABLE_ENTITY",
    "message":"请求操作无法执行，存在语义错误或未通过业务规则校验",
    "debug_id":"2e3384fe1998b",
    "details":[
        {
            "issue":"ZERO_OUTSTANDING_BALANCE",
            "description":"当前待结清余额必须大于0"
        }
    ]
}

2. 捕获金额超限错误

{
    "name":"UNPROCESSABLE_ENTITY",
    "message":"请求操作无法执行，存在语义错误或未通过业务规则校验",
    "debug_id":"b1c0f40b4e56b",
    "details":[
        {
            "issue":"AMOUNT_GREATER_THAN_OUTSTANDING_BALANCE",
            "description":"指定的金额不能超过当前待结清余额"
        }
    ]
}

错误原因与解决方案 #

两个报错核心原因一致：接口调用逻辑不符合PayPal订阅的计费规则

• captureSubscriptionPayment接口的作用是捕获订阅下已经生成的待支付欠款（比如用户扣费失败产生的逾期账单、手动为订阅添加的待收费用），不能用来捕获刚创建订阅的首期授权款。
• 默认配置下的自动扣费订阅，首期款项会在订阅激活后由PayPal自动发起扣款，不需要手动调用捕获接口。调用接口时如果系统还未生成待支付账单，就会触发零待结余额错误；传入的捕获金额高于实际待结金额时，就会触发金额超限错误。
• 如果需要手动控制首期款的授权捕获，创建订阅计划时需将payment_preferences.auto_bill_outstanding参数设为false，同时通过setup_fee字段设置首期授权金额，等订阅状态变为ACTIVE、且确认存在对应金额的待结清账单后，再调用捕获接口。

问题2：API创建的沙箱资源在控制台不可见 #

通过API创建产品、计划、订阅后，资源在PayPal沙箱账户控制台无法查看，但通过API调用可以正常查询到所有资源的完整详情。

备注：当前使用srmklive/laravel-paypal封装的接口完成产品、计划、订阅的创建操作。

原因与解决方案 #

• 问题成因：PayPal沙箱控制台本身不会同步展示所有通过REST API创建的订阅类资源，尤其是v1版本接口创建的产品、计划、订阅，默认不会出现在旧版沙箱dashboard中。只要API可以正常查询到资源详情，就说明资源创建成功，不会影响后续支付流程。
• 查看路径：登录PayPal开发者后台，进入对应沙箱测试商户账号的详情页，切换到「订阅与账单」分类即可查看对应资源；如果仍无法查看，直接调用资源查询接口获取详情即可，不需要依赖控制台展示。

内容的提问来源于stack exchange，提问作者TWF