从自有电商平台迁移至Shopify：如何获取PayPal B-账单协议ID

核心问题 #

从自研电商迁移到Shopify，需同步订阅周期为X个月的PayPal订阅用户，Appstle和Shopify均要求提供B-XXX格式的账单协议ID，但当前仅持有PayPal订阅ID（I-XXX）和计划ID（P-XXX），调用API未找到对应B号。

解决方案 #

1. 通过订阅详情API直接获取 #

调用PayPal新版订阅API，传入现有订阅ID（I-XXX）：

GET /v1/billing/subscriptions/{I-XXX}

在响应数据中查找billing_agreement_id字段，其值即为所需的B-XXX格式账单协议ID。

2. 账单协议列表API筛选查询 #

若订阅详情未返回B号，调用协议列表API，通过计划ID（P-XXX）或用户邮箱过滤目标记录：

GET /v1/billing/agreements?plan_id={P-XXX}

返回结果中每个协议对象的id字段即为B-XXX编号，可通过订阅用户的邮箱匹配对应记录。

3. 关联Shopify客户的验证 #

拿到B-XXX后，使用Shopify的GraphQL mutation完成客户与账单协议的关联：

mutation {
  customerPaymentMethodPaypalBillingAgreementCreate(
    customerId: "gid://shopify/Customer/你的客户ID"
    paypalBillingAgreementId: "B-XXX"
  ) {
    customerPaymentMethod {
      id
    }
    userErrors {
      field
      message
    }
  }
}

注意事项 #

• 仅活跃/已创建状态的订阅会返回有效B号，已取消/过期的订阅可能无此字段；
• 确保调用API使用PayPal生产环境密钥，沙箱环境数据无法匹配生产场景。

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