如何关联Web应用注册用户与GoCardless支付订阅用户？

核心思路 #

不要依赖邮箱作为唯一关联标识，而是通过业务系统内部的用户唯一ID+自定义跟踪参数，在跳转GoCardless时传递、回调时带回，绕开邮箱不一致的问题。以下是具体可行的方案：

方案1：利用GoCardless的metadata字段传递本地用户ID #

GoCardless的API允许在创建客户授权链接时，附加自定义metadata信息（键值对），这些信息会在回调或跳转时完整返回。

• 步骤：
  1. 用户在你的Web应用完成注册后，获取其本地数据库中的唯一用户ID（如user_12345）。
  2. 调用GoCardless的创建授权链接接口时，在请求体中加入metadata字段：

     {
       "redirect_uri": "https://your-app.com/gocardless-return",
       "metadata": {
         "local_user_id": "user_12345"
       }
     }
     

  3. 用户跳转至GoCardless填写银行信息时，无论使用何种邮箱，GoCardless都会保留这个metadata。
  4. 当用户完成后跳转回你的redirect_uri，或GoCardless发送webhook回调时，你可以提取metadata.local_user_id，直接关联到本地系统的对应用户，同时存储GoCardless返回的customer_id用于后续支付操作。

方案2：生成唯一关联令牌并通过跳转参数传递 #

如果不想依赖GoCardless的metadata，可以自己生成跟踪令牌：

• 步骤：
  1. 用户注册后，生成一个唯一的UUID令牌（如abc123-def456-ghi789），将令牌与本地用户ID绑定后存入数据库（可设置有效期，比如24小时）。
  2. 将令牌作为查询参数附加到GoCardless的跳转链接中（或通过redirect_uri传递，确保GoCardless跳转回时携带该参数）：

     https://pay.gocardless.com/flow/XXX?redirect_uri=https://your-app.com/gocardless-return?token=abc123-def456-ghi789
     

  3. 用户从GoCardless跳转回你的网站时，提取URL中的token参数，查询数据库找到对应的本地用户，完成关联并删除过期令牌。

方案3：结合Webhook回调与客户ID关联 #

当用户在GoCardless完成操作后，GoCardless会发送webhook通知（如customer_created事件），其中包含customer_id和你之前传递的自定义参数：

• 步骤：
  1. 跳转前传递本地用户ID到GoCardless（通过metadata或自定义参数）。
  2. 接收GoCardless的webhook时，验证请求签名（确保是合法回调），然后提取metadata.local_user_id和customer_id。
  3. 将customer_id与本地用户ID绑定存储，后续处理支付时，通过customer_id即可关联到本地用户，无需依赖邮箱。

通用注意事项 #

• 安全校验：传递的参数要做签名或加密，防止被篡改；回调时必须验证GoCardless的请求签名，避免伪造请求。
• 有效期控制：自定义令牌要设置有效期，过期后自动失效，防止旧令牌被滥用。
• 异常处理：如果用户跳转后未完成GoCardless流程就返回，要提供重试入口，重新生成关联参数跳转。

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