• 正式环境创建订阅计划

• 沙盒环境创建订阅计划

在以上页面中，您可以创建产品和计划，正式环境和沙盒环境的数据相互独立。

1. 进入对应环境的链接。

2. 根据流程逐步填写产品和订阅计划信息。

3. 保存设置后，您的订阅计划即可在正式环境中使用。

您也可以通过 API 的方式完成产品及计划的创建，以下为详细 API 请求说明。

API 文档参考：PayPal REST API 文档

通过以下请求获取 Access Token：

• 沙盒环境https://api.sandbox.paypal.com/v1/oauth2/token

• 正式环境https://api.paypal.com/v1/oauth2/token

所需的 clientId 和 Secret 可从您的 PayPal 账号中获取。

curl -v -X POST https://api-m.sandbox.paypal.com/v1/catalogs/products \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <Access-Token>" \
-H "PayPal-Request-Id: PRODUCT-18062020-001" \
-d '{
  "name": "Video Streaming Service",
  "description": "Video streaming service",
  "type": "SERVICE",
  "category": "SOFTWARE",
  "image_url": "https://example.com/streaming.jpg",
  "home_url": "https://example.com/home"
}'

• name：产品名称

• description：产品描述

• type：产品类型（PHYSICAL、DIGITAL 或 SERVICE）

• category：产品分类

• image_url：产品图片地址

• home_url：产品主页地址

curl -v -X POST https://api-m.sandbox.paypal.com/v1/billing/plans \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <Access-Token>" \
-H "PayPal-Request-Id: PLAN-18062019-001" \
-d '{
  "product_id": "PROD-XXCD1234QWER65782",
  "name": "Video Streaming Service Plan",
  "description": "Basic plan for video streaming",
  "status": "ACTIVE",
  "billing_cycles": [
    {
      "frequency": {
        "interval_unit": "MONTH",
        "interval_count": 1
      },
      "tenure_type": "REGULAR",
      "sequence": 1,
      "total_cycles": 12,
      "pricing_scheme": {
        "fixed_price": {
          "value": "6",
          "currency_code": "USD"
        }
      }
    }
  ],
  "payment_preferences": {
    "auto_bill_outstanding": true,
    "setup_fee": {
      "value": "6",
      "currency_code": "USD"
    },
    "setup_fee_failure_action": "CONTINUE",
    "payment_failure_threshold": 3
  },
  "taxes": {
    "percentage": "0",
    "inclusive": false
  }
}'

• product_id：产品 ID

• name：订阅计划名称

• status：计划状态（ACTIVE 激活）

• billing_cycles：计费周期配置，支持试用与常规周期

  • interval_unit：计费周期单位（DAY、WEEK、MONTH、YEAR）

  • interval_count：每个周期的时间间隔

  • pricing_scheme：定价配置

• payment_preferences：付款偏好配置

  • setup_fee：设置费用

  • payment_failure_threshold：付款失败后暂停订阅的阈值

curl -v -X POST https://api-m.sandbox.paypal.com/v1/billing/subscriptions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <Access-Token>" \
-H "PayPal-Request-Id: SUBSCRIPTION-21092019-001" \
-d '{
  "plan_id": "P-5ML4271244454362WXNWU5NQ",
  "start_time": "2025-07-21T00:00:00Z",
  "quantity": "20",
  "application_context": {
    "brand_name": "Your Brand",
    "locale": "en-US",
    "shipping_preference": "SET_PROVIDED_ADDRESS",
    "user_action": "SUBSCRIBE_NOW",
    "return_url": "https://example.com/returnUrl",
    "cancel_url": "https://example.com/cancelUrl"
  }
}'

• plan_id：订阅计划 ID

• start_time：订阅开始时间（ISO8601 格式）

• quantity：订阅商品数量

• application_context：用户体验配置

  • return_url：支付成功回调地址

  • cancel_url：支付取消回调地址

完成后，通过响应结果中的 links.href，即可跳转到支付订阅页面。

使用 WebHook 接收订阅事件通知：

1. 登录 PayPal 开发者后台。

2. 创建新的 WebHook，并设置监听的事件类型。

3. 确保回调地址可以处理事件响应。

通过以上流程，您可以轻松完成 PayPal 产品和订阅计划的配置，并通过 API 实现自动化操作。如果您需要订阅海外服务，推荐使用虚拟信用卡 WildCard，操作简单，支付便捷。

☞ WildCard | 一分钟注册，轻松订阅海外线上服务

使用邀请码：ACCPAY，立享 0 手续费优惠，支持支付宝充值，随时提现！