Convert to purchase

Convert to purchase turns an active cycle into a sale. The item is marked as sold, the cycle stops, and any upcoming cycles on that item move to alternative stock. Use it when a customer decides to keep something they’re renting.

How it works

A cycle can be converted while it’s out with the customer and nothing has come back yet. Supercycle allows it when all of these are true:

The cycle has been fulfilled but not yet received back.
The receival has exactly one rental on it.
Any upcoming cycles on the same item have alternative stock to move to.

If one of them isn’t met, the Convert to purchase modal shows the reason and blocks the action. The suggested charge is the convert to purchase price. By default that’s the item’s resale price minus what the customer has already paid on the cycle, never less than zero. Where the product has no resale price, the modal shows the retail price in its place and leaves the suggestion empty.

Convert a cycle to a purchase

Open the cycle

From Cycles, open the cycle to convert.

Select Convert to purchase

On the receival card, select Convert to purchase. It sits next to Create return.

Select Convert to purchase on the receival card, then confirm in the modal.

Review the charge

The modal shows the Resale price, the Paid total across the cycle’s rental charges, and the Suggested charge between them. Charge amount is prefilled with the suggestion from your convert to purchase price. Change it to charge something else, or clear it to convert without a charge.

Review upcoming cycles

Any upcoming cycles on the item are listed. They’re reallocated to alternative items when you confirm.

Confirm

Select Convert to purchase.

On confirmation, Supercycle creates the charge if the amount is above zero, marks the item as sold so it can’t be booked again, ends the cycle and clears its return dates, cancels the subscription if the cycle is on one, reallocates upcoming cycles on the item, and logs a Converted to sale event on the timeline.

Let customers convert to purchase Beta

You can let customers convert their own rentals from customer accounts.

Open Customer accounts settings

Go to Customer accounts.

Turn on the setting

Turn on Customers can convert to purchase, then select Save.

What the customer sees

Eligible rentals carry a Purchase this item button on the rental page in customer accounts. Selecting it opens a summary of the resale value, what the customer has already paid, and what they pay today. When they confirm, the cycle converts and the outstanding balance appears under Payments for them to pay.

Select Purchase this item, then confirm in the modal to see the converted rental.

The button appears only when the suggested charge can be calculated: the product has a resale price, or your convert to purchase price formula returns an amount. The eligibility rules are the same as the admin flow.

Return item reminder email

When convert to purchase is on for customers, the return item reminder email carries a Complete your purchase button for each eligible rental on that reminder. The button runs the same eligibility checks and links the customer to their account rental page to finish. Rentals that aren’t eligible show the usual reminder content without the button.

Convert to purchase price

The convert to purchase price is the charge Supercycle suggests when a cycle is converted. By default it’s the item’s resale price minus what the customer has already paid. You can replace that with a Liquid formula that reads the resale price, the retail price, what’s been paid, and the cycle’s and item’s fields, so the price can follow your own rent-to-own rules. Set it under Customer accounts. The setting prices every conversion, including ones you make from the cycle page in the admin, whether or not customers can convert from their account.

Pricing modes

The Convert to purchase price selector has two modes.

Mode	What it does
Resale price minus paid	The resale price for the cycle’s variant, minus the total paid on the cycle, never less than zero. Cycles whose product has no resale price are left unpriced. This is the default.
Formula	A Liquid expression that returns the amount in cents. Runs against the resale price, the retail price, what’s been paid, and the cycle and item.

In either mode the suggestion prefills Charge amount on the admin’s Convert to purchase modal, where you can still change or clear it. In customer accounts it’s the amount the customer pays, and a rental with no price can’t be converted by the customer.

Set the price

Open Customer accounts settings

Go to Customer accounts.

Choose a pricing mode

Under Cycle actions, set Convert to purchase price to Resale price minus paid or Formula.

Enter the formula

With Formula selected, a Price formula field appears. Enter a Liquid formula that renders the amount in cents. Select a tag under Example fields to insert that variable at the end of the formula.

Save

Select Save in the save bar. A formula that can’t be parsed isn’t saved, and the error appears under Price formula.

Changing the mode or the formula affects conversions from then on. A cycle that has already been converted keeps the charge it was converted with.

Rules

The formula must render a number of cents. A $60.00 price is written as 6000. The result is rounded to the nearest cent, and a negative result becomes 0.
Money values are in cents throughout the formula context.
Formulas run in strict mode. Referencing a variable that doesn’t exist makes the formula fail.
A formula that fails, or that renders something that isn’t a number, leaves the conversion unpriced. Supercycle logs the error. In the admin, Charge amount is left empty for you to fill in. In customer accounts, the Purchase this item button is hidden.

