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.
Turn a fee on
- In circuly, go to Settings > Fees.
- Tick Enable setup fee or Enable deposit fee and enter the amount in your store currency.
- Click Save fees.
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 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:- In Settings > Fees, with a fee on, click Open the theme editor in the “Turn on circuly fee check” box.
- In the theme editor, check that circuly fee check is switched on under App embeds.
- Click Save.
A different deposit per plan
The amount in Settings > Fees is the store default. A subscription plan can charge its own deposit instead:- Open the plan under Subscriptions > Plans and go to the Configuration tab.
- In Deposit, enter the amount for this plan, or 0 for no deposit on this plan.
- Save the plan.
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.
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.