如何通过PayPal API及客户的Access Token获取其全部交易记录？

一、连接客户账户 #

• 确认权限范围：先检查你的Access Token对应的scope是否包含所需权限（比如transaction:read、account:read），没有对应权限会直接导致API调用失败。
• 携带Token发起请求：所有访问客户账户的API请求，都要在请求头中添加Authorization: Bearer {你的Access Token}，PayPal会通过这个Token验证你的访问权限。
• Token过期处理：Access Token有效期通常为8小时，过期后用Refresh Token调用POST /v1/oauth2/token接口刷新，请求参数需包含grant_type=refresh_token和refresh_token={你的Refresh Token}，同时带上你的客户端ID和密钥做基础认证。

二、获取全部交易记录 #

• 使用交易查询API：调用/v1/reporting/transactions接口即可获取客户账户的交易记录。
• 分页遍历全部记录：由于接口有返回条数限制（单次最多1000条），要获取全部记录需分页查询：
  • 设置start_date和end_date覆盖你需要的时间范围（若要全量，可设为账户创建日期到当前日期）
  • 用page_size指定每页条数，page参数指定页码，循环请求直到返回结果为空。
• 注意事项：
  • 必须确保Access Token拥有transaction:read权限，否则会返回权限错误。
  • PayPal默认保留最近3年的交易记录，更早的记录可能无法通过API获取。
  • 可通过transaction_type参数过滤特定类型的交易（比如付款、退款等）。

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