Variables

The Price formula field lists clickable tags you can insert into the formula.

Variable	What it holds
`resale_price`	The checkout price of the product’s resale option for the cycle’s variant, in cents. Empty when the product has no resale option that includes the variant.
`retail_price`	The variant’s Shopify price, in cents. `0` when the cycle has no variant.
`paid`	The total paid across the cycle’s charges, in cents.
`cycle.*`	Built-in cycle values, such as the schedule dates, `charges_paid`, `charges_due`, and `deposit_price`.
`item.*`	Built-in item values, such as `completed_cycles`, `acquisition_cost`, `lifecycle_revenue`, and `variant.price`.
`cycle.fields.*`	Custom and calculated fields on the cycle, by key.
`item.fields.*`	Custom and calculated fields on the item, by key.

The cycle.* and item.* values are the same system fields available to calculated fields, and the Liquid basics on that page apply here too.

Examples

The default, written as a formula:

Resale price minus paid

{{ resale_price | minus: paid }}

Fall back to the retail price when the product has no resale option, so every cycle can be converted:

Retail price when there's no resale price

{{ resale_price | default: retail_price | minus: paid }}

Sell at the retail price and credit half of the rent paid so far:

Credit half the rent

{% assign credit = paid | divided_by: 2 %}
{{ retail_price | minus: credit }}

Price from what the item cost you, with a margin that shrinks once the item has earned its keep:

Margin on acquisition cost

{% if item.completed_cycles >= 5 %}
  {{ item.acquisition_cost | times: 1.1 | round }}
{% else %}
  {{ item.acquisition_cost | times: 1.5 | round }}
{% endif %}

Read a buyout price you’ve stored on the item as a money custom field with the key buyout_price, minus what’s been paid:

Per-item buyout price

{{ item.fields.buyout_price | default: retail_price | minus: paid }}

Products without a resale price

In Resale price minus paid mode, a cycle whose product has no resale option for its variant has no suggested price. The admin modal shows the Retail price in place of the resale price and leaves Charge amount empty, and the customer can’t convert from their account. A formula that doesn’t depend on resale_price, or that falls back with default, prices those cycles too.

Testing a formula

There’s no preview for the convert to purchase price. To check a formula, open Convert to purchase on a cycle you know the values for and compare the Suggested charge with what you expect, then close the modal without confirming.

Convert to purchase FAQs

Can I convert a cycle that's already been received?

No. Once a receival is marked as received, the cycle can’t be converted. Handle it as a new sale order in Shopify instead.

What happens to upcoming cycles on the same item?

Supercycle reallocates them to other available items of the same variant. If one of them has no alternative stock, the conversion is blocked and Supercycle names the cycle that can’t be reallocated.

Does converting to purchase refund earlier rental charges?

No. Earlier charges stay on the cycle. Charge amount is the extra the customer pays to keep the item, not an adjustment to what they’ve already paid.

Can I convert without charging the customer?

Yes. Leave Charge amount blank to convert without creating a charge.

What does the customer see when the formula fails?

The rental shows no Purchase this item button, the same as a product with no resale price in the default mode. You can still convert the cycle from the admin by entering a Charge amount yourself.

Is the formula rerun on cycles that were already converted?

No. The charge is created at the moment of conversion with the amount shown in the modal. Changing the formula later only changes the suggestion for future conversions.

Overview

Setup

Methods

Manage

Sales channels

Configuration

How it works

Convert a cycle to a purchase

Let customers convert to purchase Beta

What the customer sees

Return item reminder email

Convert to purchase price

Pricing modes

Set the price

Rules

Variables

Examples

Products without a resale price

Testing a formula

Convert to purchase FAQs

​How it works

​Convert a cycle to a purchase

​Let customers convert to purchase Beta

​What the customer sees

​Return item reminder email

​Convert to purchase price

​Pricing modes

​Set the price

​Rules

​Variables

​Examples

​Products without a resale price

​Testing a formula

​Convert to purchase FAQs

How it works

Convert a cycle to a purchase

Let customers convert to purchase Beta

What the customer sees

Return item reminder email

Convert to purchase price

Pricing modes

Set the price

Rules

Variables

Examples

Products without a resale price

Testing a formula

Convert to purchase FAQs