一、产品创建与环境配置
1.1 环境选择与入口
正式环境操作入口:
进入PayPal商户中心订阅产品创建界面
PayPal官方订阅管理页面
沙盒环境操作入口:
开发者测试专用链接
PayPal沙盒计划配置入口
1.2 可视化配置流程
通过管理后台可完成四大核心配置:
1. 基础信息录入
2. 定价方案设置
3. 订阅周期配置
4. 用户条款确认
二、API集成开发手册
2.1 认证准备
bash
沙盒环境Token获取
curl -v https://api.sandbox.paypal.com/v1/oauth2/token \
-u “ClientID:Secret” \
-d “grant_type=client_credentials”
2.2 产品创建接口
核心参数说明:
| 参数 | 类型 | 必填 | 说明 |
|——|——|——|——|
| type | String | 是 | SERVICE/DIGITAL/PHYSICAL |
| category | String | 是 | 业务分类选择 |
| image_url | URL | 否 | 产品展示图链接 |
json
{
“name”: “Premium Streaming”,
“description”: “4K超清视频服务”,
“type”: “DIGITAL”,
“category”: “ENTERTAINMENT”
}
2.3 订阅计划配置
bash
POST /v1/billing/plans
重点参数设置指南:
– billing_cycles
设置周期扣款规则
– payment_preferences
配置失败重试策略
– taxes
参数处理国际税费
三、进阶订阅管理
3.1 支付跳转配置
json
“application_context”: {
“return_url”: “https://yourdomain.com/success”,
“cancel_url”: “https://yourdomain.com/cancel”,
“user_action”: “SUBSCRIBE_NOW”
}
3.2 Webhook事件监听
推荐订阅事件类型:
– PAYMENT.SALE.COMPLETED
– BILLING.SUBSCRIPTION.ACTIVATED
– BILLING.SUBSCRIPTION.EXPIRED
四、开发辅助工具
在使用PayPal API开发过程中,建议搭配以下工具:
1. [Postman]API测试工具
2. [Ngrok]本地调试工具
3. [野卡]国际支付解决方案