Django Paypal开发:如何通过Webhook或订阅传递用户ID
实现方案说明
完全可以通过PayPal REST API实现该需求,PayPal官方提供了原生支持的安全字段,完全可以避免前端篡改的风险,以下是符合最佳实践的实现方案:
1. 首选方案:使用custom_id字段(官方推荐)
- 该字段是PayPal为开发者预留的自定义参数位,最大支持127字符,存储Django用户ID完全够用
- 所有参数操作都在后端完成,完全不经过前端,不存在被篡改的可能
- 具体实现流程:
- 后端调用PayPal创建订阅接口
POST /v1/billing/subscriptions时,直接在请求体中添加custom_id字段,值为当前登录用户的Django用户ID
示例代码(Django后端实现片段):
import requests from django.conf import settings def generate_paypal_subscription(current_user, paypal_plan_id): # 从PayPal获取接口鉴权token,逻辑完全在后端执行 access_token = get_paypal_access_token() headers = { "Content-Type": "application/json", "Authorization": f"Bearer {access_token}" } payload = { "plan_id": paypal_plan_id, "custom_id": str(current_user.id), # 直接填充后端拿到的用户ID,前端无接触权限 "application_context": { "return_url": settings.PAYPAL_SUCCESS_URL, "cancel_url": settings.PAYPAL_CANCEL_URL } } resp = requests.post( "https://api-m.paypal.com/v1/billing/subscriptions", headers=headers, json=payload ) return resp.json()- 后续收到PayPal任意Webhook事件(包括订阅激活、扣款成功等)时,返回的订阅结构体中会直接携带你之前填入的
custom_id,直接读取该值即可匹配到对应用户,不需要前端传递任何身份参数 - 该字段不会对订阅用户展示,属于开发者专属的隐形参数,安全性极高
- 后端调用PayPal创建订阅接口
2. 备选方案:使用metadata字段
如果除了用户ID还需要存储更多自定义信息,可以用metadata字段,支持最多10组键值对,单值最大支持127字符,用法和custom_id完全一致,也是在后端创建订阅时填入,Webhook事件中会原样返回,同样不存在被篡改的风险。
安全补充说明
- 前端只需要获取后端返回的PayPal订阅审批链接跳转即可,全程不接触任何自定义参数配置,完全杜绝篡改可能
- Webhook收到事件后必须先验证PayPal的官方签名,确认事件确实由PayPal发出,不要直接信任收到的参数内容,这是PayPal官方要求的标准安全流程
内容的提问来源于stack exchange,提问作者Humza
相关产品推荐
相关产品推荐

