Deprecation Notice: /products v.2021-01

Recharge plans to deprecate the /products endpoint (v.2021-01) by June 30, 2025. It is recommended to use the /plans endpoint (v.2021-11) instead to achieve equivalent functionality and take advantage of improved flexibility.

📘

Platform

• Shopify Checkout Integration
• Migrated Shopify Checkout Integration
• BigCommerce Checkout Integration
• Custom

Benefits of using /2021-11/plans

The /plans endpoint decouples product setup from subscription logic, allowing you to create more robust and flexible plans.

Benefits include:

• Support for multiple discount types
• Ability to set different frequency units
• Plan creation and updates through dedicated endpoints
• Bulk operations for plan management

Replace /products calls with /plans

Use the following replacements when migrating to /plans:

Check if a product supports subscriptions or onetime purchases

To check purchase options using /plans, send a request with the external product ID:

GET /2021-11/plans?external_product_id={product_id}

Review the "type" field in each plan object. Values include:

• onetime
• subscription

Example response

{
  "plans": [
    {
      "id": 15417753,
      "title": "2 month subscription with 30% discount",
      "type": "subscription"
    },
    {
      "id": 15417752,
      "title": "1 month subscription with 10% discount",
      "type": "subscription"
    },
    {
      "id": 15415637,
      "title": "Sauce",
      "type": "onetime"
    }
  ]
}