如何为Web App集成类Calendly的PayPal OAUTH 2.0卖家收款功能

1. 前期PayPal应用配置 #

• 登录PayPal开发者后台创建平台合作类应用，不要选择普通单商户支付应用，开通OAuth2授权权限，提前配置好你平台的授权回调地址
• 分别记录沙箱、生产环境的Client ID和Client Secret，两个环境的凭证不要混用，测试阶段全程用沙箱凭证

2. 卖家端PayPal账号绑定逻辑开发 #

• 每个卖家触发绑定操作时，你平台按PayPal规范生成OAuth授权链接，链接参数需包含你的Client ID、回调地址、申请的权限范围（必须包含收款、订单查询相关权限）
• 卖家跳转至PayPal授权页登录自己的账号、同意授权后，PayPal会回调你配置的地址，返回临时authorization_code
• 你后台用authorization_code+你的Client ID、Client Secret调用PayPal令牌接口，获取该卖家对应的access_token、refresh_token、PayPal商户唯一IDmerchant_id，将三个值与你平台的卖家账号绑定加密存储：refresh_token有效期通常为数年，access_token过期后直接用refresh_token刷新即可，无需卖家重复授权

3. 买家端支付流程开发 #

• 买家下单选择PayPal支付时，你后台先拉取对应商品所属卖家的merchant_id、有效access_token
• 调用PayPal订单创建接口，在收款方参数中明确指定为该卖家的merchant_id，如果你的平台需要抽佣，可直接在接口参数中配置抽成比例，PayPal会自动拆分款项：抽佣部分打至你的平台账户，剩余部分直接进入卖家PayPal账户
• 将创建成功的订单支付链接返回给前端，引导买家完成支付
• 提前配置PayPal webhook回调地址，收到支付成功的回调通知后，更新你平台对应订单的支付状态即可

4. 上线前验证 #

• 用PayPal提供的沙箱卖家、沙箱买家测试账号走完整流程：先完成沙箱卖家账号绑定，再用沙箱买家账号付款，确认沙箱卖家账户余额到账金额正确、订单状态更新正常
• 全流程测试无误后，将所有配置切换为生产环境凭证，提交PayPal官方审核，审核通过后即可正式上线使用

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