IMPORTING SUBSCRIPTIONS IS CURRENTLY IN BETA. PLEASE LET US KNOW IF YOU HAVE ANY QUESTIONS ABOUT THE PROCESS.

If you are migrating to subscriptions to Shopify or switching to PayWhirl from another subscription app, we can help import your existing subscriptions and make the process seamless for your customers. Customers will not have to resubscribe or provide their payment information again.

Subscription Import Requirements

  • You are using a gateway that works with Shopify subscriptions (Stripe, Shopify Payments, Authorize.net, PayPal express, etc.)

  • You have already imported your customers into Shopify and their payment methods. If not, please review this article for instructions.

We've created a migration tool to assist with the process. In a nutshell, you fill out a spreadsheet with all the required information (see the table and sample file below), then send it to our team, and we'll import the file to create the subscriptions.

Column name

Type

Required

Example

Description

source_id

String

Required

1234567

Unique ID in the legacy system, required to avoid importing the same subscription more than once

customer_id

Customer ID

Required

2930896994378

Shopify ID of the customer

next_order_date

DateTime

Required

2021-12-15T12:30:00

Timestamp of the next order date. If it doesn't contain an explicit timezone, UTC is assumed

currency

String

Required

USD

3-letter currency code

payment_method_id

Payment Method ID

Optional

e7219f3b896e813799ec786bdd5ecd70

Shopify ID of the preferred payment method. If empty, we'll try to use the latest active payment method of the customer

billing_interval_type

Interval Type

Required

year

Type of the billing interval [year, month, week, day]

billing_interval_count

Integer

Required

3

The number of intervals between billings

delivery_interval_count

Integer

Optional

1

The number of intervals between deliveries (only required for pre-paids)

billing_min_cycles

Integer

Optional

10

Min amount of billings before the customer can cancel

billing_max_cycles

Integer

Optional

20

Max amount of billings after which the subscription expires

finishing_behavior

Finishing Behavior

Optional

immediately

Finishing behavior [immediately, end-of-cycle]

delivery_price

Decimal

Required

5.99

Delivery price

delivery_first_name

String

Optional

John

Delivery address: first name

delivery_last_name

String

Required

Smith

Delivery address: last name

delivery_address_1

String

Required

555 Beverly Hills

Delivery address: first-line, typically the street address or PO Box number

delivery_address_2

String

Optional

Apartment 123

Delivery address: second line, typically the number of the apartment, suite, or unit

delivery_province_code

String

Required

CA

Delivery address: two-letter code for the region

delivery_city

String

Required

Los Angeles

Delivery address: name of the city, district, village, or town

delivery_zip

String

Required

55555

Delivery address: zip or postal code

delivery_country_code

String

Required

US

Delivery address: two-letter country code

delivery_phone

String

Optional

+16135551111

Delivery address: phone number formatted using E.164 standard

delivery_company

String

Optional

PayWhirl

Delivery address: company or organization

line_<i>_variant_id

Variant ID

Required

32500008190026

Line item: Shopify ID of the product variant

line_<i>_quantity

Integer

Required

1

Line item: quantity of the product

line_<i>_price

String

Required

12.34

Line item: the price of the product


Once you have prepared your import file, please reach out to our team so we can review the data and work with you to ensure a successful subscription migration to Shopify / PayWhirl.

Please note that importing subscriptions is currently in BETA, so there could be unexpected issues or delays during the migration process. Our team is here to help!

Please let us know if you have any questions or concerns.

Sincerely,

The PayWhirl Team

Did this answer your question?