如何通过编程获取PayPal免费试用交易数据？

1. 利用Transactions Search API筛选 #

确保你的PayPal应用已启用Transactions Search API（v1/reporting/transactions），免费试用交易属于订阅类交易，可通过指定参数精准筛选：

• 调用时设置transaction_type=SUBSCRIPTION，同时结合amount=0过滤零金额的试用交易，或者补充transaction_status=COMPLETED缩小范围
• 示例cURL请求：

  curl -v -X GET "https://api-m.paypal.com/v1/reporting/transactions?start_date=2024-01-01T00:00:00Z&end_date=2024-06-01T23:59:59Z&transaction_type=SUBSCRIPTION&amount=0&fields=all" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  

2. 监听订阅相关Webhook事件 #

配置PayPal Webhook，监听BILLING.SUBSCRIPTION.CREATED和BILLING.SUBSCRIPTION.ACTIVATED事件——免费试用订阅创建时会触发这些事件，payload中包含完整的试用配置：

• 从事件数据中提取subscription_id，再调用v1/billing/subscriptions/{subscription_id}接口，可获取订阅的试用周期、起始/结束时间等核心信息
• 若需要关联交易记录，可通过订阅ID在Transactions Search API中进一步查询

3. 查询订阅计划与关联订阅 #

如果已知试用对应的计划ID，可通过以下方式获取批量试用数据：

• 调用v1/billing/plans/{plan_id}接口，在payment_preferences字段下查看setup_fee（0金额即为免费试用）和trial_period配置
• 调用v1/billing/subscriptions列表接口，通过plan_id过滤出所有使用该试用计划的订阅，再逐一关联交易记录

4. 关键注意事项 #

• 必须使用Live环境的API密钥，Sandbox环境的试用交易可能存在数据同步延迟
• 检查API请求的时间范围，确保覆盖试用交易的创建时间
• 部分免费试用交易可能被归类为AUTHORIZATION类型，可补充transaction_type=AUTHORIZATION进行二次查询

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