Import Subscriptions

We are pleased to inform that we can transfer subscriptions that you had in another app.

To do this, please send us a csv file following this rules.

Mandatory fields:

customer_id - Shopify’s customer ID

next_billing_date - the date of the next payment; if the date is in the past, the current date + one billing interval will be used.

currency_code - currency code, e.g., USD, EUR, etc. If not specified, EUR will be used by default.

status - value "ACTIVE" if the subscription should be created as Active, and an empty value if the subscription should be Paused.

interval_number - a number representing the quantity of days (DAY), weeks (WEEK), months (MONTH), or years (YEAR) defining the subscription payment period.

interval_type - sets the type of interval: DAY|MONTH|WEEK|YEAR.

product_id - Shopify’s product ID

variant_id - Shopify’s variant ID of the product

delivery_price - shipping cost

final_price - final product price after any discounts applied.

is_auto_charging - if the value is yes, on, or 1, the script will attempt to create an autocharge subscription; otherwise, or if left blank, an invoice subscription will be created.

shipping_first_name

shipping_last_name

shipping_address1

shipping_city

shipping_zip - must be valid, otherwise Shopify will return an error.

shipping_province - must be valid, otherwise Shopify will return an error.

shipping_province_code - must be valid, otherwise Shopify will return an error.

shipping_country - must be valid, otherwise Shopify will return an error.

shipping_country_code - must be valid, otherwise Shopify will return an error.

Optional fields (should be filled if the default value is not acceptable):

final_amount - total order cost considering the quantity of items. If not provided, the product of final_price quantity fields will be used.

order_placed_date - the date of the first order under the subscription; by default, the current date and time will be used.

last_order_date - the date of the last order under the subscription; by default, the current date and time will be used.

next_billing_date - the date of the next subscription payment; if the date is in the past or missing, the current date plus one billing interval will be used.

shipping_phone - must be valid, otherwise Shopify will return an error, but it can be omitted.

payment_method_id - Shopify’s payment method ID; if not provided, the script will attempt to retrieve it via an API request to Shopify using the customer data.

quantity - if not specified, the value 1 will be used.

Important Notes:

The customer_id , product_id , and variant_id are IDs obtained by the source application from Shopify, not the internal IDs of the application.

It's desirable to fill out as many fields as possible so that the application stores the data in a form as close as possible to the source application.

Key Points about ID Fields:

If the file format is CSV, ensure that numerical values such as product_id , variant_id , and customer_id have valid values and not something like 3.3844E+13.

Updated on: 11/03/2025