Skip to main content

Overview

You can charge two one-time amounts when a customer starts a subscription:
  • Setup fee: a charge you keep, for example to cover preparing the item.
  • Deposit: money you hold while the customer has the item. You choose whether it’s refundable.
Both are charged at checkout, on the same order as the subscription, so the customer sees them in the cart and at checkout before paying.

Turn a fee on

  1. In circuly, go to Settings > Fees.
  2. Tick Enable setup fee or Enable deposit fee and enter the amount in your store currency.
  3. Click Save fees.
The first time you turn a fee on, Shopify asks you to let circuly publish products and run checks at checkout. Approve both: each fee is added to the cart as a product, which the cart only accepts once it’s published to your Online Store, and the fee check below needs the second permission. circuly then creates a Setup fee or Deposit product in your store. It’s hidden from your store search, tagged circuly-fee, and doesn’t need shipping.

What the customer sees

When a customer clicks the add to cart button on the circuly product block with a subscription selected:
  • the setup fee and the deposit are added to the cart as their own lines, next to the subscription
  • the block lists each fee and includes them in First payment today
The setup fee is charged once per order. A second subscription added to the same cart doesn’t add it again. The deposit is charged once per subscription in the cart, so two subscriptions each bring their own deposit, and each one is refunded when its own subscription ends. In other markets, Shopify converts the fee amount into the local currency, the same way it converts your subscription prices.

The fee check at checkout

While a fee is on, circuly checks every checkout. If a subscription in the cart is missing its deposit or the cart is missing its setup fee, for example because the customer removed the line, checkout stops with one of these messages:
A subscription in your cart is missing its deposit. Remove the subscription and add it again from its product page.
A subscription in your cart is missing its setup fee. Remove the subscription and add it again from its product page.
The customer removes the subscription and adds it again with the circuly product block, which adds the fees back. German checkouts show the messages in German. If you lower a plan’s deposit, carts that already hold the higher deposit still check out. If you raise it, a cart holding the lower deposit is stopped until the customer adds the subscription again. The check covers subscriptions added by the circuly product block and its cross-sell rows. It doesn’t apply to point of sale, to bundles, or to plans that charge no deposit. If the check itself fails to run, checkout goes ahead as normal. The check also stops a subscription added with your theme’s own Add to cart or Buy it now button, because those never add the fees.

Add a missing fee back automatically

circuly can put a missing fee back in the cart as the customer heads to checkout, so they never see the messages above. When they click your theme’s checkout button, circuly adds each missing deposit (at the plan’s current amount, replacing one that is too small after you raised it) and the setup fee, then continues to checkout. This already works in the cart drawer on product pages that show the circuly product block. To make it work everywhere, including the cart page:
  1. In Settings > Fees, with a fee on, click Open the theme editor in the “Turn on circuly fee check” box.
  2. In the theme editor, check that circuly fee check is switched on under App embeds.
  3. Click Save.
Express checkout buttons in the cart, such as Shop Pay or Apple Pay, skip it. A customer who uses one with a fee missing still sees the message. Buy it now on the product page goes straight to checkout too, so turn on Hide the theme’s buy buttons in the block settings.

A different deposit per plan

The amount in Settings > Fees is the store default. A subscription plan can charge its own deposit instead:
  1. Open the plan under Subscriptions > Plans and go to the Configuration tab.
  2. In Deposit, enter the amount for this plan, or 0 for no deposit on this plan.
  3. Save the plan.
Leave the field empty to go back to the store default. The product block shows the deposit of the plan the customer picks, and the deposit changes when they switch plans. Turning the deposit fee off in Settings > Fees stops every deposit, whatever the plans say.

Change the name, tax or translation

The fee products are regular Shopify products. To rename one, change its tax settings or translate it, open it from the link under the amount in Settings > Fees and edit it in Shopify. circuly only changes the setup fee product’s price, when you save a new amount, and each product’s status, when you turn the fee on or off. The Deposit product keeps one variant per amount you have used, named after the amount, because orders already placed keep pointing at the variant they were bought with. circuly adds variants and never removes them. Leave them in place: deleting a variant breaks the refund of the deposits bought with it. The setup fee starts as taxable. The deposit starts as not taxable, because it’s money you hold rather than a sale.

Deposit refunds

If Refundable deposit is on, circuly refunds the deposit when the subscription ends normally. For rentals and bundles that’s when you confirm the return, whether the customer or you cancelled it. For other subscription types it’s when the subscription is cancelled. If a customer’s order starts more than one subscription, the deposit belongs to the first of them. Refund method decides how the money comes back:
  • Store credit: the deposit is added to the customer’s circuly store credit and applied to their next invoice. This is the default.
  • Original payment method: circuly refunds the Deposit line of the original order through Shopify, so the money goes back to the card or account the customer paid with. The refund shows on the order in your Shopify admin, and Shopify emails the customer a refund confirmation.
A refund to the original payment method can fail, for example when the payment provider no longer allows refunds on an old order. If nothing has been refunded on that order yet, circuly issues the deposit as store credit instead and notes it on the subscription’s timeline, so the customer never waits on a refund that cannot happen. If the order already carries a refund, circuly does not add store credit, because that refund may already have returned the deposit. The timeline then asks you to refund the deposit by hand. Check with your payment provider how long after the order a refund is still possible.

What the customer sees in their account

The subscription details in the customer account list the setup fee and the deposit under the price, and say whether the deposit is refundable, how it comes back and when. Once the deposit is refunded, the row says so. When the customer cancels or returns, the confirmation repeats what happens to their deposit.

Turn a fee off

Untick the fee and click Save fees. The fee product is set to draft, so it stops being added to carts and can’t be bought. circuly keeps the product, so turning the fee back on reuses it.

Limitations

  • Fees are only added by the circuly product block. A subscription added another way, such as your theme’s own Buy it now button, is sold without them. To avoid this, turn on Hide the theme’s buy buttons in the block settings.
  • Customers can remove a fee line from their cart before checkout, like any other product. A missing fee stops checkout, as described in The fee check at checkout.
  • The fee check also runs on draft orders. A subscription draft order you create yourself needs a line of the Deposit product at that plan’s amount and a Setup fee line, or Shopify won’t complete it.
  • If the subscription is removed from the cart, the fee lines stay until the customer removes them.