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.

  • An import file with the subscription information listed below.

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.

*Please use the sample file as a template. The columns must be in the correct order and use the exact labels.

We offer the import service as a free courtesy, but our support team cannot modify the file you send us. Please ensure it matches the formatting exactly, or we will be unable to import it. If you have any questions about the formatting, please contact our support team, and we would be glad to help.

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

*Alternatively, you can use the column name customer_email and provide the email address instead*

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 (enter zero for free shipping/digital products)

delivery_first_name

String

Optional / Required for delivery

John

Delivery address: first name

delivery_last_name

String

Optional

Smith

Delivery address: last name

delivery_address_1

String

Optional / Required for delivery

555 Beverly Hills

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

delivery_address_2

String

Optional / Required for delivery

Apartment 123

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

delivery_province_code

String

Optional / Required for delivery

CA

Delivery address: two-letter code for the region

delivery_city

String

Optional / Required for delivery

Los Angeles

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

delivery_zip

String

Optional / Required for delivery

55555

Delivery address: zip or postal code

delivery_country_code

String

Optional / Required for delivery

US

Delivery address: two-letter country code

delivery_phone

String

Optional / Required for delivery

+16135551111

Delivery address: phone number formatted using E.164 standard

delivery_company

String

Optional

PayWhirl

Delivery address: company or organization

line_0_variant_id

Variant ID - first line item

Required

32500008190026

Line item: Shopify ID of the product variant

line_0_quantity

Integer

Required

1

Line item: quantity of the product

line_0_price

String

Required

12.34

Line item: the price of the product

line_1_variant_id

Variant ID - first line item

Optional / Required for multiple line items

32500008190026

Line item: Shopify ID of the product variant

line_1_quantity

Integer

Optional / Required for multiple line items

1

Line item: quantity of the product

line_1_price

String

Optional / Required for multiple line items

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.

The delivery fields are technically optional, but all must be filled out for delivery to work. If you create a digital subscription or other non-physical product, please leave them all blank.

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

Sincerely,

The PayWhirl Team

Did this answer your question?