Products
Products are the items tied to a subscription in Recharge.
Understanding products
In Recharge, products are items associated with subscriptions. If you are using an external product catalog, such as Shopify or BigCommerce, the Product contains details about the time in that catalog. You can customize the charge frequency, or specify the billing date each month, as well as other attributes, within the product resource.
The following table details which scopes are required to read and write the Products record.
Scope | Description |
---|---|
read_products | Required to read products record. |
write_products | Required to write to the products record. |
"Product catalog" versus Products endpoint
The Recharge product catalog is where data about each item in the external catalog is stored within Recharge. For direct integrations, such as Shopify and BigCommerce, Recharge seamlessly retrieves details like price, variant, SKU, and more into the product catalog when a user creates a product in the merchant portal. However, if you're integrating via the Recharge API, you'll need to input your inventory into the product catalog manually.
The products endpoint contains the subscription settings associated to a catalog product.
Subscriptions and products
After adding a product to the Recharge catalog, you can create subscription rules or product subscription plans, depending on your setup. Although you can create products by passing the collection_id
, it is not recommended.
Set the following fields when creating products via API, as rulesets will one day be deprecated. The following fields are required: charge_interval_frequency
, order_interval_frequency_options
, order_interval_unit
and storefront_purchase_options
.
Updated 6 months ago