如何用PayPal Payments v2替代即将废弃的v1创建支付API?
PayPal v1 Create Payment接口的v2替代方案
PayPal v2 API体系中没有和v1 Create Payment完全对等的单一接口,而是采用以订单(Order)为核心的流程来替代,以下是两种主流实现方式:
1. 前端集成智能支付按钮(官方推荐)
- 前端通过PayPal JS SDK加载支付按钮,用户点击后SDK会自动处理订单创建的前端流程
- 后端仅需实现两个核心接口:
- 创建订单:
POST /v2/checkout/orders—— 用于定义订单的金额、商品明细、支付意图等核心信息 - 捕获订单资金:
POST /v2/checkout/orders/{order_id}/capture—— 用户完成支付后,后端调用此接口确认并收取资金
- 创建订单:
2. 纯后端发起支付(无前端交互场景)
- 若需纯后端触发支付,同样先调用
POST /v2/checkout/orders创建订单,再通过返回的订单信息生成支付链接引导用户完成支付,最后调用捕获接口完成收款 - 创建订单的示例请求体:
{ "intent": "CAPTURE", "purchase_units": [ { "amount": { "currency_code": "USD", "value": "10.00" } } ] }
- 接口响应中会包含订单ID(
id字段)和支付跳转链接(links数组中rel为approve的href)
核心差异说明
- v1的
Create Payment是先创建独立支付对象再跳转,v2则以订单为核心载体,所有支付相关操作(授权、捕获、退款等)都围绕订单展开 - v2订单流程原生支持更多支付方式,且更符合现代支付的安全与合规要求
内容的提问来源于stack exchange,提问作者Usha G
相关产品推荐
相关产品推荐

