ops & tricks

What are you looking for?

Search instructions:

Search for a single terms or two-word term instead of a sentence. For example "subscriptions", "recurring payments", "webhooks" etc., instead of "how to start a subscription" or "where can I find recurring payments".
damn.
Sorry, but we couldn't find what you were looking for. Please try again with a different keyword or write us your question below - then we'll get our content ninjas right on it.

did not find what you were looking for?

We are constantly expanding and improving our knowledge loop to give you the information you need to make the best out of circuly.
You can request articles about features that you yet do not know how to best use.
Just tell us what you want to know and we’ll get our content ninjas right on it.

Fields marked with an asterisk (*) are required.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Email Templates
Email trigger

How are Different Emails Triggered in the circuly Hub?

Your customers get transactional emails from the circuly operation backend for pre-defined subscription operations. Each email has an email trigger attached to it. What are these triggers?

Introduction

circuly provides a comprehensive set of transactional email templates triggered by specific subscription lifecycle actions such as orders, payments, subscriptions, and returns. These emails are operational (not promotional) and can be customised to reflect your branding. Each email template is linked to a specific event, and when that event occurs, the email is automatically sent from the circuly Hub.

Important: circuly supports only transactional emails. For promotional content (like offers, discounts, or vouchers), use a marketing automation tool.

Email Template Categories and Triggers: Most of the email templates in circuly fall under four categories: Orders, Payments, Subscriptions, and Returns. A few templates fall outside these categories but are still essential.

Category: Account

Account - One-Time Password

The “One-Time Password” email is an email that is sent to your customer when the customer is logging in to the Customer Self- Service portal and requests a one-time password to log in.

The email that is sent to the customer (that is the "One time Password" email) contains a code and a link that can be used to sign in to the Self-Service Portal.

  • Trigger: When a customer requests login access to the Customer Portal.
  • Settings: Settings > Emails > Order notifications

Category: Orders

Order - Buyout Confirmation

The "Buyout Order Confirmation" email template is a confirmation sent to the customer for a buyout order. This email template informs the customer that the buyout request was processed from your side.

  • Trigger: When a customer chooses to buy out their subscribed product.
  • Settings: Settings > Emails > Order notifications
  • Note: Confirms the transaction to the customer.

Order - Cancellation

The "Order cancellation" is an email that is sent to the customer to inform them that their order has been cancelled.

  • Trigger: When an order is manually cancelled by a circuly user. 
  • Settings: Settings > Emails > Order notifications
  • Note: If "Fully refund this order" is checked, the customer will also receive the Transaction Refund and Refund Invoice.

Order - Confirmation

The "Order confirmation" email is sent to the customer when a customer goes through your checkout and finalises their order. This email is used to inform the customer that the order has been received by you and is being processed.

Note: A confirmation email will not be triggered from your shop system so as to avoid sending the confirmation email twice to the customer.

  • Trigger: When a customer places an order via the circuly checkout.
  • Settings: Settings > Emails > Order notifications
  • Note: Skip this email if your shop system already sends an order confirmation.

Order - Fulfilment Completed

The “Order Fulfilment Completed” email is sent to your customer to inform the customer that their order has been fulfilled (aka Shipped).

  • Trigger: When an order is manually marked as completed in the circuly Hub.
  • Settings: Settings > Emails > Order notifications

Order - Offer

The "Order Offer" is an email that contains the offer for a manually created order and has an quote attached to it. The quote that is attached in the "Order offer" email is created from the "Order offer pdf" email template.

  • Trigger: When a draft order is created manually from the circuly Hub.
  • Settings: Settings > Emails > Order notifications
  • Note: Email sent to the customer with a PDF attachment summarizing the order.

Order - Offer PDF

The "Order Offer pdf" is also a pdf invoice that is sent to the customer along with the "Order offer" email template.

  • Attachment: Sent with the "Order Offer" email.
  • Content: Includes order details, product, pricing, and subscription terms.

Order - Swap Confirmation

The "Swap confirmation" is an email that is sent to the customer when a product swap request is made. This email informs the customer that the request to replace the order has been received and is being processed.

  • Trigger: When a swap is initiated (manually or via the customer portal).
  • Settings: Settings > Emails > Subscription notifications

Category: Payments

Payment - Failed

The "Payment has failed" email is an email that is sent to the customer every time a payment (initial, recurring and one-time) fails. This email informs the customer that their payment has failed.

  • Trigger: When a payment attempt fails.
  • Settings: Settings > Emails > Payment notifications
  • Note: Payment retries are configurable in Settings > Recurring Payments. You can define retry attempts and intervals, and whether to send a failed email for each or just the final attempt.

Payment -  Invoice

The "Your Invoice" is an email that is sent to your customer when a payment is to be charged but hasn't been charged yet. This email template is used just to inform the customer about the upcoming charge.

The "Invoice" email requires an invoice and is therefore sent in combination with the "Invoice" email template, attached as a PDF (if it's a recurring payment) or with the "One-time transaction" email template, attached as a PDF (if it's a one-time payment).

  • Trigger: When a recurring or one-time payment is initiated (before charge).
  • Settings: Settings > Emails > Payment notifications
  • PDF Attachments: "Invoice" or "One-Time Transaction"
  • Legal Note (Germany): Include the variable {{current_period}} to show the "Leistungszeitraum" (service period). Use:

{% if initial_invoice == false %}

<p>Service period: {{current_period}}</p>

{% endif %}

Payment - Invoice (pdf)

The "Invoice" email template is simply an invoice that is sent as a PDF attachment in combination with emails that require an invoice.

Trigger: When an initial payment is successfully charged, the "Payment was successful" email is triggered. The "Payment was successful" email contains an invoice that is attached as PDF. For the PDF attachment the "Invoice" email template is triggered and used.

When a recurring payment is to be charged (on the upcoming billing date), the "Your Invoice" email template is triggered. The "Your Invoice" email contains an invoice that is attached as PDF. For the PDF attachment the "Invoice" email template is triggered and used.

Settings:

Payment - One-Time Transaction

The "One-time transaction" email template is also an invoice that is sent as a PDF attachment in combination with the "Your invoice" email to inform the customer that a one-time transaction will be charged from their saved payment method due to xyz reason.

  • Trigger: When a one-time transaction is charged.
  • Settings: Settings > Emails > Order notifications
  • Note: Sent with the "Your Invoice" email and includes the invoice as a PDF.

Payment - ‍Refund Invoice

Like the "Invoice" and "One-time transaction" email template, the "Refund Invoice" email template is simply an invoice that is sent to the customer in combination as a PDF attachment with the "Transaction refund" email template to inform the customer that a payment has been refunded.

  • Trigger: When a refund is processed, especially when "Fully refund this order" is checked during cancellation.
  • Settings: Settings > Emails > Payment notifications

Payment - Successful

The “Payment was successful” email is an email that is sent to your customer when a payment goes through or in other words is successfully charged.

  • Trigger: After a payment is successfully charged.
  • Settings: Settings > Emails > Payment notifications

Payment - Transaction Refund

The "Transaction Refund" is an email that is sent to the customer when a payment is refunded from the circuly Hub. The "Transaction Refund" email requires an invoice and is therefore sent in combination wih the "Refund Invoice" email template, attached as a PDF.

It is sent to the customer for both full and partial refunds.

  • Trigger: When a refund is manually processed.
  • Settings: Settings > Emails > Payment notifications
  • Note: Sent together with the "Refund Invoice" email.

—----

Return Unpaid Product

The "Return unpaid product" is an email that is sent to tell the customer that they need to return the product because there is an issue with their payment method and the payments cannot be charged after multiple payment attempts.

  • Trigger: After two full failed payment cycles.
  • Settings: Settings > Emails > Payment notifications
  • Note: Configure payment retry logic in Settings > Recurring Payments > Payment Tries & Intervals.

Category: Subscriptions

Subscription - Activated

The "Subscription activated" is an email that is sent to the customer to inform the customer that a subscription has been created and has started for their order. It also informs the customer that a recurring payment schedule has started and the payment will be deducted on the next billing date.

  • Trigger: On the subscription start date.
  • Settings: Settings > Emails > Subscription notifications
  • Note: Separate from Order Confirmation because fulfillment and start can be days/weeks apart.

Subscription - cancellation received

The "Subscription cancellation received" is an email that is sent to the customer to inform them that the request that they have made from the Customer Self Service portal to cancel the subscription has been received by you and is being processed.

  • Trigger: When your customer makes a cancellation request from the Customer Self-Service Portal. 
  • Settings: Settings > Emails > Subscription notifications

Subscription - Ended

The "Subscription has ended" is an email that is sent to the customer to inform them that their subscription has ended, the product has been received by you and the recurring payments will be stopped.

  • Trigger: When the product is marked as returned.
  • Settings: Settings > Emails > Subscription notifications

Subscription - Ending soon reminder

The "Subscription almost over" is an email that is sent to the customer x days before the subscription end date. This email informs the customer that their subscription is about to end.

Note: You can define the value for x in the Settings.

Note: The email is not triggered if the "Notify if auto renew is active" setting is disabled

  • Trigger: X days before the end date (customisable). This email is automatically triggered by the system based on the value in the "Days calculation before ending" setting.
  • Settings: Settings > Emails > Subscription notifications
  • Advanced Options:
    • Email only sends if auto-renew is OFF.
    • To send for short subscriptions (≤1 month), enable "Subscription is almost over for 1-month subscriptions".
    • To send even if auto-renew is ON, enable "Subscription is almost over also if auto-renew is active".

Subscription - Pending Return

The "Subscription pending return" is an email that is sent to the customer to inform them the return request has been received.

This email is normally manually triggered but can also be automated.

The "Subscription pending return" email can also be used to inform the customer about the return procedure for the product.

  • Trigger: When marked manually as "Pending Return" or when a customer cancels via the portal and auto-cancel is enabled.
  • Settings: Settings > Emails > Subscription notifications

Subscription - Reactivated

The "Subscription reactivated" is an email that is sent to the customer to inform the customer that their subscription has been reactivated.

  • Trigger:  When a circuly user manually reactivates a subscription from the circuly Hub by clicking on the Reactivate Subscription option. 
  • Settings: Settings > Emails > Subscription notifications

Subscription - Return Reminder

The "Return Reminder" email is sent to the customer to remind the customer that they need to return their subscription product as their subscription has ended and is pending return.

  • Trigger:  Triggered by the circuly system when the product has not been returned by the customer within the “Return until period”. If the product is returned however, the email is not triggered.  
  • Settings: Settings > Emails > Subscription notifications

Subscription - Return Unpaid Product

The "Return unpaid product" is an email that is sent to tell the customer that they need to return the product because there is an issue with their payment method and the payments cannot be charged after multiple payment attempts.

  • Trigger:  Triggered automatically by the circuly system when there has been “x” number of failed payment attempts already. 
  • Settings: Settings > Emails > Subscription notifications

Subscription - Swap Pending Return

Sent automatically when a customer requests a swap or when a swap is initiated manually by a circuly user. This email refers to the original product that is being swapped and is awaiting return.

  • Trigger:  Sent automatically when a customer requests a swap or when a swap is initiated manually by a circuly user. This email refers to the original product that is being swapped and is awaiting return. 
  • Settings: Settings > Emails > Subscription notifications

Category: Returns

Return Instruction

The "Return instruction" is an email template that is sent to the customer to inform them about how to return the subscription product.

  • Trigger: Sent manually by support or automatically after a cancellation request from the Customer Portal.
  • Settings: Settings > Emails > Subscription notifications > Return instructions

Other Emails

Refer a Friend

The "Refer a friend" is an email that is sent automatically when your customer use the Refer a friend feature in the Customer Self Service portal.

  • Trigger: When an existing customer uses the refer-a-friend feature via the Customer Portal and sends referral codes.
  • Settings: Not tied to the categories above but can be enabled in the Emails tab.
  • Note: Email is sent to the referred person when email addresses are added in the referral input field.

How to enable email templates

  1. Go to Settings > Emails
  2. Select the relevant tab: Orders, Payments, Subscriptions, or Returns
  3. Enable the switches for the email types you wish to activate

How to edit email templates

Follow this guide to learn more about setting up email templates.

circuly’s transactional email system ensures customers are notified clearly and promptly at each step of their subscription journey. With full template customisation and precise triggers, you maintain control over your brand voice while meeting compliance standards like invoice formatting. 

Read more
Customers
Merge customer profiles

Merge Customer Profiles

Learn how to merge customers in circuly to clean up duplicate profiles by transferring subscriptions, payments, orders, and more—plus important notes on this irreversible process.

Introduction

The Merge Customers functionality in circuly allows you to combine duplicate or related customer profiles by transferring all data from one customer (the source) into another (the target). This is useful for keeping your customer database clean and ensuring all subscriptions, orders, and transactions are linked to the correct customer profile.

Important: Merging customers is a destructive and irreversible action. Once merged, the original (source) customer profile will no longer hold any data — everything will be moved to the target customer.

Feature Overview

  • What gets transferred:
    When merging, all subscriptions, transactions, orders, payment methods, notes, and product trackings from the source customer are moved to the target customer.
  • Why use this:
    This feature helps maintain accurate customer records by consolidating duplicate accounts or customer profiles with errors, ensuring reporting and future customer interactions are based on complete data.
  • One-way and final:
    Once you confirm the merge, the action cannot be undone. Be sure to double-check your selection before proceeding.

Step-by-Step Guide

How to merge customer data

  • Navigate to the Customers tab in the circuly Hub and find the customer you want to merge (this will be your source customer).
  • Click on the customer to open the Customer Overview window.
  • Click on the three dots in the upper right corner to open the action menu.
  • Select Transfer customer data from the list of options.
  • In the Transfer customer data window:
    • Use the search input field to find and select the target customer (the customer profile into which the data will be merged).
  • Read the warning carefully, then check the box that says "I understand the consequences."
  • Click Confirm to complete the merge.

All subscriptions, transactions, orders, payment methods, notes, and product trackings from the source customer will now be transferred to the target customer profile.

Read more
Invoices
Export invoice data

Exporting Invoice Line Items in Circuly

Learn how to export invoice line items in circuly for detailed revenue and product analysis.

Introduction

Previously, when exporting invoices from circuly, you could only export the summary data — that is, whatever was displayed in the invoice list under the various column headings. This made it difficult to perform deeper revenue or product-level analysis.

Now, circuly makes it possible to export invoice line items directly. This means you can analyse your data in far greater detail — for example, by SKU, product type, or any other details included in an invoice line item.

Note: This feature is only available for invoices created in 2025 or later.

Feature Overview

With invoice line item exports, you can:

  • Perform detailed revenue analysis: Break down invoices by individual items, SKUs, and more.
  • Support advanced reporting needs: Use the data for deeper accounting, profitability, or inventory insights.
  • Choose between exports and webhooks: Download a CSV when needed, or automate data delivery through a webhook directly into your systems.

Step-by-Step Guide

1. Export invoice line items via CSV

How to export

  • In the circuly Hub, navigate to the Invoices tab.
  • Select the invoices you want to export by checking the boxes next to them.
  • Click on the Export button.
  • In the Export Data window, check the option “Export invoice line items only.”
  • Once your export is processed, you’ll receive a notification under the bell icon in the circuly Hub.
  • Click on the notification to download your CSV file.

2. Automate data exports with webhooks

If you’d like to receive invoice line item data automatically — without manually exporting every time — you can use circuly’s webhook functionality.

How to set up the webhook

  • Go to the Webhooks tab in the circuly Hub.
  • Click on Create Webhook.
  • Under Event Type, select the new option “Invoice with Items.”
  • Continue the usual steps to configure your webhook, setting the destination URL where you want the data to be sent.

As with any webhook, data will be pushed to the destination URL whenever the event is triggered.

Read more
Debt Collection

Debt Collection & Dunning in circuly: circuly x Debtist Integration.

circuly has partnered with Debtist to offer automated collection of unpaid invoices natively within circuly. Learn more

Introduction

Subscription-based business models have an increased exposure to payment failure due to the recurring nature of the business. Effective and efficient dunning and debt collection is needed at all costs but can often be messy, frustrating and time-consuming. Additionally, since Inkasso processes typically operate offline, they result in unsynchronised data and cumbersome post-collection tasks, like manually entering information into bookkeeping systems and other needed platforms. 

To solve this problem, circuly has partnered with Debtist to offer debt collection natively within circuly so that you can save your time, nerves, internal resources and lost revenue. 

Benefits on a native solution

A native integration for debt collection, offers the following benefits:

  • Automated processes eliminate manual workload and errors.
  • Expert communication and professional expertise eliminate misunderstandings and maintain consistent communication with your customers. 
  • Automated synchronisation of data between circuly and Debtist keeps data clean and ready for bookkeeping. 
  • Available within circuly in an easy-to-understand dashboard that eliminates the need to work in two systems. 

Integration Overview

Our new debt collection feature (powered by Debtist) enables you to recover lost revenue easily and professionally, thus improving your bottom-line cash flow while eliminating the need to allocate additional time or human resources to manage unpaid invoices. The native integration ensures that you have a full and detailed overview within circuly of all your unpaid payments that Debtist is currently handling. 

Additionally, our native debt collection integration eliminates the need for maintaining and checking two different systems and ensure that you have all the information you need in one system, that is circuly. The two systems speak with each other seamlessly to provide you a smooth and consistent user experience and clean data for bookkeeping purposes. 

Process overview

Once you have enabled the integration and completed the setup, all unpaid invoices will be transferred to the Debt Collection tab for collection by Debtist as soon as the maximum number of payment retrials have been made. Debtist then works fully automated to bring the unpaid invoices to a resolution. 

- Step 1: Regular payment collection. 

circuly collects recurring payments according to the defined schedule. If the payment is successfully collected, you’ll see its status marked as “settled." If it fails, you’ll see its status marked as “failed.” 

- Step 2: Payment retrial and email communication.

When a payment fails, the circuly system retries the failed payment according to your payment retrial settings and sends the “payment failure” email. 

IMPORTANT: In the circuly operations backend, you can define how many times a payment should be retried, what should be the time interval between each attempt and if the customer should be informed on each attempt or only on the final attempt. 

- Step 3: Maximum payment retrial attempts made. 

As soon as circuly has made the last payment retrial attempt and if the payment still has the “failed” status, the payment and the connected invoice are transferred to the Debt Collection tab. The payment is also assigned the status "in debt collection" to indicate that the connected invoice and payment are in the debt collection process.

 

- Step 4: Prejudicial debt collection by Debtist

When an invoice is transferred to the debt collection tab, it is also transferred to Debtist for debt collection. Debtist then starts with the pre-judicial collection process via email and/or letter and other communication channels to obtain the particle or full payment. 

90% of the unpaid invoices come to a resolution in the prejudicial phase.

- Step 5: Judicial debt collection by Debtist

If the payment is still outstanding, Debtist begins judicial proceedings. At this stage, Debtist may get in touch with you if additional charges are to be incurred. 

IMPORTANT: Judicial proceedings typically involve additional costs. However Debtist will always get in touch with you before proceeding with any step that incurs additional charges for you so you can decide whether or not you'd like to proceed.

- Step 6: Debt Collected 

If the payment is successfully collected, the status will change from "in debt collection" to “debt collected” in your circuly Operations Backend.

See the image below for a process overview

Step-by-step setup guide

There are two steps to enabling and setting up the debt collection feature:

  1. Step 1: Send the activation request and create a Debtist account. 
  2. Step 2: Create a Debtist account.
  3. Step 3: Review the debt collection settings. Decide how you'd like to handle unpaid invoices for debt collection: automated or manual handover.

IMPORTANT: After you send the activation request, the debt collection feature will be activated on the 1st day of the month following your request.

For example, if you submit the activation request on August 15th, the debt collection feature will be automatically activated for your account on September 1st.

- Step 1: Send the activation request

  • In the left navigation bar, go to the Debt Collection tab

  • Click on the button that says ACTIVATE DEBT COLLECTION

A popup box will open where you can see the pricing list from Debtist and. The pricing list outlines the debt collection charges from Debtist for different countries. 

Additionally, you can read the privacy policy and terms & conditions. 

Click on the NEXT button to trigger the activation request and to start creating your Debtist account. 

- Step 2: Create a Debtist Account

  • In the Create your Debtist account window, add your details and click on the SUBMIT button.

What is the Max. Payment Plan Option?

When setting up your Debtist account, you can choose how your customers will repay their debt—either as a single payment or in multiple installments.

  • To require a one-time payment, simply enter "1" in the input field.
  • If you'd prefer to offer your debtors a flexible payment plan, enter the number of installments you're willing to accept, such as "2", "3", "4", and so on.

This option gives you control over how repayments are structured to suit both your needs and those of your customers.

Why is the IBAN needed?

Any payment collected by Debtist on your behalf is transferred to this account.

The debt collection feature will be activated on the 1st day of the month following your request. For example, if you submit the activation request on August 15th, the debt collection feature will be automatically activated for your account on September 1st.

- Step 3: Review the Debt collection settings

Once you've sent the activation request and created an account, go through the debt collection settings and decide how you'd like to hand over unpaid invoices for debt collection, that is manually or via the automated process.

In your circuly Operations Backend, head over to the Settings tab > Invoice & payment > Scroll down to DEBT COLLECTION to configure the settings associated with debt collection. 

  • Auto claim: enable the switch if you want to hand over the unpaid invoices when a payment fails automatically and has been retried x number of times (payment retrial settings) to Debtist for debt collection.
  • Delay by: set the number of days the circuly system should wait when a failed and retried payment is handed over for debt collection to Debtist. 

Overview of the Debt Collection tab: Post-Activation

In the beginning the Debt Collection tab will be empty (see image below).

You will see data as soon a payment has been retried by the circuly system as per your payment retrial settings and transferred to Debtist for Debt Collection. When there are some claims and invoices under the process of debt collection, this is how the Debt Collection tab will appear (see image)

Require action column

The require action column tells you whether there is any action needed from your side. When you see a GO TO ACTION tag under the Requires action column you can simply click on it to see what action is required. You can then add your decision as a comment and Debtist will proceed accordingly. You can even upload files if needed. See example image below.

Status column

The status column reflects the phase the unpaid invoice is in when it under the debt collection procedure.

Pricing 

A fixed fee of 49€ will be charged monthly upon activation for everything, including the integration + implementation + continued debt collection-*

*Additional costs may apply based on the region of debt collection. Additional costs are incurred ONLY IF the debt is successfully collected. There are no costs if the debt is not collected, that is if the claim is unsuccessful. 

 

Additional costs based on region

DACH
- no additional costs

Europe (excluding DACH) - 20% of the success claim

Outside Europe - 30% of the success claim 

Read more
Payments
Admin
Failed payment

Settings: Failed Payment Retrial

In the circuly operations backend you can define how many times a payment should be retried, what should be the time interval between each retry, should the customer be informed on each attempt or only on the final attempt and so on.

When managing subscriptions, failed recurring payments are a common challenge. The circuly system helps automate your response to these failures with flexible settings—allowing you to define retry logic, communication flows, and what actions to take if multiple payment attempts fail.

This article explains each of the settings available to manage failed payments, so you can configure a process that suits your operations.

Feature overview

In the circuly Hub, you can configure:

  • How many times a failed payment should be retried.
  • The time interval between each retry attempt.
  • How many days in the past circuly should check for unpaid payments.
  • Whether a subscription should be canceled after repeated failures.
  • Whether and when your customer should be notified of failed payment attempts.

Step 1: Configure payment retry settings

To access the settings:

Go to: Settings > Invoices & Payments > Failed Payment

Available options:

  • Maximum number of payment retries
    Defines how many times circuly should automatically retry a failed payment before requiring manual input.
  • Next payment attempt in
    Sets the time interval (in days) between each retry attempt.
  • Past billing date
    Defines how many days in the past circuly should look for missed recurring payments and attempt to retry them.
  • Example:
    If you set this value to -15, circuly will check for any unpaid recurring payments scheduled in the last 15 days and attempt to retry them based on your retry rules.
  • Cancel subscription on failure
    If enabled, the subscription is automatically canceled and moved to pending return status after two failed payment cycles.
    • A payment cycle refers to a single payment being retried up to the maximum number of times you’ve defined.
    • Two failed payment cycles mean two different payments have both failed, each having already gone through all retry attempts.

Learn more: What is a payment cycle?

Step 2: Configure email notifications for failed payments

To access the settings:

Go to: Settings > Emails > Payment Notifications

Available options:

  • All payment-related emails
    When enabled, circuly sends email notifications for both successful and failed payments using the associated email templates:
    • “Payment was successful”
    • “Payment has failed”
  • Failed payment – final attempt
    Sends a failed payment email only on the last retry attempt.
  • Failed payment – every attempt
    Sends a failed payment email after each retry attempt.
  • Terminal
    Sends the “Return unpaid product” email after two failed payment cycles.
    Make sure this template is activated in your Email Templates section.

Important: An email can only be sent if the corresponding template exists and is activated in the Email Templates tab.

Learn more here about how to retry a failed payment manually.

Read more
Orders
Subscriptions
Status. Order Status. Payment Status. Tags.

Explained: Status and Other Column in the circuly Hub

This article contains explanations for various values displayed under the different column headings in the circuly Operations Backend.

Possible status options and their explanation:

Orders tab > Orders List

Order Status Column

  • Open: Auto assigned by the circuly system when an order is placed on your connected white-label checkout or manually. This is typically the first status an order has unless the order is created in the circuly Operations Backend by using the draft order function; in this case, the order has "draft" as its first status. Typically, when an order has the "open" status, this means that there is no subscription attached to the order yet, or a subscription needs to be created for this order. When you create a subscription for an order, the status changes to fulfilled either automatically (setting that assigns the fulfilled status to an order upon subscription creation) or manually (when you use the "mark as fulfilled" action. If you do not manually or automatically assign the fulfilled status to an order, then the order will stay in the open state, even if there is a subscription attached to it. We recommend assigning the appropriate status to the order as this is the status that is visible to your customer in the self-service portal, and a wrong status might confuse your customers. Learn more about the fulfilled status.

    API Value: OPEN
    Shown to customer in the self-service portal: yes
  • Fulfilled: The fulfilled status is assigned to an order when a circuly user marks the order as fulfilled by clicking on the Mark as fulfilled option in the Order Action menu. The order status "fulfilled" is commonly used in e-commerce to indicate that the order has left the warehouse. It can also be automatically assigned when the fulfilment process is done, and you start the subscription when you assume that the product is delivered.

    API Value: FULFILLED
    Shown to customer in the self-service portal: yes
  • Cancelled: The cancelled status is assigned to an order when a circuly user cancels an order by clicking on the Cancel order option in the Order Action menu.

    API Value: CANCELLED
    Shown to customer in the self-service portal: yes
  • Draft: An order has the status "draft" when it is created in the circuly operations backend and does not originate from the checkout. An order has the "draft" status when the order is created in the backend, and the customer has not yet confirmed the order by completing the checkout. The status will change to "open" when the customer confirms the order and will be converted into a regular order (and be moved to the general order).

    API Value: DRAFT
    Shown to customer in the self-service portal: no

Payment Status Column

  • Payment Required: An order has the payment status as "payment required" when the initial payment has not been charged yet as a result of the "delayed charge" setting. In your settings you'll see the option to select a status that the order gets when the payment is delayed as a result of the "delayed charge" setting. The status indicates that the payment needs to be charged for this order and can either be done manually or will be automatically charged on subscription creation.

    Shown to customer in the self-service portal: no
  • Pending: An order has the payment status "pending" when the payment charge has been attempted but the payment hasnt been processed yet.

    Shown to customer in the self-service portal: no
  • Paid: An order has the payment status "paid" when the payment charge has been attempted and the payment has been successfully processed.

    Shown to customer in the self-service portal: no
  • Failed: An order has the payment status "failed" when the payment charge has been attempted but the payment has failed to process.

    Shown to customer in the self-service portal: no

Tags Column

Tags do not have a fixed definition and can be used based on the definition that has been defined internally. Tags need to be changed manually and have no automation behind them. They shall be used to communicate between users internally after agreeing on a fixed definition for the existing tags. They are not visible to your customer. Tags are not shown in any form to your customer.

Find more info regarding updating the tag via API here.

  • Delivered: The tag "delivered" signifies that the product has been delivered to the customer.
  • Delivery: The tag "delivery" signifies that the product is under delivery or to be delivered and is still in the logistics process.
  • In clarification: The tag "in clarification" signifies that there is an issue with the customer data and requires action. See notes for further information.
  • Lost: The tag "lost" signifies that the product attached to this subscription is lost and is not expected to come back.
  • Ordered at supplier: The tag "ordered at supplier" signifies that the product has been ordered at your supplier to be sent to your warehouse or directly to your customer.
  • Picked up: The tag "picked up" signifies that the product has already been picked up by the customer.
  • Pick up: The tag "pick up" signifies that the product needs to be picked up by the customer  e.g. if you have a store or if it has to be picked up at the refurbisher.
  • Replaced: An order has the "replaced" tag when the original product under the subscription has been replaced by another product.
  • Replacement: An order has the "replacement" tag when the order has to be replaced or is in the process of replacement.
  • Test order: Any order that has the "test order" tag is not a real order.


Origin Column

The origin information is not shown to the customer in any form.

  • Checkout: If the origin of the order says "checkout" it means that the order was placed via the checkout.
  • CMS: If the origin of the order says "cms" it means that the order was created manually via the circuly backend.
  • Customer-API: If the origin of the order says "cms" it means that the order was migrated.


Subscription Type Column

The subscription type information is not shown to the customer in any form.

  • Normal: If the subscription type is normal it means that this subscription considers the subscription to be for a physical product which will be returned at some point to you.
  • Consumable: If the subscription type is consumable it means that this subscription considers the subscription to be for a product that will be consumed over time and won't be returned to you.
  • Digital: If the subscription type is digital it means that this subscription considers the subscription to be for a digital product that is neither consumed nor will be returned.

Subscriptions tab > Subscription List


Status Column

  • Active: A subscription has the active status when a subscription is created for an order and the subscription is running normally.

    API Value: active
    Shown to customer in the self-service portal: yes
  • Pending return: The "pending return" status means that the product attached to the subscription is expected to be returned. A subscription can have the "pending return" status as a result of the following actions and/or settings: - When a user manually sets the subscription status to pending return by clicking on the "Set status as pending return" option in the Subscription action menu in the Subscription Overview window. - When the subscription end date has arrived, and there is no interaction with any auto-renew or renewal options, the subscription gets the "pending return" status auto-assigned by the circuly system. - When the "auto cancel subscriptions" setting is enabled.

    API Value: pending_return
    Shown to customer in the self-service portal: yes
  • Ended: A subscription has the "ended" status when a subscription is marked as returned from the Returns tab when you handle a return. You would typically mark a subscription as returned when the customer has returned the product and as a result the subscription has ended. If the customer has bought the products instead then you would mark it as bought instead of marking it as returned so that the correct status can be assigned to it.

    API Value: ended
    Shown to customer in the self-service portal: yes
  • Pending replacement: A subscription has the "pending replacement" status as a result of the following actions: - When a user manually initiates a product swap from the circuly Operations Backend by clicking on the Initiate product swap option in the Subscription action menu. - When a customer makes a product change request from their Self-Service Portal, the subscription status changes to "pending replacement".

    API Value: replacement
    Shown to customer in the self-service portal: yes
  • Bought out: A subscription has the "bought out" status when it is marked as bought in the Returns tab when you handle a return. You would typically mark a subscription as bought when the customer decides to keep their subscription product and has paid the amount that is due. If the customer has returned the product, you should mark it as returned instead of marking it as bought so that the correct status is assigned to it. If the customer has used the buyout action from the self service portal or you have initiated the buyout manually in the backend and if the payment has been successfully charged, then the subscription will automatically get the "bought out" status.

    API Value: bought_out
    Shown to customer in the self-service portal: yes
  • Lost / Stolen: A subscription has the "lost/stolen" status when a circuly user manually initiates a product swap from the circuly Operations Backend by clicking on the Initiate product swap option in the Subscription action menu and checks the box for "is the item lost (missing/stolen)".

    API Value: lost_or_stolen
    Shown to customer in the self-service portal: yes
  • Manual bought out: A subscription has the "manual bought out" status when a circuly user processes the buyout from the circuly Operations Backend.

    API Value: manual bought out
    Shown to customer in the self-service portal: no
  • Swapped: A subscription has the "swapped" status when the product under the subscription has been swapped through the swap process.

    API Value: swapped
    Shown to customer in the self-service portal: no
  • Auto-renewed: A subscription has the "auto-renewed" status when it has been automatically renewed through one of the following actions:- When the "Auto-renew subscriptions" setting is enabled. - When the "Custom auto-renew subscription" setting is enabled.- When you enable the "auto-renew" switch in the subscription overview window.

    API Value: auto-renewed
    Shown to customer in the self-service portal: no
  • Cancelled by customer: A subscription has the "cancelled by customer" status when a customer makes a cancellation request from the self-service portal.

    API Value: auto-renewed
    Shown to customer in the self-service portal: no


Subscription Type Column

  • Normal: If the subscription type is normal it means that this subscription considers the subscription to be for a physical product which will be returned at some point to you.
  • Consumable: If the subscription type is consumable it means that this subscription considers the subscription to be for a product that will be consumed over time and won't be returned to you.
  • Digital: If the subscription type is digital it means that this subscription considers the subscription to be for a digital product that is neither consumed nor will be returned.


Subscription Frequency Column

The subscription frequency defines the billing schedule for the subscription or in other words how often the customer is charged for their subscription. Currently the following values are possible.

  • Daily
  • Weekly
  • Monthly
  • Yearly

Payments tab > Payment List

Status Column

  • Pending or payment pending: A "pending" status indicates that there is a delay in information from the PSP to the circuly system.  The circuly system has sent the payment to the PSP, and an update should have come back, but it hasn't yet. The exact status may vary depending on the PSP used: Pending is used for Stripe, Mollie and Braintree and Payment Pending is used for Adyen.
  • Submitted for settlement: A payment has the "submitted for settlement" status when the payment has been sent by circuly to the payment system to be charged.
  • Settled or Succeeded: The transaction was successfully charged by the PSP, and the success confirmation was sent to circuly. The status depends on the PSP you use. The status is displayed as settled for Braintree & Adyen or succeeded for Stripe & Mollie.
  • Refunded: The transaction was a refund transaction and the PSP has successfully refunded the payment and sent the confirmation to circuly.
  • Gateway Rejected: This status is only received from Braintree and means that Braintree didn't let circuly create a transaction in the first place.
  • Chargeback: The transaction was sent from circuly to the PSP, and the PSP tried to charge the saved payment method of the customer, but the customer or bank reported the charge as unauthentic or fraudulent. Learn more about how to deal with chargebacks.
  • Failed: The transaction was sent from circuly to the PSP and the PSP tried to charge the saved payment method of the customer but the payment was not successfully made. Further details on the failed reasons can be found in the invoice section.

Order payment column

  • TRUE: Order payment true means that this payment is an initial payment from order placement.
  • FALSE: Order payment false means that this payment is either a recurring payment, one time charge or refund.

Invoices tab > Invoices List

Invoice Type

  • Recurring payment: When the "Invoice type" column has the value "recurring payment" this means that the associated invoice is for a recurring payment.
  • One-time payment: When the "Invoice type" column has the value "one-time payment" this means that the associated invoice is for a one-time payment.
  • Initial: When the "Invoice type" column has the value "initial" this means that the associated invoice is for the initial payment. Initial payment is the payment that is due when an order is placed on your checkout for the first time by a customer.
  • Cancellation: When the "Invoice type" column has the value "cancellation" this means that the associated invoice is a cancellation invoice. A cancellation invoice is generated when you manually cancel an invoice due to reasons such as wrong information, typing error etc. Learn more about cancellation invoices.
  • Buyout: When the "Invoice type" column has the value "buyout", this means that the associated invoice is for a product under a subscription that the customer has bought out.
  • Replacement: When the "Invoice type" column has the value "replacement", this means that the associated invoice is the replacement invoice for the previously cancelled invoice. Typically the replacement invoice includes the update information (e.g. updated information, corrected typing errors) of the original invoice.
  • Refunded: When the "Invoice type" column has the value "refund", this means that the associated invoice is a refund invoice. The following actions/settings will assign the refund status to an invoice:

    - Setting: Auto refund immediately cancelled subscriptions.
    - Action: REFUND INVOICE button in the invoice overview window. This button enables you to refund an invoice manually.
    - Action: When you check the refund checkbox when cancelling an order.

Tries Column

Numerical value ranging from 0 to x (Defined by you in your settings for failed payments. Associated setting: Number of payment retries).

Follow up date Column

Indicates the date when the next automatic payment charge try will be done. If the maximum number of autoamtic tries was done this will indicate the date when the last automatic payment try was done.

Paid Column

  • Cross icon ⛌: The cross icon indicates that the invoice has not been paid yet.
  • Check icon : The check icon indicates that the invoice has been charged. It is possible that an invoice is marked with a check sign, but no payment has been made. This is when you settle payments outside of the circuly system and mark an invoice as settled manually to keep track of all your invoices in circuly.

Recurring Payments tab > Recurring Payments List

Status Column

  • Settled: The "settled" status indicates that a recurring payment charge was attempted and has successfully processed.
  • Not settled: The "not settled" status indicates one of the following:- a recurring payment charge was attempted and has not been processed yet or is under processing.- the payment date lies in the future.
  • Failed: The "failed" status indicates that a recurring payment charge was attempted but has not been successfully.

Failed Reason column

The displayed value varies according the payment service provider used. The information displayed here is directly taken from your connected service provider. Kindly check the failed reason articles from your respective PSP.

Note: The failed reasons are only for recurring payments.

Quick links for PSP documentation on failed reasons

Assets tab > Asset List

Status Column

  • In stock: An asset has an “in stock” status when the asset is in your stock and available to be rented on your eCommerce shop.
  • Bought out: An asset has the “bought out” status when the asset is not expected to be returned because it has been bought/purchased by the customer.
  • Pending buyout: An asset has the "pending buyout" status until the one time payment that has been processed with the buyout process receives the status "paid" or "failed".
  • To repair: As asset has the “to repair” status when the asset has been returned and is under the repair process before it can be pushed into the stock and made available for renting.
  • Stolen: An asset has the status as “stolen” when the asset is not expected to come back because it has been stolen. The item can be be marked as stolen in the swap process by ticking the checkbox "is this item lost or stolen?"
  • Rented out: An asset has the status "rented out" when the asset is currently being rented by a customer in a subscription.
  • Broken: An asset has the status "broken" if you define in the repair process that an item cannot be rented out again.

Returns tab > Return List

Status Column

  • Active: An order in the Return List has an “Active” status when the asset attached to the subscription is with the customer and the subscription is still active. All active subscriptions show up in the Return List because the assets attached to a subscription have the potential of being returned. It’s just a matter of time when the asset will be returned and, therefore, is available to be processed as returned at all times.
  • Pending return: An order in the Return List has a “Pending Return” status when the asset attached to the subscription is expected to be returned but is still with the customer and has not yet been returned due to reasons such as:

    - The subscription period has ended, and the customer is in the process of sending the asset.

    - The customer has made a cancellation request from the Customer Self-Service and you’ve enabled the setting (Auto cancel subscriptions) that sets the subscription status as pending return automatically when a cancellation request has been made from the Customer Self-Service.

    - The subscription went through two failed payment cycles, and you’ve enabled the setting (Cancel subscription on failure) that automatically sets the subscription status as pending return when a subscription goes through two failed payment cycles.

    - The status of the subscription was manually set to pending return.

    - When the customer makes the cancellation from the self-service portal within the early cancellation period.
  • Pending Replacement: An order is the Return List has a “Pending Replacement” status when the asset attached to the subscription is expected to be exchanged with another product. The product being replaced is then given the status of pending replacement to differentiate it from products that are regular returns and not replacement returns.

Repairs Tab > Repairs List

Location & Status column

  • To repair: Indicates that an asset is in the repair process or to be repaired.

Repair Status

  • New
Read more
Returns
Mark as returned

Return Handling: Mark as Returned

Mark, as returned, is commonly used to indicate that the subscription that was in the "pending return" state can be processed because the product has been returned. Mark, as returned, changes the status of the subscription to "ended".

Introduction

The "Mark as Returned" function in circuly is used to finalise the return process when a product physically arrives back in your warehouse. It changes the subscription status from "Pending return" to "Ended", indicating that the customer has fulfilled their return obligation and the subscription is complete.

This feature can also be used in edge cases where the subscription is marked as pending return but the product was never delivered, and you want to close the subscription manually.

Tip: Automate the process via API

You can automate the return handling process using the circuly Customer API.

When to use “Mark as returned”

Use this option when:

  • The customer has sent the product back, and it has arrived in your warehouse.
  • The product was never delivered, but the subscription was set to pending return and now needs to be closed.

In both cases, marking the product as returned updates the subscription status to "Ended", which signals that the subscription is complete and the product is no longer in circulation.

Step-by-step guide: How to mark a product as returned

  1. Go to the Returns tab in your circuly Hub.
  2. Search for the product by its serial number in the Return List.
  3. Click Handle to open the return handling window.
  4. Click Mark as returned.

Once confirmed, you’ll see a message that the subscription has been ended.

Repair handling (if applicable)

If you’ve set up the Repair workflow in circuly:

  • Go to the Repairs tab after marking the return.
  • Complete the repair process based on your configured repair questions and flow.

Delete future recurring payments checkbox

The “Delete future recurring payments” checkbox determines whether upcoming charges should be canceled when processing a return.

This checkbox appears in two places:

  1. When marking a subscription as pending return
  2. When handling a return

How it behaves:

  • When you manually set a subscription to pending return, you decide whether to check the box.
    • Check it if you want to stop billing while the customer returns the product.
    • Leave it unchecked if you want to keep billing to encourage timely returns.
  • When you handle a return and mark the product as returned, circuly automatically checks the box—assuming the product is already back and recurring payments should stop.

If the subscription ends automatically (e.g. due to no auto-renew), and no manual interaction occurs, circuly will continue charging unless you’ve configured it otherwise.

Additional setting: Update stock on SKU level

You can control how returned products affect your stock levels.

  • To update stock at the SKU level (useful if multiple durations exist for one variant), enable this setting:

Go to Settings > Subscriptions > Return subscription > Enable Update stock on SKU level after return

  • If disabled, stock is updated at the variant level.

If you do not want circuly to update your stock at all, please contact us via the Service Desk.

Read more
Orders
Mark as fulfilled

Mark as Fulfilled

Detailed info about the Mark as fulfilled function.
Tip: This process can be automated via our customer API. This is the POST request you can use https://api-docs.circuly.io/docs/customers-api-docs/eb7ac5d762d9d-fulfill-order-by-id that you can use for marking order as fulfilled.

For Bulk Update follow this link: https://api-docs.circuly.io/docs/customers-api-docs/7qbwc0gwj2t9q-fulfill-orders-in-bulk


When your customer completes the checkout process and finalises the order, an order is created in your Shopsystem and in the circuly Operations Backend. To start collecting recurring payments, a subscription needs to be created for the order.

In the circuly Operations Backend, you can find multiple ways to create a subscription. circuly provides you both, manual and automated workflows for creating a subscription.

The decision to choose a manual option or an automated one depends on the number/quantity of incoming orders and the amount of control you want over the operations.

Available options for creating a subscription:

  • Creating a subscription from the Orders tab (manual)
  • Creating a subscription from the Customers tab (manual)
  • Using the "Bulk Update" option to create subscriptions (manual)
  • Using the "Mark as fulfilled" option to create subscriptions
  • Using the "Bulk upload" option to create a subscription

In this article we’ll go over the Mark as fulfilled option. For all other ways to create a subscription, refer to this article: All Different Ways to Start a Subscription in the circuly Operations Backend 

Mark as fulfilled

You can automate the process of creating a subscription by making the subscription create process dependent on the "Mark as fulfilled" button.



Typically the mark as fulfilled button is used to indicate that an order has been successfully delivered. Fulfilling order is part of the shipping process. You want to use the fulfilment function to mark that the order item has left the warehouse.

However it can also be used to automatically create subscriptions.

If you enable the Auto activate subscription setting in your Settings then subscriptions will be automatically started after they are marked as fulfilled by a circuly user.

To access the setting > Go to Settings > Subscriptions > CREATE SUBSCRIPTION > Enable the switch for Auto activate subscriptions.

Note: The subscription start date value will be taken from the Auto activate offset setting. Make sure that you define the value in the respective setting. 

What does ‘mark as completed’ do?

  • The mark as completed will change your order’s status from open to fulfilled
  • It will trigger the order fulfilment email if you have set up the template + activated the settings for it. (setting:  All order-related emails + Order fulfillment completed)
  • It will update the status for the customer in the self-service portal as well from open to fulfilled
  • It can trigger an automated subscription start if you have enabled the settings for it.

(setting: Auto activate subscriptions)

What set-up is necessary for the fulfil order function?

  • Please check the email template. 
  • Please check the settings. 
  • If you would like to automate this step via the API, follow the set up instructions here
  • You can also mark every order as fulfilled automatically when a subscription was started (setting: Fulfil order when all subscriptions are created)
Read more
Products
Extension price

Extension Price

Learn more about extension prices.

Introduction

The extension price determines the subscription fee that applies once the minimum subscription duration is over and the subscription continues through auto-renewal. This price ensures that your business charges customers correctly beyond the initial contract period.

The extension price is especially important for:

  • Prepaid subscriptions, where the full amount is charged upfront for a set period, and a monthly price needs to be defined for the post-prepaid phase.
  • Regular subscriptions, where you may want to apply a different rate after the minimum term is completed.

Feature overview

The extension price is configured per product variant in the circuly Hub It is used when:

  • A subscription continues after the minimum commitment.
  • A prepaid subscription transitions into a regular monthly billing model.

Good to know

  • The extension price only becomes relevant after the minimum contract period is completed.
  • The subscription will continue at this price unless manually changed or cancelled.
  • The extension price appears in the subscription creation screen, but it can only be edited via the Products > Variants section.

Step-by-step guide: Set or edit extension price

  • Go to the Products tab in your circuly Hub.
  • Navigate to the Variants section.
  • Select the variants you want to update by checking the boxes next to them.
  • Click the Edit extension price button.
  • In the input field, enter the monthly extension price that should apply after auto-renewal.
  • Click Save changes.

Once set, this price will be automatically applied when the subscription enters its extension phase.

FAQ

Q: Can I leave the extension price blank?
A: No. It’s strongly recommended to define an extension price to avoid disruptions or errors in billing after the minimum subscription period.

Q: Does the extension price override the initial monthly price?
A: Only after the minimum contract period ends. The initial monthly or upfront price remains in effect until then.

Q: Can the extension price be changed later?
A: Yes. You can return to the Variants list at any time and update the extension price.

Read more
Products
Prepaid Subscriptions

Explained: Prepaid Subscriptions

As the title suggests Prepaid Subscriptions are subscription orders where your customer agrees to pay the recurring fees in advance and upfront.

Introduction

Prepaid Subscriptions are subscription orders where the customer pays the full subscription fee upfront instead of in monthly intervals. This model is beneficial for both you and your customer — it supports predictable cash flow on your end and often comes with incentives (like discounts) for customers who commit to paying in advance.

Feature overview

With prepaid subscriptions:

  • Customers pay for the subscription period upfront.
  • No recurring payments are scheduled until the initial prepaid period ends.
  • After the prepaid period, the subscription can auto-renew monthly using the defined extension price.
  • You can distinguish between prepaid and monthly variants through clear naming.

Technical setup

Setting up prepaid subscriptions

Prepaid subscriptions are set up in your shop system by creating a variant with an upfront payment plan. During the variant creation, define whether the payment should be charged monthly or in full at once.

Configuring extension/renewal pricing

To continue charging monthly after the prepaid period:

  1. Go to Products > Variants in the circuly Hub.
  2. Select the variants for which you want to define an extension price.
  3. Click on Edit extension price.
  4. Enter the monthly extension price that should apply after the prepaid term ends.

This price will be used when the auto-renewal activates after the prepaid term.

Prepaid subscriptions in the circuly Hub

  • The variant title should indicate whether it's an upfront or monthly plan.
  • No recurring payments are scheduled until the auto-renew starts.
  • The extension price is visible during subscription creation but can only be edited via the Product List > Edit Variant screen.
Read more
Email Templates
Shopify order name

Replace the Order ID Generated by Circuly With the Shopify Order ID

The circuly generated order ID can be replaced with the Shopify order name. Learn more.

Introduction

By default, circuly generates its own Order ID when a customer completes checkout. However, if you’re using Shopify as your shop system, each order also has a separate Shopify Order Name (often referred to as Shopify’s order ID).

To avoid confusion—especially in email communication or when syncing data across platforms—you can choose to replace circuly’s Order ID with the Shopify Order Name.

Why replace the circuly Order ID?

There are two common reasons to use the Shopify Order Name instead of the circuly-generated Order ID:

  1. Cross-referencing in communication
    If you're referencing the Order ID in emails sent via Shopify or other tools (outside circuly), using the same value helps ensure consistency.
  2. Avoiding confusion for customers
    When customers see different IDs across emails and portals, it may lead to unnecessary support requests. Replacing the circuly Order ID with Shopify’s Order Name ensures your customers only see one consistent identifier.

Technical background: Order ID vs order name

  • circuly Order ID
    Automatically generated when an order is placed via your circuly white-label checkout. Used internally and displayed in circuly’s email templates and Self-Service Portal.
  • Shopify Order Name
    Generated by Shopify and assigned to every new order. This is what customers typically see in Shopify-based communications.

Where the Order ID is used in circuly

The circuly-generated Order ID appears in:

  • The Order confirmation email
  • The Customer self-service portal

If not changed, this is the value customers will see by default.

When should you replace Iit?

You should consider replacing circuly’s Order ID with Shopify’s Order Name if:

  • You send additional emails to customers outside of circuly’s templates (e.g., directly via Shopify)
  • You want consistent identifiers across your shop system, email templates, and Self-Service Portal
  • You want to reduce confusion caused by customers seeing two different order numbers

How to replace the Order ID in circuly

To use the Shopify Order Name instead of circuly’s Order ID:

  1. Go to your Email Templates in the circuly Hub.
  2. For each relevant email (e.g. Order Confirmation), replace the variable {{order_ID}} with the Shopify order name variable.
  3. Save your changes.

Once updated, customers will see the Shopify Order Name in their emails and in the Self-Service Portal.

Read more
Account & Setup
Products
Reserve serial numbers

Reserving Assets with circuly

Asset status reserve means that the asset has already been assigned to an order item and when the order item is converted into a subscription, the asset status will change from reserved to rented out. 

Introduction

Reserving a serial number (asset) means that a specific product unit is pre-assigned to an order and will automatically be linked to the subscription once it's created. This ensures better inventory control, traceability, and operational efficiency.

Enabling this feature in circuly allows serial numbers to be automatically reserved—removing the need for manual assignment during subscription creation.

Why reserving serial numbers matters

Here are a few key reasons to reserve serial numbers in circuly:

1. Inventory management
Reserving a serial number ensures the specific product required for the order is set aside and not mistakenly allocated to another customer. This helps maintain accurate inventory levels.

2. Product traceability
With unique serial numbers assigned to each order, you gain clear traceability. If there’s ever an issue or product recall, you can easily identify and track the affected items.

3. Warranty & support
A reserved serial number simplifies support. When a customer needs assistance, your team can quickly retrieve relevant order and product details using the serial number.

Overall, it contributes to operational accuracy, faster service, and better organisation throughout your order and subscription processes.

How to enable serial number reservation in circuly

To enable automatic reservation of serial numbers:

  1. Go to your circuly Hub
  2. Navigate to:
    Settings > Checkout > End checkout
  3. Enable the setting “Reserve serial number”

Once this switch is enabled, circuly will:

  • Automatically reserve a serial number from the Asset List
  • Assign the reserved asset to the order item when creating a subscription
  • Update the asset’s status from “in stock” to “reserved”
  • Once a subscription is created, change the asset status from “reserved” to “rented out”

When you create a subscription, the serial number will already be pre-assigned to the order item—saving you an extra step.

How to add assets to circuly

To use the serial number reservation feature, your assets need to be added to circuly and marked as “in stock”.

Steps to Import Assets:

  1. Download and fill out the asset import template.
  2. Make sure each asset has the correct status set to “in stock”—only assets with this status can be reserved.
  3. Go to the Assets tab in your circuly Hub.
  4. Click the CSV icon to upload your asset file.

Once imported, circuly will use these assets to fulfill orders with automatic serial number reservation.

Read more
Account & Setup
Delete recurring payments setting

Setting - Delete Recurring Payments

Automate the operations related to cancellation requests from the self-service portal. Learn more.

Introduction

Customers can cancel their subscriptions either by using the Customer Self-Service Portal or by contacting your customer support. circuly provides flexibility in managing both types of requests, offering control over manual processing and automation where applicable.

Cancellation via Customer Support

When a customer contacts your support team directly, you (a circuly user) manually manage the cancellation request. This gives you full control over whether the subscription should be:

  • Cancelled immediately
  • Set to "pending return"

You can decide the course of action based on whether the customer has received a product and whether the order has an attached subscription. This approach is completely manual and requires user intervention in the circuly Operations Backend.

Cancellation via the Customer Self-Service Portal

When a cancellation request is made through the Customer Self-Service Portal, the circuly system can automate parts of the process, reducing manual input.

Cancellation request via Customer support 

When your customers get in touch with your customer support, you have full control over how you want to cancel the subscription and if you want to cancel it. This process is manual as it requires a circuly user to cancel the subscription or set it as pending return, depending on whether or not there is a subscription attached to the order and whether or not the customer has your products. 

Cancellation request via Customer Self-Service Portal 

However when cancellation requests are made from the Self-Service Portal, you can enable the circuly system to take some actions fully automated without any manual input from your side. ‍

One setting that influences what happens after a cancellation request is processed is the Delete recurring payments setting. 

Background

When a cancellation request is made from the self-service portal the Auto cancel subscription setting has an influence on the status of the subscription and the status of the subscription has an influence on the Delete recurring payment setting.

Note: The subscription status only has an influence on the Delete recurring payment setting when the cancellation request is made from the self-service portal, and the cancellation action sets the subscription status as pending return. Actions performed by a circuly user that set the subscription status a spending return in the circuly Operations Backend do not interact with the Delete recurring payment setting. 

If any of the following conditions is met, the status of the subscription is automatically set to pending return

  • Auto cancel subscription setting is enabled 
  • The subscription is within the early cancellation period and the customer selects immediately or after minimum duration as an option to return the product (auto cancel subscription setting can be disabled/enabled and the subscription status will still be set to pending return) 

Learn more about the Auto cancel subscription setting.

About the Delete recurring payment setting

As the name suggests the Delete recurring payment setting can be used if you want to delete future recurring after a subscription status is set to pending return via a cancellation request made from the self service portal. The recurring payments are deleted until the subscription is reactivated.

As mentioned above user actions in the circuly Operations Backend that set the subscription status as pending return do not interact with the Delete recurring payment setting. 

Important: The payments are deleted irrespective of whether or not you’ve received the product back from the customer. 

Are the recurring payments deleted permanently?

No the recurring payments are not deleted permanently. In case the customer does not return the product the subscription can be reactivated and the recurring payments will continue to be charged.

When this setting deletes the recurring payments, you can ideally avoid a situation in which a customer is charged for an additional month while the customer is in the process of returning the product.

To access the setting > Go to Settings > Customer Login > CANCEL OPTIONS > Delete recurring payments.

Read more
Customer Self Service
Reporting issues

Self-Service Portal - Reporting Issues

Your customers can report issues from the self-service portal. Learn more.

Introduction

If you are facing any issues with your subscription you can easily report an issue for the same. 

To report an issue > Select Report an issue from the subscription action dropdown menu under Your Subscriptions and click on CONFIRM > You will be taken to the subscription overview window > In the same window, write a message in the Your Message input field describing the issue in detail and click on the SEND button. 

Alternatively you can use the email address mentioned in the self-service portal to write an email to our customer support.

Read more
Account & Setup
Products
Check stock

Checkout setting: Check system stock

A setting that runs a stock check query on your checkout page. Learn more about use case.

When enabled in your circuly Hub settings, the 'Check system stock' setting performs a stock check in the background as soon as the customer arrives on the checkout page. This check uses the stock level data stored in the circuly Hub as its base which is in turn based on an automatic sync between your shop system and the circuly Hub.


Product is available: if the product is available the customer can proceed with the payment and finalise the order.
Product is not available: If the selected product is not in stock, an error message is displayed on the checkout page and the customer is prevented from proceeding to the payment page.


Access the setting

To access the setting > Go to Settings > Checkout > PRE CHECKOUT > Check system stock

Learn more about stock management with circuly.

Read more
Payments
Account & Setup
Payment cycle

Payment Cycles

A payment cycle has “x” number of payment retrial attempts meaning that if the circuly system has retried a failed recurring payment “x” number of times then this counts as one payment cycle. 

What is a payment cycle?

In circuly, a payment cycle refers to the complete process of retrying a failed payment the maximum number of times you've configured in your settings.

Feature overview

When a recurring payment fails, circuly will automatically retry the payment based on your defined settings. This retry process is called a payment cycle.

A payment cycle =
1 failed recurring payment
retried automatically up to the maximum number of times (e.g. 3 retries)

Once all retries have been attempted and the payment still fails, the payment cycle is considered completed—but the payment is still marked as failed.

Good to Know

  • You can set the number of retry attempts in:
    Settings > Invoice & Payment > FAILED PAYMENT > Maximum number of payment attempts
  • Multiple payment cycles are used to determine subscription-level actions (e.g. auto-cancellation after two failed payment cycles).

Example:
If Max attempts = 3 and a payment fails, circuly will retry it 3 times.
That’s 1 payment cycle.
If another payment fails and is also retried 3 times, that’s a second payment cycle.

Read more
Products
Customer Self Service
Exchange Groups

Exchange Groups: Unleash the Power of Streamlined Choices

Offer your customers the possibility to replace products and select from a predefined collection to alleviate decision fatigue and guide them towards making confident choices.

Introduction

In a world where consumer choice is abundant, guiding your customers with curated selections can dramatically improve their decision-making experience. Research shows that 87% of customers appreciate curated product experiences that reduce decision fatigue and support confident choices.

circuly’s Exchange Groups feature enables you to deliver this experience. By allowing customers to choose a replacement product from a pre-defined, tailored group, you empower them to swap products without being overwhelmed by irrelevant options.

Feature overview

Exchange Groups is a feature in the circuly Hub that lets you:

  • Create collections of related product variants.
  • Enable customers to swap their current subscription product with another from the same collection.
  • Maintain price consistency or customise pricing for each variant.
  • Limit availability based on stock.

One-time feature setup

Step 1: Create an exchange group collection

Step 2: Map variants to the collection

Step 3: (Optional) Go over the swap settings in the Settings tab

Step 4: Enable the "Check System Stock" setting

Technical setup

Step 1: Create an exchange group collection

  • Go to Products > Exchange Groups tab.
  • Click on + Exchange group.
  • Fill in the group title, description, and optional exchange discount.
  • Assign product variants via the dropdown or skip this and assign them in the next step.
  • Click Submit.
Note: An exchange group can include up to 1000 product variants.

Step 2: Map variants to the collection

  • Navigate to the Variants tab.
  • Select the variants you want to group by checking the checkbox > Then click on Map to exchange collection button.
  • Choose the desired collection from the dropdown > Click Map to groups.

To verify, scroll horizontally in the Variants tab to view the Exchange Group column.

Step 3: (Optional) Review swap settings

Exchange Groups use the swap logic and associated settings. Ensure your swap settings are configured under Settings > Swaps.

Step 4: Enable system stock check

To avoid offering out-of-stock products, activate the stock validation feature:

  • Go to Settings > Checkout > Pre-Checkout > Check System Stock.
  • If already active for checkout, the same logic applies to the Self-Service Portal.
Note: Update your collections regularly if you have stock-sensitive items like refurbished products.

Good to Know

  1. All product data (e.g. price, name) is imported from your shop system into circuly.
  2. Exchange Group pricing follows your shop system by default, but flat pricing per collection can be arranged upon request via the service desk.
  3. Exchange Groups are only available for new orders. If you want to enable this feature for existing subscriptions, contact circuly support.

Process for your customers

Here’s how the exchange process looks for your customers:

  1. Customer logs into the Self-Service Portal.
  2. Opens subscription menu > Clicks Change product.
  3. Clicks CONFIRM.
  4. A window slides in from the right.
  5. Customer selects a product from the dropdown (display includes product image and price).
  6. Clicks Save changes.

Stock validation is triggered at this point. If the selected product is out of stock, an error is displayed.

The subscription status changes from active to pending replacement.

Note: To display your custom terms and conditions, share the desired text with circuly to include in your white-label Self-Service Portal.

Process for a circuly user

  • A new order is created in the circuly Hub unless the Delay Swapped Orders setting is enabled.
  • Process this order manually or update its status based on your shop system flow.

Learn more about manually creating subscriptions or using the bulk update feature to update orders.

Business cases and ideas

1. Consumable subscriptions

  • Example: Protein powders in different flavours (vanilla, chocolate, cookie dough).
  • Create a collection named “Flavours – Black Edition” and map the variants.
  • Customers choose their preferred flavour through the Self-Service Portal.

Also applicable to coffee, baby diapers, wine, and other consumables.

2. Tangible product subscriptions

  • Strollers: Offer swaps between compact, large, or double strollers.
  • Bikes: Let customers upgrade to bigger kids’ bikes as the child grows.
  • Furniture: Allow seasonal swaps (e.g. summer lounge chairs vs. winter armchairs).

Read more
Admin
Subscriptions
Swap settings

Swap Settings: Explained

In order to utilize the swap feature within the circuly Operations Backend, it is essential to carefully review and configure the following settings based on your specific business requirements.

Introduction

In a subscription-based business model, customers don’t just purchase products—they use them for a defined period, often with the option to return, upgrade, or replace them. That’s where product swapping comes in.

Swapping allows customers to exchange one product for another during their subscription term. This can be due to breakage, loss, dissatisfaction, or a change in needs—like upgrading to a newer model or switching to a more suitable product. It's a critical feature in making a subscription model work smoothly, especially for physical products that require flexibility and long-term use.

To support this, circuly provides a swap feature within the circuly Hub and the Self-Service Portal. With the right configuration, businesses can streamline how swaps are handled—ensuring a smooth experience for both customers and operations teams while preventing misuse and managing logistics efficiently.

Feature overview

circuly supports product swaps through two main channels:

  • circuly Hub: Swaps can be manually initiated and processed by your internal team.
  • Self-Service Portal: Customers can initiate a swap themselves using the “Change Product” option.

Both methods integrate into your subscription flow and trigger a series of backend processes depending on how the swap settings are configured.

Settings overview

Here’s a breakdown of the key swap-related settings in the circuly Hub:

  • Maximum number of swaps per original order
    Set a limit on how many times a single order can be swapped. This helps prevent abuse or suspicious activity by stopping additional swaps once the limit is reached.
  • Delay swapped order
    Instead of immediately creating a new active order after a swap request, enabling this setting creates a draft order. This ensures you can receive the original product before shipping a replacement—helping reduce fraud.
  • Prevent swap if customer has failed payments
    Automatically blocks swap requests from customers with unpaid or failed payments and also prevents a user from processing a swap if a customer has failed payments, helping reduce risk.
  • Swap reasons
    Add customisable reasons for swapping, which are then displayed to a circuly user when processing a swap.
  • Tag after swap
    Add a label (e.g. "replacement" or "swap") to orders processed as swaps, making it easier to differentiate them from regular orders.
  • Extend subscription on return
    Automatically extend the subscription end date by 7 days to account for the delivery time of the replacement product—especially useful if the customer is close to the end of their subscription.

Setup guide

To configure the swap settings, navigate to the Settings tab in your circuly Hub. Under the settings menu click on Swapping and configure the settings you need.

Learn more about exchanging and swapping products.
Read more
Invoices
Customers
Filters

Filter Functionality in circuly

User the circuly Filter function to get specific information in the circuly Operations Backend.

Introduction

Each tab in circuly Hub (Orders, Subscriptions, Customers, Invoices) has an index page that displays a list — such as the Order List, Subscription List, or Customer List. You can use filters to segment these lists and display exactly the information you want. The filter functionality in the circuly Hub helps you quickly narrow down data so you can focus on what matters most.

Feature Overview

  • Flexible filtering: Apply multiple filters to slice your data based on different fields and criteria. The fields available depend on the tab you’re working in (e.g. Customer fields under the Customers tab).
  • Saved views: You can save your filter settings as default views, making it easy to switch between different filtered perspectives without setting them up each time. You can save multiple views and toggle between them whenever needed.
  • Active filters: All applied filters are shown under Active filters, so you always see exactly how your data is being filtered.
  • Resetting filters: Clear all filters anytime with the Clear button to return to the unfiltered list.
  • Browser-friendly: Filters are added to the URL string, so if you navigate back and forth using your browser’s arrow keys, your filters stay intact and don’t reload — making it easier to explore data without losing your current view.

Step-by-Step Guide

How to add a filter

  • In the circuly Hub, click on the Filter button.
  • Select a Filter key.
    • The options shown here depend on which tab you’re in. For example, in the Customers tab, the dropdown will show all the column headings from your customer list.
  • Select an Operator to define your filter condition.
    • Available options include:
      • Is, Contains, Excludes, Matches, Is Empty, Date, or Date Range.
      • Certain value options also contain predefined values such as status.
      • In case of numerical possibilities operators like greater than and less than as well.
  • Click + Add filter to apply it.
Note: if you don’t actively click this button, the filter won’t be applied.
  • Once applied, the filter will appear under Active filters.
  • Repeat these steps to add more filters as needed.

  • When you’re ready, click Search to update your list with the applied filters.

How to save a filter view

  • After adding all your desired filters, click on the Save as function.
  • Give this set of filters a name to save it.
  • You can create and save multiple views.
    • Later, simply select the saved view to instantly apply all its filter settings.

How to navigate between saved filter views

If you’ve saved more than one filter view, you’ll see a list of saved filters under “Saved Filters.”


To switch between different filtered perspectives:

  • Simply click on any saved filter in the list to apply it immediately.
  • To move from one applied filter to another, just select a different saved filter from the list.
Important: Clicking on the cancel (×) icon next to a saved filter will permanently delete that saved filter.

How to see which filter is currently active

You can always tell which saved filter is currently applied by checking the highlighted or selected filter under the Saved Filters section. This clearly shows which conditions are filtering your displayed list.

Pro tips: browser navigation & bookmarks

  • When you use your browser’s back and forward buttons, the circuly Hub keeps your filters intact — even if you move to another tab and return — because the filters are stored in the URL.
  • You can also bookmark the URL (including the filter string) to always land on the exact filtered view you want whenever you log back into Circuly.

You’re all set to start using filters in the circuly Hub. Try out different combinations and save your favourite views to make your work even easier.

If you have any questions or run into something unexpected, our team is always here to help.

Read more
Account & Setup
Bookkeeping for a Subscription Business

Bookkeeping for a Subscription Business

Bookkeeping in a subscription business involves recording and managing the financial transactions related to the recurring revenue from subscription-based services or products.

Introduction

Bookkeeping is an essential process for managing the financial transactions related to your subscription-based services or products. In a subscription business, it’s crucial to track and record various payment events, such as initial payments, recurring payments, one-time payments, refunds, and invoice management. Understanding how to set up and manage these financial transactions within circuly can help streamline your operations, ensure accurate record-keeping, and provide insights for forecasting revenue.

Bookkeeping in a subscription business involves recording and managing the financial transactions related to the recurring revenue from subscription-based services or products.

  • Understanding how circuly gets access to the payment method of your customer
  • Different types of payments and how they are triggered
  • Failed payments: Setup
  • Refunds in circuly
  • Invoices in circuly
  • Invoices: Trigger and setup
  • Invoice download and export
  • Understanding payment status
  • Revenue forecasting

How circuly gets access to your customer's payment data

When your customers goes through your checkout, select a payment method and enter their payment details - Your customer goes over your checkout and places an order by adding their payment details and finalising the order. They select a payment method and add their payment details. 

Note: The payment methods that are displayed on the checkout depend on the Payment Service Provider you use. 

A payment profile is created - as soon as the customer is on on the Order confirmation page, a payment profile is created in circuly and in your connected Payment Service Provider. 

Note: circuly never gets any access to the payment information of the customer and also doesn’t park any payments. Circuly only creates a payment token and triggers your Payment Service Provider to charge the payment. Any payment that is successfully charged, goes directly to your connected account. 

Different types of payments 

In circuly there are three types of payments:

  • Initial payments
  • Recurring payments
  • One-time payments

Every payment initiated in the circuly Hub has an email template attached to it. All payment-related email templates are sent with an invoice, which make use of the invoice email templates. 

Here’s an overview of the email templates triggered by the three types of payments in the circuly Operations Backend: 

  • Initial payment: Payment was successful and invoice
  • Recurring payment: Your invoice and invoice
  • One-time payment: Your invoice and one-time transaction

Access the Miro board about Email Templates and their triggers

Initial payment

Trigger: Typically automated and can be manual. 

Associated email templates: Payment was successful and Invoice. 

Initial payment is the payment that is due when an order is placed. The initial payment often refers to the first recurring payment plus any other payment (setup, shipping, additional products) you charge when a customer places an order on your checkout page. Typically the initial payment is triggered and charged automatically. However you can choose not to charge the initial payment in the checkout and delay the charge, (delayed charge) until a later point in time. When you do so, you’ll have to charge the initial payment manually. 

Note: Typically subscriptions can only be created if the initial payment is successfully charged. This is the case bacuse any failures in charging the initial payment indicate that their might be problems with charging the recurring payments in the future. 

You can choose to create a subscription even if the initial payment is not charged yet. In order to do that, you need to enable the Setting that allows you to create subscriptions for unpaid order or order without an initial payment. 

Important: the option to delay the initial payment is available only for Stripe and Braintree users. 

Recurring payments

Trigger: automated

Associated email templates: Your invoice and invoice. 

Recurring payments are the payments that have a schedule behind them and are charged on a recurring basis depending on the frequency such as daily, weekly, monthly or yearly. 

In circuly the monthly subscription fees are charged from the saved payment method of the consumer automatically. 

Note: Recurring payments can be manually charged. The option to charge a recurring payment manually is typically used when you want to charge a recurring payment ahead of its planned schedule or charge date or if there is any kind of problem in charging the recurring payment automatically. Learn more about charging a single recurring payment in the circuly Operations Backend

One-time payments

Trigger: manual

Associated email templates: Your invoice and one-time transaction. 

One time payments are payments that do not have schedule or frequency behind them and are charged manually by a circuly user from the circuly Operations Backend. The reason for charging the recurring payment can be anything from repair charges to additional services offered. 

Refunds in circuly

In the circuly Operations Backend you can initiate partial and full refund. Refunds are triggered manually and the refund action also makes use of the Email Templates to inform the customer about the refund. When you perform a refund action, the transaction refund email template is triggered. The transaction refund email is sent together with an invoice, for which the refund invoice email template is used. 

Invoicing in circuly

Invoices are generated for payment-related actions such as initial payments, one-time payments, recurring payments and refunds. An invoice is also generated if you cancel an invoice, make corrections on the invoice and if you retry failed payments

Possible ways on sending invoices to your customers

With circuly you have two options when it comes to sending invoices to your customers. 

  • Via your own bookkeeping tool - you can connect your bookkeeping tool via webhooks to circuly or via your shop system so that the invoices can be sent to the customer as soon as a new payment is upcoming. This has the following implications or things you should keep in mind:
  • Your customers will not be able to view and download the invoices in their self-service portal. 
  • The invoice number itself will differ. The invoice generated in circuly will have a circuly generated invoice number and this will not be the same as the invoice generated by your bookkeeping tool. 
  • Via the circuly Operations Backend - alternatively you can let circuly take care of generating and sending invoices to your customers. Your customers will also be able to see and download the invoices in the self-service portal. 

Invoice: Trigger and setup

Invoice Trigger

In the circuly Operations backend, invoices are available as templates in the Email Templates tab. Invoices are categorised based on the purpose such as one-time invoice for one time payment, refund invoice for refunds etc, and are triggered in combination with the Email Template it replies on. 

You can enable circuly's default templates to get an idea about the information the different email templates typically contain. 

Invoice Setup

Invoice email setup

In the circuly Operations Backend email templates are CSS and HTML based which gives you complete freedom to set up the email templates to fit your brand identity. If CSS and HTML are not your strongest suite, you can use the default templates of circuly and change the logos, and colour scheme to make the email fit your brand identity. 

Note: Every email templates has a list of available variables that can be used while setting up the email templates. You can only use variables that are available. 

Learn more about setting up email templates in the circuly Operations Backend

Invoice data setup

The numeration scheme of the invoice is customisable and can be setup in the Settings. To do the setup go to Settings > Invoice & payments > INVOICE SETUP > Add your custom values to the given input fields. 

Note: The invoices are date-to-date invoices meaning the performance period for each monthly payment is exactly thirty days. The performance period starts whenever the subscription is started - so at subscription start date + 30 days.

Pro tip: If this makes the bookkeeping processes too complicated to have varying performance periods that count into two months, we would advise to start each subscription on the first of the month. If a customer starts in the first half of the month, you could also start the subscription mid of the month and charge the remaining half of the month via a one-time payment to start recurring payments always on the first.

Invoices download and export

You can download the invoices by exporting them. You can use the filter function to only see invoices for a custom criteria. 

Commonly used filter functions:

  1. Monthly invoices: Go to the Invoices tab > Click on the filter icon > Under field select “Created” > Under Date or DAte range select the date or date range > Click on Ok > The invoice list will then be filtered according to the given criteria. 

  1. Downloading refund invoices: To download invoices for payments that have been refunded, use the filter function. In the invoices tab > Click on the filter icon > In Field select Invoice type > In option select contain > In value type “refund”. 

Similarly you can filter the Invoice list for finding invoices for initial payment, buyout articles, recurring payments, cumulated invoices, one-time transaction and cancellation. 

Revenue forecasting

To forecast revenue in a subscription business, ideally you needs to consider various factors that affect your revenue streams. Some of the key factors to consider include the number of subscribers, the price of the subscription, and the length of the subscription term. Other factor that may impact revenue include customer churn rate. 

To create an accurate revenue forecast, businesses typically use historical data on their revenue streams and subscription trends, along with assumptions about future market conditions and customer behaviour.

However if your subscription business is new, you may not have a pool of historical data to play in.

Our recommendation therefore is to set up a minimum subscription duration (if it fits with your business case) for better financial planning. 

Overview os the status column in the payment list

Read more
Account & Setup
Customer Self Service
early cancellation period

Early cancellation period

In some countries, your customers have the right to cancel their subscriptions within a specified time period (Widerufsfrist in Germany), and as a business, you are mandated by law to approve the cancellation. 

Introduction

This article explains how cancellations are handled in circuly when customers exercise their legal right to cancel within the early cancellation period (commonly 14 days in Germany). This process ensures legal compliance while allowing your team to automate most of the customer journey.

This article explains how the early cancellation process works in circuly if the option to cancel the subscription is available in subscription action menu and the cancellation is processed from the circuly Self-Service Portal.

How early cancellation works

When a customer initiates a cancellation within the early cancellation period:

  • The circuly system checks whether the request falls within the defined cancellation window.
  • If yes, the customer sees two return options: "Immediately" or "After minimum duration".

Settings to Configure in circuly Hub

  • Early cancellation period: When you define a value for the Early cancellation period, the circuly system checks whether a cancellation request is made within this period or not.

    If the cancellation request is made within the early cancellation period, the customer sees two options under "Return the product" that is "immediately" and after "minimum subscription duration".

    If the request is made outside of this period then the customer doesn't see any option for returning the product and only sees the option to submit a cancellation request.  Each option has its own implications on the cancellation flow (explained later in more detail)

    To define a value for the Early cancellation period > Go to Settings > Subscriptions > CANCEL SUBSCRIPTION > Early cancellation period > Add a numeric value in the input field.
  • Cancellation reasons: In the cancellation process your customers have the option to state the reason for cancelling their subscription. In Germany the cancellation reasons are divided into two categories; Normal cancellation and extraordinary cancellation.

    Under each category, you can add specific reasons that you customer will select during the cancellation process or options you want your customers to choose from. These reasons exist to provide you more info on why your customers churn.

    To define the cancellation reasons > Go to Settings > Subscription > CANCELLATION REASONS > Click on the + icon to add Normal and extraordinary cancellation reasons.
  • Disable the switch for Hide cancel now: The "Hide cancel now" button, when enabled, will not show the "Cancel now" button in the subscription action dropdown menu in the Customer Self-Service Portal.

    If the "Cancel now" button is not displayed then the customer cannot make cancellation requests from the Customer Self-Service Portal.

    To access the settings > go to Settings > Customer login > FEATURES > Hide cancel now > Disable the switch if you want your customers to be able to make cancellation requests from the Self-Service Portal.
Info: It is mandatory as per German law to provide a cancellation button to your customers and the possibility to cancel subscriptions within the early cancellation period.

  • (Optional) Add an email address in the Support email address setting: The support email address is displayed in the Self-Service Portal and can be used by the customer to get in touch with you.

    The option to display a support email address is optional and can be skipped. However we recommend adding a support email address as doing so gives the impression to the customer that you are reachable and that increases the customers trust in your product.

    If your customer uses the email to make a cancellation request then there are no automated steps or operations followed.

    To update or add an email address go to your circuly Operations Backend > Settings > Customer login > GENERAL > Support email address > Type an email address in the input field.
  • Add an email in the Customer care email address setting: The customer care email address is the email that receives notifications from the circuly system for various operations such as cancellation requests made by the customer.

    This email address is used by the circuly system to inform a circuly user.

    To access the setting > Go to Settings > Company Settings > BASE SETUP > Customer care email address > Add an email address in the given input field.
  • Pickup date: If you offer pickup services for your products, you have the option of displaying a pickup calendar in the cancellation window in the Self-Service Portal.

    The pickup date picker is the same as the delivery date picker in the checkout.

    If you would like to offer your customer the possibility to select a date for the pickup of their cancelled subscription then you can enable this setting.

    To enable the setting for displaying a pickup date selector > Go to Settings > Customer login > CANCEL OPTIONS > Pickup date > Enable the switch.
  • Require pickup date: If you would like to make it mandatory for the customer to select a pickup date when going through the cancellation process do the following:

    First enable the switch for Pickup date (see above to know more about how to do so).

    Next enable the switch for Require pickup date to make it a mandatory option.
  • Auto refund immediately cancelled subscriptions: You can automate the process of processing a refund for cancellation requests that are made WITHIN the early cancellation period and the return option to return the product is "immediately". This setting will have no effect on other cancellation requests.
  • Restock item after an order cancellation: Enabling this switch will restocks all the items in the shop system after an order cancellation is processed. Learn more about the stock management with circuly here.

Customer journey and actions

Here's how the process looks for your customers and actions they take to make a cancellation request that is within the early cancellation period.

  • The customer is in the Self-Service Portal.

  • The customer selects "Cancel subscription" from the subscription action dropdown menu and clicks on the "CANCEL NOW" button.

A window slides in from the right. The customer continues the cancellation process by selecting a "cancellation type" (normal or extraordinary cancellation) and "cancellation reason" (displayed as soon as the customer selects the cancellation type).

When a cancellation request is made, the circuly system checks is the request is within or outside of the early cancellation period. 

If the request is within the early cancellation period, the customer sees two options under the field Return the product: immediately and after minimum subscription duration (See image below). 

  • The customer selects a return option.

Option 1: The customer selects "immediately" as an option to return the product.

  • The status off the order is displayed as "cancelled".

  • The customer receives the "Subscription cancellation received" email as a confirmation for the cancellation request.

  • The status of the subscription is automatically set to "pending return" by the circuly system.

  • As soon as the subscription status is set to pending return, the customer receives the "subscription pending return" email from the email templates. The Subscription pending return email should contain info about your return process as the customer will take the next actions depending on the info provided by you in this email.
  • Now it is upto the customer to return the product or on you to pick up the product from the customer to complete the return process.
  • This is the end of the cancellation process and start of the return process and return workflow.

Option 2: The customer selects "after minimum duration" as an option to return the product.

  • The status of the order is displayed as "cancellation requested". The customer may select "after minimum duration" as an option to return the product to indicate that they only want to use the product for a specified time period and have already taken the necessary steps to cancel the contract.

    This is not necessarily bad as the customer continues to use the product until the minimum subscription duration is over and continues to pay for the product.

    When the minimum subscription period is over and the end date has arrived, the circuly system will send the customer the necessary information about returning the product.

  • The customer receives the "Subscription cancellation received" email from the Email Templates as a confirmation of the cancellation request.

  • The customer continues to keep/use the product.
  • When the subscription end date is approaching the customer gets the "subscription almost over" email.
  • When the subscription end date has arrived the status of the subscription is automatically set to "pending return" by the circuly system.
  • As soon as the subscription status is set to pending return, the customer receives the "subscription pending return" email from the email templates.
  • Now it is upto the customer to return the product or on you to pick up the product from the customer to complete the return process.
  • End of the cancellation process and start of the return process and return workflow.

However if the cancellation request is outside of the early cancellation period then the customer does not see any return option and can instead only make a cancellation request.

User actions and journey

Kindly go through the settings explained above to set up the process once.

Your connected customer care email inbox receives an email about the cancellation.

Depending on the choice of the customer under "Return the product" the actions and process will vary.

Option 1: The customer selects "immediately" as an option to return the product.

The subscription gets the tag "cancelled by customer".

  • The auto cancel subscription setting does not play a role because even if the auto cancel subscription setting is disabled, the subscription gets cancelled because the customer has the right to cancel the subscription if the cancellation has been made within the early cancellation period.
  • The subscription status is set to "pending return".
  • The subscription additionally gets the "cancelled immediately" status.
  • The subscription additionally gets the "cancelled immediately" status.
  • The "Auto renew" button in the Subscription overview window is turned off so that the subscription doesn't renew at the end of the month.
  • Wait for the customer to return the product.
  • When the product is returned by the customer to you or has been picked up > Go to the Returns tab and mark the subscription as returned to end the subscription.

Option 2: The customer selects "after minimum duration" as an option to return the product.

If Auto cancel subscription setting is enabled > The subscription status is set to "pending return", the subscription gets the tag "cancelled by customer", the subscription additionally gets the "cancelled on end date" status.

  • The "Auto renew" button in the Subscription overview window is turned off by the circuly system.

If Auto cancel subscription setting is disabled > The subscription status is NOT set to "pending return" and remains active, the subscription gets the tag "cancelled by customer", the subscription additionally gets the "cancelled on end date" status, the subscription will go to "pending return" state when end date has arrived.

  • The "Auto renew" button in the Subscription overview window is turned off by the circuly system.
  • Now wait for the customer to return the product or for the product to be picked up.
  • When the product is returned by the customer to you or has been picked up > Go to the Returns tab and mark the subscription as returned to end the subscription.
Read more
Orders
Refund orders

Refund an order

Refund Order is a feature available in the circuly Operations Backend that you can use to refund any charged one-time payment or recurring payment.

Introduction

Refunds are a common part of any e-commerce business—whether you're dealing with cancellations, product issues, or customer dissatisfaction. With circuly, refunds can be managed efficiently while giving you full control over what gets refunded and how much.

circuly not only handles the transactional communication triggered by the refund but also allows you to customise the refund amount, taking into account factors like delivery costs, usage time, or repairs.

Tip: This process can also be automated using circuly’s API. See our API docs for more.

Article overview

  • What is Refund Order?
  • Payments that can be refunded
  • Refund options
  • Step-by-step guide for circuly users

What is refund order?

Refund order is a feature available in the circuly Hub that lets you refund any charged one-time payment, recurring payment, or buyout payment.

Important: A payment must already exist (and be charged) in order to process a refund.

When a refund is successfully processed:

  • The payment status changes to refunded.
  • A transaction refund email is automatically triggered via your Email Templates.
  • The customer receives a Refund invoice email that includes the refund invoice.

Learn more about possible payment statuses in the Payments article.
Learn more about how to process a refund in the steps below.

1. Payments that can be refunded

Refunds can be processed for:

  • Recurring payments
  • One-time payments (e.g., initial payment)
  • Buyout payments

Whenever a payment is processed, circuly creates a corresponding invoice in the Invoices tab.

Important: Refunds are performed at the invoice level, not the payment level.

To identify what type of payment you're working with, refer to the Invoice type column in the Invoices tab.

2. Refund options

You can only refund payments that have already been charged. If a payment is uncharged or scheduled for the future, the Refund button will be disabled (greyed out).

To check charge status:
Look at the “Paid” column in the Invoices tab.

If the column isn’t visible:

  • Click on the eye icon (top-right corner of the table)
  • Check the box for “Paid” to enable the column

3. Step-by-step: How to process a refund

Step 1: Find the invoice

  • Go to the Invoices tab in your circuly Hub
  • Click on the Invoice ID (coloured text) to open the invoice detail view

Step 2: Open refund options

  • Click the Refund invoice button in the invoice window

Step 3: Choose refund type

Option 1: Full refund

  • Toggle “Full refund” ON to refund the full amount tied to the customer’s email (all products).

Option 2: Use custom value

  • Toggle “Use custom value” to enter a custom refund amount.
  • Useful when deducting delivery, repair, or other costs.
  • You can also set VAT and describe the refund reason.

Option 3: Select products

  • If multiple products are associated with the same customer email, select individual products to refund by checking the boxes in the product field.

Step 4: Add message to customer (Optional)

Use the Message to customer field to add a note for the refund email.

Note: This will only show in the refund email if your Refund Invoice email template includes the variable {{description}}.

Final Step: Confirm refund

  • Double-check the refund amount (displayed on the REFUND € button)
  • Click Refund to complete the process

Once processed:

  • The payment status updates to refunded
  • A Refund Invoice is emailed to the customer
Read more
Orders
Account & Setup
failure in order placement

Common Reasons Why Your Customers Are Prevented From Placing an Order on Your Checkout

There are multiple reasons why a visitor is prevented from completing the checkout process. Learn more.

Introduction

Given below are common reasons why your customers are prevented from placing an order

1. Checkout not possible without date of birth

A prospective customer is prevented from completing the checkout if they do not fill the date of birth input field even if you have the setting for making the date of birth as a mandatory field disabled. 

Explanation: One of the many custom checkout field options available on the circuly white-label checkout is Date of Birth. You can decide to make the field a mandatory or an optional field depending on your business case. 

The date of birth custom field option is by default disabled and can be enabled If you want to ask for the date of birth of the customer on the checkout page in the Settings tab. 

However you might have noticed that your customers are prevented from proceeding to the payment page if they do not add their date of birth in the date of birth input field, even though it is not mandatory (that is the setting for making date of birth a mandatory field is disabled).

This happens if you use CRIF to do credit checks on your checkout page to prevent fraud and to check the credit worthiness of the customer. 

Date of birth is a mandatory piece of information that CRIF needs to perform the credit check.

That is why it is recommended to make the date of birth field mandatory, if you use CRIF to do credit checks.

2. Checkout not possible if the customer has reached maximum number of allowed cart items. 

Your customer is prevented from completing the checkout and advancing to the payment page if they have reached the limit of the maximum number of allowed items in the cart. 

Explanation: Your customers will be prevented from completing the checkout if they have reached the limit for the maximum number of items allowed in the cart. 

This happens when you’ve defined a value for the maximum number of cart items that a customer can proceed with to the payment page in your Settings. 

3. Checkout not possible if the customer has reached maximum number of allowed cart items of a particular SKU. 

Your customer is prevented from completing the checkout and advancing to the payment page if they have reached the limit of the maximum number of allowed items per SKU in the cart. 

Explanation: Your customers can be prevented from completing the checkout if they have reached the limit for the maximum number of items allowed in the cart per SKU 

This happens when you’ve defined a value for the maximum number of items allowed in the cart per SKU that a customer can proceed with to the payment page. 

4. Checkout not possible if the customers chosen payment method fails to be charged. 

The customer is unable to place an order if there are problems with the payment method of the customer such a insufficient card balance, wrong card details etc. 

Explanation: when your customer adds their payment details in the payment input field and clicks on the checkout button, circuly sends a payment token to your connected payment service provider to charge the payment. 

The payment service provider then tries to charge the payment. If the payment service provider is unable to do so the customer is not able to place an order due to problems with their chosen payment method. 

The reason why the payment service provider is unable to charge the payment can vary from insufficient balance to wrong information. 

When a payment fails, the customer gets either of the following prompt: 

  • Your card was unfortunately not accepted.
  • An error occurred.
  • Unable to proceed with the checkout

When an order fails due to payment reasons, you will not be able to see it in the circuly Operations Backend. You can however see an overview of your failed orders in connected your shop system. 

5. Checkout not possible due to stock limitations

The customer is unable to place an order and gets an error message of insufficient stock. 

Explanation: circuly enables you to prevent your customers from proceeding to the payment page if they have a product in the cart that is not in stock. 

There is a setting available in the Settings tab that can be enabled if you want to prevent customers from placing orders that you cannot fulfils due to stock limitations

The setting is by default disabled and can be enabled. 

6. Checkout not possible due to wrong age

A customer will be prevented from proceeding to the payment page if you set a minimum age for placing the order in your Settings tab

When a customer enters their date of birth on the checkout page, the circuly system checks the year of birth against the minimum age setting. If the age is below your defined number, then the customer is prevented from proceeding to the payment page. 

7. Checkout not possible due to invalid number

A customer can be prevented from proceeding to the checkout if they’ve inserted an invalid number in the phone input field. Enable the setting for validating phone number under Checkout in the Settings tab.

8. Checkout not possible if customer doesn't fill in the mandatory fields. 

Certain fields like Name, address and contact details are mandatory fields. In order to advance to the payment page, these fields must be filled.

There are additional fields such as company name and  VAT number that can be added to the checkout and can also be converted into mandatory fields.

When these fields are converted into mandatory fields, the customer on the checkout will be prevented from proceeding to the payment page if these fields are left blank. 

To access the additional fields > Go to Settings > Checkout > PERSONAL INFORMATION > Enable the switch for the additional fields you would like to add to the checkout > Then decide if you would like to convert them into mandatory fields. 


9. Checkout not possible due to payment failure.

Customer doesn't get to the order confirmation due to payment failure.

Read more
Customer Self Service
Accessing reported issues

Access issues reported by customer from the customer portal

Your customers have the possibility to stay in touch with you via the Customer Self-Service Portal and report issues. Learn more.

Introduction

The Customer Self-Service Portal empowers your customers to independently manage their subscriptions with ease. In the customer portal, your customers can take various actions such as cancel subscriptions, download invoices, update personal information, and report issues.

Note: the option to Report an issue is by default set to visible and is displayed in the Subscription action dropdown menu unless you decide to disable the option to report an issue in your circuly Hub Settings. To do so go to Settings > Self-Service Portal > Features > Toggle off the Allow report issue switch.

How to access issues reported by your customer

Prerequisite: In order to receive notification about issues make sure that you've added an email address under the Customer care email address setting as this is the email that receives notification about the reported issues. To learn more about the Customer care email address setting, how to enable it and information about which events trigger a notification/email to your defined email address, review this article.

The circuly system sends an email notification to the email(s) specified under the Customer care email address setting when events, like Report an issue, take place. The email is sent to your connected inbox. You can also access the information in the circuly Hub. The email History tab provides a history of all emails triggered from the circuly system. This also includes emails sent from the circuly system to to a circuly user or an email address specified under certain settings such as the Customer care email address setting for various events such as issue reporting from the customer portal.

Simply navigate to the Email History tab and use the filter function to search for the email. You can search for the subject of the email. For issues reported from the Self-Service Portal, the subject is "Customer reported an issue". Click on the email ID to see the email or hover over the eye icon for a quick preview.

Customer care email address vs Support email address setting

Similar to the Customer care email address setting there is an additional setting that lets you add an email address. The difference between the two is that while the Customer care email address is a setting used by the circuly system to send a user notifications about certain actions, the Support email address is displayed in the Self-Service Portal as follows, see image.

The option to display a support email address is optional and can be skipped. However we recommend adding a support email address as doing so gives the impression to the customer that you are reachable and that increases the customers trust in your product.

Note: If your customer uses the email to make a cancellation request then there are no automated steps or operations followed.

To update or add an email address to the Support email address setting, go to your circuly Hub > Settings > Customer login > General > Support email address > Type an email address in the input field.

Note: You can only add one email address in this input field.

Add a BCC list to get copies of all emails sent on your behalf from the circuly Operations Backend

We also recommend adding a BCC list to get copies of all emails sent from the circuly Operations Backend. 

To add a BCC list > Go to Settings > Email > General > BCC list > Click on the plus icon “+” to add an email > Repeat the step if you want to add more email addresses. 

To encourage customers to use this feature for issue reporting, it’s important to proactively inform them about its availability and provide clear, step-by-step instructions or guides on how to navigate and use the portal effectively.

In the Customer Self-Service Portal there are two ways to report an issue. You can find detailed information about these options in this guide on how your customers can report issues from the Customer Self-Service Portal.

Read more
Subscriptions
Reactivate subscription

Reactivate a Subscription

Subscriptions can be automatically (when return workflow settings are enabled) and manually reactivated. Learn more about reactivating a subscription.

Introduction

In circuly, subscriptions may automatically or manually move into an inactive state when they reach their end date or when a customer initiates a return or cancellation request. However, there are situations where a subscription needs to be restarted—for example, when the customer does not return the product on time, or when you want to reverse a cancellation. That’s where the Reactivate Subscription feature comes into play.

Feature overview

The Reactivate Subscription feature allows circuly users to manually restart a subscription that is no longer active but still eligible for reactivation. When a subscription is reactivated:

  • The subscription status is set back to “active.”
  • If applicable, recurring payments resume based on prior billing logic or updated settings.
  • Reactivation ensures continuity for subscriptions that were paused due to returns, swaps, or buyout considerations, but where the product remains with the customer.

Important rules for reactivation

  • You can only reactivate subscriptions with the status "pending return" or "pending buyout."
  • Subscriptions with the status "active," "ended," or "bought out" cannot be reactivated.
  • If auto-renewal was manually turned off, it must be enabled first before the subscription can be reactivated.
  • Reactivating a subscription can also restart recurring payments, depending on your settings.

Setting to review:
Settings > Subscriptions > Recurring Payments > Past billing dates

This setting determines if missed recurring payments from the time the subscription was inactive should be charged once the subscription is reactivated.

Step-by-step: How to reactivate a subscription

  • Log in to your circuly Hub.
  • Go to the Subscriptions tab.
  • Locate and select the subscription that needs to be reactivated.
  • Click on the three dots to open the action menu.
  • Click on "Reactivate subscription".
  • In the Reactivate Subscription window, review the message.
  • Click "CONFIRM" to complete the reactivation.

What happens after reactivation?

  • The subscription status changes to “active.”
  • Any planned or missed recurring payments are evaluated and triggered based on your system settings.
  • The customer will be charged again if the system detects unpaid cycles (based on your past billing dates setting).
Read more
Account & Setup
Subscriptions
Add swap/replacement reasons

Add Swap/Replacement Reasons

When you swap a product for an existing subscription you can specify the reason for the said action. Learn more about adding swap/replacement reasons.

Introduction

When processing a product swap within an active subscription, you can define specific reasons for the swap. These reasons serve internal communication purposes and help keep your operations team aligned on the context of product exchanges.

Feature overview

Swap reasons are shown in the Replacement Window when a swap is initiated. This makes it easy for your team to choose the appropriate reason for the product exchange and document it for future reference. Swap reasons are only visible internally and do not affect the customer’s view or experience.

Step-by-step guide: Add swap reasons

  1. Log in to the circuly Hub
  2. Navigate to the Settings tab.
  3. Go to Swapping > General.
  4. Scroll down to the Swap Reasons section.
  5. Click the plus (+) icon to add a new reason.
  6. In the input field, type the swap reason (e.g., "damaged product", "wrong size", etc.).
  7. (Optional) In the Tag after swap field, type replacement to automatically tag orders associated with this swap.

Good to Know

  • Tags help differentiate swap orders from standard subscriptions.
  • The "replacement" tag will be visible in the Order List view, making it easier to filter or search for such cases.
  • These reasons are flexible—adapt them to suit your internal processes.
Read more
Returns
Repairs
Mark as returned or mark as bought

When Should You Mark an Asset as Returned and When as Bought?

When should an asset be marked as bought and when as returned? Find out in this article.

When you process order in the Returns tab you can either "mark the asset as returned or as bought". The option you pick depends on whether the asset has been returned to you or has been bought by the customer and is not expected to come back.

Marking an asset as returned

When should you mark an asset as returned: assets that have been successfully returned to you by the customer should be marked as returned in order to stop the subscription and the recurring payments attached to it.

Note: To stop recurring payments check the box for Delete future recurring payments when you mark the product as returned in the return workflow.

What happens when an asset is market as returned: when an asset is marked as returned the asset moves from the Return List to the Repair List (If you've set up the repair process in the repair section). Since the product needs to be repaired first (at least as per the circuly system) it is not directly pushed back into stock and made available for further renting.

The asset is displayed with “to repair” status in the Asset and Repair List denoting the location of the asset.

Additionally the Subscription ended email is sent to the customer as soon as the product is marked as returned.

Marking an asset as bought

When should you mark an asset as bought: assets that are not expected to be returned to you because they have been bought by the customer should be marked as bought.

What happens when an asset is marked as bought: when an asset is marked as bought the asset moves from the Return List but doesn't end up in the Repair List because the product is bought by the customer ans is not expected to be returned or repaired.

The asset is displayed with “bought out” status in the Asset List to denote the location of the asset.

Read more
Returns
Repairs
Pending return

What is “pending return” and what does it do?

In the circuly operations backend, you’ll find the words “pending return” in multiple places. Multiple operations and workflows are either trigged through “pending return” or are dependent on it.

Introduction

In circuly, the term "pending return" appears in multiple tabs and processes within the circuly Hub. It’s not just a label—it’s a core status that plays a critical role in operations like cancellations, returns, and subscription reactivations. This article explains what "pending return" means, when and how it’s applied, what it triggers, and which settings it depends on.

What does “pending return” mean?

The status "pending return" indicates that a product is still with the customer but is expected to be returned.

You’ll see this status in the Status column of various lists in the circuly Hub, including:

  • Subscription List
  • Return List
  • Asset List
  • Email History
  • And others like Orders, Payments, Recurring Payments, etc.

What does "pending return" do?

If the status of a subscription is not set the to "pending return":

  • The subscription stays active, and payments continue unless manually paused or canceled.
  • The return process will not begin.
  • The product will not appear in the Returns tab, and follow-up actions (like sending return emails) will not be triggered.

Setting the status to “pending return” is essential to:

  • Start the return workflow.
  • Give the customer a defined window to return the product.
  • Potentially trigger reactivation and charges if the product is not returned.

Why is a product “pending return”?

When a subscription is marked as pending return, it means the customer has the product but hasn’t returned it yet. This could be because:

  • The subscription period is still ongoing.
  • The return is within the allowed Return until period.
  • The customer is delayed in sending it back.
  • The customer changed their mind and wants to continue the subscription.
  • The customer is not planning to return the product.
  • In rare cases, the customer may be fraudulent.

Regardless of the reason, you expect the product to come back. If not, you must have safeguards in place—like reactivating the subscription to continue charging the customer.

Automatically set to “pending return”

circuly will automatically update the subscription status to pending return in the following scenarios:

  • Subscription end date is reached and auto-renew is turned off.
  • Customer cancels via the Self-Service Portal, and the setting to auto-trigger pending return is enabled.
  • Swap is initiated, either by the customer or from the circuly Hub (in this case, the status becomes “pending replacement”, which follows the same logic as pending return).
  • Manual cancellation of the order from the circuly Hub.
Exception: If the product is marked as stolen/missing during a swap, the status is not set to pending return—because you no longer expect the item to come back.

Manually set to “pending return”

You may need to manually assign the pending return status in the following cases:

  • A circuly user manually marks the subscription as pending return from the Subscription List.

Doing so triggers the return workflow, including return instructions and tracking.

What does “pending return” trigger?

When a subscription is marked as pending return, circuly triggers the following actions:

  1. The subscription appears with the status “pending return” in the Subscription List.
  2. The order/product is listed in the Returns tab under the same status.
  3. If return-related settings are configured (see below), circuly starts the return timeline.
  4. If the product is not returned within the Return Until Period, circuly can reactivate the subscription and resume recurring charges—only if the Reactivation settings are enabled.

Key settings connected to “rending return”

To make the “pending return” workflow work efficiently, configure the following in Settings > Subscriptions > Cancel Subscription:

  • Return Until Period: Number of days a customer has to return the product.
  • Reactivate Subscription: Enable to automatically reactivate subscriptions if the product isn’t returned.
  • Reactivate Subscription Period (days): Defines when the reactivation should happen after the return window ends.

Learn more about the return workflow and the assoiciated settings here.

Read more
Account & Setup
Returns

The Return Workflow and the Associated Settings

What does the return flow look like in the circuly operations backend and which settings are associated with it?

Introduction

Product returns are a key part of running a subscription business. In circuly, returns can happen for various reasons—like swaps, cancellations, or when a subscription ends. Some return processes are fully automated, while others require manual steps.

This article explains the different return scenarios, what actions you or your team need to take, and which settings control how circuly handles each case.

Info: The return workflow ensures that when a subscription ends or when a customer requests a cancellation or swap you either receive the product back, or you resume charging the customer if the product is not returned within a specified time frame.

Scenario 1: Swap return workflow

When a customer requests a swap, circuly automatically sets the status of the product currently with the customer to Pending replacement (this has the same effect as "Pending Return").

At the same time, circuly creates a new order for the replacement product.

The customer receives a Swap Confirmation Email with instructions on how and when to return the original product. The customer must return the product within the time period you’ve defined in your settings (called the Return Until Period).

If the product is not returned within that period, circuly can automatically reactivate the original subscription and resume charging recurring payments, depending on your settings.

What you need to do:

  • No manual action is required unless you're managing the swap order manually.
  • Ensure your email template for swap confirmations is set up and that your return settings are correctly configured.
Info: For a detailed guide on return settings, scroll down to the Return settings to configure section.

In addition to the general return settings, you can also configure specific options that apply only when the product return is triggered by a swap request. Follow this guide to learn more.

Scenario 2: Cancellation before subscription end date

If a customer requests to cancel their subscription before the scheduled end date, the return workflow must be started manually.

To begin the return process, you need to manually change the subscription status to "Pending Return" in the circuly Hub. Once marked as pending return, circuly automatically sends the Subscription pending return email to the customer with return instructions.

From that point, the same return rules apply: the product must be returned within the Return until period. If it isn’t, circuly will reactivate the subscription based on your reactivation settings.

What you need to do:

  • Manually set the subscription status to "Pending Return"
  • Ensure your return and reactivation settings are configured
  • Mark the product as returned once the product as been returned to your warehouse.
Info: For a detailed guide on return settings, scroll down to the Return settings to configure section.

Scenario 3: Return at the end of the subscription period

When a subscription naturally reaches its end date, circuly automatically sets the subscription status to "Pending return"—no manual action is required.

The customer should receive the Subscription almost over email ahead of the end date. This email should contain the return instructions.

The customer is expected to return the product within the number of days defined in your Return until period setting. If they don’t return the product in time, circuly will automatically reactivate the subscription and resume charges, if that setting is enabled.

What you need to do:

  • Nothing manual is required, as long as your settings and email templates are correctly set up.
  • Mark the product as returned once the product as been returned to your warehouse.
Info: For a detailed guide on return settings, scroll down to the Return settings to configure section.

Return settings to configure

These three settings control how circuly handles product returns and subscription reactivations:

  1. Return Until Period
    • Defines how many days a customer has to return the product after the status changes to or is set to pending return or replacement
    • Go to: Settings > Subscriptions > Cancel Subscriptions
  2. Reactivate Subscription (toggle switch)
    • Enable this if you want circuly to automatically resume charging if the product isn’t returned
  3. Reactivate Subscription Period (days)
    • Set how many days after the Return Until Period circuly should wait before reactivating the subscription

Example

Let’s say:

  • Return Until Period = 14 days
  • Reactivate Subscription = Enabled
  • Reactivate Subscription Period (days) = 7
  • Subscription End Date = April 1

In this case:

  • The customer has until April 15 to return the product
  • If they don’t return it, circuly will reactivate the subscription on April 22
Read more
Email Templates
Email setup

Set Up an Email Template

Email templates can be edited in the circuly operations backend.

Introduction

circuly helps you automate important customer communication through transactional emails. These emails are directly tied to certain events in your rental business — for example, when an order is placed, a payment is processed, a subscription renews, or a return is initiated. Once the event occurs, circuly automatically sends out the appropriate email to your customer.

Important:

  • circuly only supports transactional emails, not promotional or marketing emails. For newsletters or promotions, please use a dedicated marketing automation tool.
  • Email templates in circuly can be set up in multiple languages based on your allowed language settings. If a template in the customer’s preferred language is missing, circuly will use the default language template. instead. However, if a template is missing in both, the email won’t be sent.
Review this article to gain a deeper understanding of what default, allowed and preferred language is and how they are used by circuly.

Setup Overview

Here’s how circuly’s email templates work and what you can do with them:

Types of Emails

Most of the transactional email templates in the circuly Hub fall under four key categories:

  • Orders
  • Payments
  • Subscriptions
  • Returns

(Some templates also exist outside these categories, which you can configure similarly.)

Customisation Options

  • Edit the subject line and body: Include placeholders (variables) to dynamically pull customer or order data. Note: not all variables are available for every template.
  • Custom HTML & CSS: Style the emails to match your brand’s look and feel.
  • Multiple languages: Set up templates in the languages you’ve enabled in your circuly settings.

Search & Organisation

  • Use the search bar on the Email Templates page to quickly find a specific template by name or keyword — helpful if you manage many templates across languages and events.

Step-by-Step Guide

1. Navigate to Email Templates

  • Log into your circuly Hub.
  • Click on Email Templates in the left navigation bar.
  • You’ll see template titles arranged in rows and languages in columns.

2. Create a New Email Template

  • Find the email and language you want to set up, then click Create Template.
  • Decide on the type of template:
    • Blank Template:
      • Start from scratch using your own HTML & CSS.
      • Add any available variables.
      • Use the Preview button to check the look.
    • circuly Predefined:
      • Use a preset template that’s easier to customise.
      • Already styled and includes a basic subject and body — you adjust to fit your brand.
  • Click the save icon to either save progress or finalise the template.

3. Edit or Modify Existing Templates

Change the subject line

  • Hover over an existing template, click the pencil icon to edit.
  • Navigate to the email Subject in the top right.
  • Type your new subject and click save.

Add or remove variables

  • In the edit view, click the Variables button to see the available variables.
  • Click the copy icon next to a variable, then paste it into your HTML wherever you want it displayed.

Note: Variables are tied to specific templates, so not every variable is available everywhere.

4. Customise the Design

Add your logo

  • In circuly’s predefined templates, look for the <img> tag with the class="logo".
  • Replace the src with your logo URL.
  • Optionally adjust the height (default: height="36").

Use your custom font

Step 1: Preconnect in the <head>:

The code is used in HTML to include a font from Google Fonts. It helps by establishing a connection to the font server in advance, allowing faster loading. It also ensures cross-origin access for the font resources. The code specifies the font URL and loads the font stylesheet.

Place the following snippet within the <head> section.

  • <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    <link href="https://fonts.googleapis.com/css2?family=Neue+Montreal:wght@400&display=swap" rel="stylesheet">

The third <link> tag specifies the URL of the font file you want to use. Modify this tag to link to your font from Google Fonts. For example, you can change the family attribute value to the desired font and weight.

Step 2: Import the font

The CSS code snippet provided in our example is used to define a custom font. It allows you to specify the font family name and the source URL or path where the font file is located.

Import the source url of your chosen font (f.g. from Browse Fonts - Google Fonts )

Step 3: Style specific class attributes with your customised font

Styling specific classes allows you to target and apply styles to specific elements within your HTML structure. By using classes, you can selectively style certain elements while leaving others unaffected. This provides more control and flexibility in designing your template. It allows you to create consistent styles across multiple elements that share the same class, without affecting other elements on the page. (In our example we have styled the custom font for the card-header element)

Identify the elements in HTML that you want to style and apply the font rule within the CSS section for this specific class.

Use colour codes: Styling text colour with CSS

Using colour codes in the hexadecimal format #ff0000or rgb(255, 0, 0) - both serve the purpose of defining colours. However, there are a few reasons why using hexadecimal colour codes is considered more advantageous because of its simplicity, memorability, flexibility, and compatibility with CSS. In our given example, the color of the text inside the <h2> element is styled using CSS. The colour property is set to #ff0000, which represents the hexadecimal value for the colour red.

To Do:
Pick your hexadecimal colour (f.g. HTML Color Picker) and apply the colour code as a rule to your CSS element

Set up links: Create clickable hyperlinks

To use a link in HTML, you need to use the <a> element, which is used to create clickable hyperlinks.In our example, the email address "example@circuly.io" is added as a mailto link within the <a> element. This allows users to click on the link to open their default email client with a pre-filled email to that specific address.

To Do:

Set the <a> element to create the link, specifying the destination URL or relative path in the href attribute and add the desired link text. Use <a href="URL">Link Text</a> as a general link or <a href="mailto:EMAIL">Link Text</a> as a mail link.

Set up images: Integrate your custom images

To add an image to your HTML document, use the <img> tag. Place the tag where you want the image to appear within the HTML structure.

In our example we have the class attribute assigned to the image tag. It specifies a CSS class name ("image-main") that can be used to style the image using CSS later on. The src attribute specifies the source of the image. In this case, the image source is a URL pointing to an image file hosted on the web.

To Do:
Use <img src="URL" alt="Description of the image"> and set the URL of your hosted image.
If desired, delete unwanted default circuly images by removing the <img> tags.

Edit the footer section: Modify the footer section

Our example HTML shows a <section> element with the class attribute class="card", which can serve as a container for your footer content. Within the section, there is a nested structure consisting of <div> elements with various classes for styling purposes. The innermost <div> with the class attribute class="card-body--image" contains the actual content of the footer. It includes a <strong> element for emphasising the text "We are here to help you," followed by plain text and an <a> element for adding a hyperlink. The relevant CSS styling classes for the provided code snippet are .card-body .card--list and .card-body--image

To Do:

If desired, modify the text and hyperlink in HTML or if you want to change the image to a custom picture, you can replace the 'URL' in the background-image CSS property with the URL of your custom image.

Style buttons: Modify clickable buttons

In our HTML example, the button's URL is dynamically populated by a variable called shop_url. This variable is used within the href attribute of the <a> element to determine the destination to your shop when the button is clicked. While the current default implementation uses the shop_url variable to automatically populate the button's URL, it is technically possible to replace this variable with any other URL redirection. Within the CSS below you can easily modify the styling of the button, such as background colour, text colour and shape.

To Do:

If desired, modify the text in HTML and button design in CSS.

Style boxes: Modify text boxes

Within the one-time password and refer a friend template, per default we have set up boxes to highlight the OTP and voucher code.In our example of the OTP template, the default HTML represents a paragraph element (<p>) with the class otp-backdrop. Inside the paragraph, there is a placeholder ({{otp_code}}) that suggests the usage of a variable to dynamically populate the code content.Within the CSS below you can easily modify the styling of the box, such as background color, text color and shape.

To Do:

If desired, modify the box design in CSS. Please do not replace the default variable.

Read more
Account & Setup
Exports

Export Data from the circuly Hub

What happens when you export Orders, Subscriptions, Transactions, Customers and Recurring Payments?

When you want to export certain data from the operations backend, you can do so by:

  • Select the tab you want and click on the export button in the list view.
  • When you press the export button, a pop-up window pops up that says that the export request is in progress and you will be notified when the export is ready.
  • The notification for the export being ready is in the notifications panel in the top right corner of the operations backend window.



  • When you click on the bell icon, the notification panel will say that your export is ready. This means that all the data that you wanted to export has been pulled and is ready for download.



  • Click on the notification to get to the file download window.



  • And click on the DOWNLOAD CSV button to download the file.


Note: when the “Export underway” window says that “you will be notified when the export is ready to download”, this doesn’t mean that you will be notified via email. The notification about the export being ready will be in the notification panel.


In case the notification doesn’t pop up, then the most likely reason for that is that your session has timed out. Simple login again and check the notification panel.

Watch the video tutorial:

Read more
Subscriptions
End date extension

Extend Subscription End Date

Read more about extending the subscription end date.

Introduction

In some cases, you may need to extend or adjust the end date of a customer's subscription. This could be due to service delays, special agreements, or customer requests. The circuly Hub allows you to manually update the subscription's end date without altering other subscription parameters.

Step-by-step guide: Change subscription end date

  • Navigate to the Subscriptions Tab
    • Log in to your circuly Hub.
    • Click on the Subscriptions tab from the left navigation menu.
  • Open the Subscription Details
    • Locate and select the subscription you wish to update from the Subscription List.
  • Open the Change Subscription Duration Menu
    • Inside the detailed subscription window, click the three-dot menu in the top right corner (next to the Auto Renew button).
    • Select Change Subscription Duration from the dropdown.
  • Adjust the End Date
    • In the popup window, check the box labeled "Change end date only" if you do not wish to alter the minimum contract period.
    • Choose the new desired end date using the calendar picker.
  • Submit Changes
    • Click on SUBMIT CHANGES to save your modifications.

Good to know

  • This feature only changes the subscription end date. It does not modify billing or minimum contract duration unless explicitly adjusted.
  • The change is applied immediately and reflected in the subscription details.
  • Auto-renew settings remain unchanged unless manually disabled or modified.

For questions or further adjustments, reach out to the circuly support team via the service desk.

Read more
Returns
Return

Process a Return Request Made by the Customer

When you get a return request from your customer either via email or via the customer login, there are two different ways to process the request.

When you get a return request from your customer either via email or via the customer login, there are two different ways to process the request.

NOTE: the process is not interchangeable as the workflows for the return request depends on how the request was made, that is was it via email or via the customer login.

In this article, we will cover both topics.

Return request made via email

When you get a return request via email. Follow these steps to process the return request:

  • Login into your circuly operations backend.
  • Go to “Subscriptions”.
  • Either select a subscription from the “Subscription List” or search for the customer name (or any other information you have about the customer who made the request) by using the “Search” input field.
  • Once you have the subscription, open it by clicking on it.
  • Click on the “Three Dots” in the top right corner and select “Set status as pending return” from the list.
  • When the subscription is set to pending return, the customer receives the “Subscription Pending Return” email from the “Email Templates”. The “Subscription Pending Return” email contains the return instructions for the subscription product that the customer will use to return the product to you.
  • Wait for the product to come back to you.

Note: The subscription is still active as the product hasn't been returned to you. Once you receive the product, you have to end the subscription in the operations backend. To end the subscription follow the steps given below:


  • Go to “Returns” and search for the returned product in the "Return List”.
  • Click on the product that you know has been returned and in the “Return Handling” window confirm your action by pressing the button that says “MARK AS RETURNED”.
  • The subscription is automatically cancelled and the “Subscription Status” is updated to “ended”.
Read more
Payments
One-time payment

How to Charge A One-Time payment?

Charge one-time transactions easily from your circuly operations backend.

Your customers may get a speeding ticket for their car subscription or require repair support for which you need to charge a one time transaction. What do you do when you need to charge your customers an extra amount besides their recurring payment?

To charge a one-time payment follow the steps given below or wathc the video tutorial:

  • Log in to your circuly operations backend and go to Orders.
  • Select the order that you want to edit from the Order List and click on it to display the order details.
  • Click on the three dots in the upper right corner and select One-time payment from the list.

  • In the One-time transaction window start with the Title input field and use this field to describe what the one-time payment is for. Then insert your desired values in the other input fields.
  • Enter a message in the Message to customer input field if you wish to provide more information to the customer about the one-time payment. The customer will be automatically notified via email about the charge and the message that you type into the open text field will be added to the email.
  • Click on CHARGE xx.xx € to confirm.
Note: The input value in the Message to customer field is only included in the email if you've added the required email variable, that is {{description}}, in the One-time transaction email template.
Read more
Payments
Failed payments

How to Retry a Failed Payment?

A typical situation in subscriptions is failed recurring payments. Here's how circuly handles failed payments.

Introduction

A common situation in subscription e-commerce is dealing with failed recurring payments. Customers may miss a payment for a number of reasons — from insufficient funds to expired cards — and handling those cases efficiently is critical for healthy subscription operations.

Feature overview

When a recurring payment fails, the circuly system automatically attempts to retry the payment based on the settings you define. This reduces the need for manual work and ensures revenue collection doesn’t stop due to temporary issues.

Typical reasons for payment failure

  • Expired card details
  • Insufficient funds
  • The customer’s bank blocked the charge (fraud prevention)

The exact reason is displayed in the Recurring Payment List under the Failed Reason column. This is the same reason shown in your Payment Service Provider (PSP) dashboard.

Important:
If the Payment Settled column shows “X" (a cross) this does not mean the payment failed. It just means the payment hasn’t been charged or settled yet (e.g. the charge date is in the future).

What happens when a payment fails?

If your settings allow it, circuly will retry the payment automatically. This can include:

  • Number of retry attempts
  • Time between each retry
  • Whether or not the customer is notified
  • Auto-cancelling the subscription if multiple retries fail

These actions are powered by the settings below.

Settings for handling failed payments

Follow this guide on failed payment settings.

What If the payment still fails after the final retry?

If the last retry fails:

  • The payment stays in failed status.
  • Your customer support team is notified via email, so they can follow up.

Retrying failed payments manually

Yes, you can retry failed recurring payments manually, even after all automatic attempts are exhausted.

How to retry manually:

  1. Go to the Subscriptions tab.
  2. Search for the subscription with the failed payment.
  3. Scroll to RECURRING PAYMENTS in the subscription details.
  4. Locate the payment with status failed under Payment Settled.
  5. Click the three dots > Select Charge Recurring Payment.
  6. Accept the terms and press CHARGE xx.xx €.

The payment status will now update to “Yes” under Payment Settled.

When should you retry manually?

Only retry a payment manually when:

  • The customer has confirmed that their payment method has been updated.
  • You’ve coordinated the retry directly with the customer.
Read more
Payments
Refund

How to Process a Refund in the circuly Operations Backend?

Processing a refund in the circuly operations backend is not only easy but specially designed for subscriptions.

Introduction

Refunds are a common part of any e-commerce business—whether you're dealing with cancellations, product issues, or customer dissatisfaction. With circuly, refunds can be managed efficiently while giving you full control over what gets refunded and how much.

circuly not only handles the transactional communication triggered by the refund but also allows you to customise the refund amount, taking into account factors like delivery costs, usage time, or repairs.

Tip: This process can also be automated using circuly’s API. See our API docs for more.

Article overview

  • What is Refund Order?
  • Payments that can be refunded
  • Refund options
  • Step-by-step guide for circuly users

What is refund order?

Refund order is a feature available in the circuly Hub that lets you refund any charged one-time payment, recurring payment, or buyout payment.

Important: A payment must already exist (and be charged) in order to process a refund.

When a refund is successfully processed:

  • The payment status changes to refunded.
  • A transaction refund email is automatically triggered via your Email Templates.
  • The customer receives a Refund invoice email that includes the refund invoice.

Learn more about possible payment statuses in the Payments article.
Learn more about how to process a refund in the steps below.

1. Payments that can be refunded

Refunds can be processed for:

  • Recurring payments
  • One-time payments (e.g., initial payment)
  • Buyout payments

Whenever a payment is processed, circuly creates a corresponding invoice in the Invoices tab.

Important: Refunds are performed at the invoice level, not the payment level.

To identify what type of payment you're working with, refer to the Invoice type column in the Invoices tab.

2. Refund options

You can only refund payments that have already been charged. If a payment is uncharged or scheduled for the future, the Refund button will be disabled (greyed out).

To check charge status:
Look at the “Paid” column in the Invoices tab.

If the column isn’t visible:

  • Click on the eye icon (top-right corner of the table)
  • Check the box for “Paid” to enable the column

3. Step-by-Step: How to Process a Refund

Step 1: Find the invoice

  • Go to the Invoices tab in your circuly Hub
  • Click on the Invoice ID (coloured text) to open the invoice detail view

Step 2: Open refund options

  • Click the Refund invoice button in the invoice window

Step 3: Choose refund type

Option 1: Full refund

  • Toggle “Full refund” ON to refund the full amount tied to the customer’s email (all products).

Option 2: Use custom value

  • Toggle “Use custom value” ON to enter a custom refund amount.
  • Useful when deducting delivery, repair, or other costs.
  • You can also set VAT and describe the refund reason.

Option 3: Select products

  • If multiple products are associated with the same customer email, select individual products to refund by checking the boxes in the product field.

Step 4: Add message to customer (Optional)

Use the Message to customer field to add a note for the refund email.

Note: This will only show in the refund email if your Refund Invoice email template includes the variable {{description}}.

Final Step: Confirm refund

  • Double-check the refund amount (displayed on the REFUND € button)
  • Click Refund to complete the process

Once processed:

  • The payment status updates to refunded
  • A Refund Invoice is emailed to the customer

Read more
Account & Setup
tags

Explained: Tags and Tag Date

What are tags and how to use them.

Introduction

Tags in the circuly Hub are internal tools that help you manage and track order statuses and actions efficiently. By attaching descriptive tags and relevant dates to orders, teams can collaborate better, maintain clarity, and streamline rental operations—without relying on memory or external documentation.

Tip: You can automate tag updates via circuly's Customer API. See API Docs

Feature overview

  • Tag: A keyword that describes the current status or required action for an order.
  • Tag Date: The date associated with the tag, often representing when the tagged action should occur.
  • Tags are visible only in the circuly Hub and do not impact the customer experience, payment schedule, or subscription logic.

Tags provide visual and operational clarity. For instance, a tag can indicate whether a product has been delivered, picked up, or is lost. Used effectively, tags reduce ambiguity and improve team communication.

Common tags (examples)

The following tags are predefined but can be customised according to your internal processes:

  • Delivered – Product has already been delivered.
  • Delivery – Order should be delivered on the tag date.
  • In clarification – Issues with customer data; action needed.
  • Lost – Product is considered lost.
  • Pick-up – Product is scheduled for pick-up.
  • Picked up – Product has been picked up.
  • Replaced – Product has been replaced.
  • Replacement – Replacement is required or ongoing.
  • Test-order – Internal or non-customer test order.

Note: Tags do not alter buffer times, delivery times, subscription start dates, or payment dates.

Step-by-step guide: How to Add or Edit Tags

  1. Go to Orders in the circuly Operations Backend.
  2. Locate and click on the relevant order.
  3. On the right side of the order detail view, find the tag section.
  4. Select a tag from the dropdown menu.
  5. Choose a Tag Date from the date picker.
  6. Click SAVE CHANGES.

If you use a "Delivery Date Picker" in your checkout process, the selected delivery date will automatically populate the tag date field.

Good to Know

  • Tags are visible only internally—they do not affect the customer's experience.
  • Tags do not override existing settings or system values (e.g. delivery time or order status).
  • Tags are especially useful in multi-user environments to ensure alignment.

FAQ

Q: Can tags affect order processing logic or subscription activation?
A: No. Tags are only visual and for internal tracking. They do not impact any backend logic.

Q: Can we define our own tags?
A: While common tags are predefined, your team can adopt your own internal definitions.

Q: Can we automate tag assignments?
A: Yes. Use the circuly Customer API to update tags programmatically.

Tip: This process can be automated via our customer API. This is the PUT request you can use https://api-docs.circuly.io/docs/customers-api-docs/pgyucirl7m7fh-update-order-s-tag to update the order tag.

What Is a Tag?

A tag is a keyword assigned to a piece of information that helps describe it visually and allows it to be easily found. In the circuly operations backend a tag is a keyword assigned to an order. Accompanied with the tag date, a tag describes what action needs to be taken or is currently active and the date associated with that action. Every order can have a tag and a tag date attached to it.

Tags main purpose is to see the associated action of an order at first sight. In order to gain a better overview of the status of your orders you can add tags to each order. The additional information serves your team e.g. to assure everyone working in the system directly knows the handling status/fulfilment timeline regardless of an external additional document, a single person's memory or additional assumption being made based on other information. Tags are solely for internal use and do not change anything for the consumer. Using tags also does not influence the information and pre-set e.g. buffer time/delivery time, order date or subscription date started, payment date.

The different tags can be interpreted as follows - however can also be given a different definition within your team:

  • Delivered: the product has been already delivered.
  • Delivery: delivery, as the name suggests, means that the order is a delivery order that should be delivered to the customer by the date highlighted in the tag date.
  • In clarification -  there is an issue with the customer data - requires action/ see notes for further information.
  • Lost: the product is lost and is not expected to come back.
  • Pick-up: the order is to be picked up by the customer e.g. if you have a store or if it has to be picked up at the refurbisher
  • Picked up: the order has been picked up.
  • Replaced: the product has been replaced.
  • Replacement: replacement means that the order has to be replaced or is in the process of replacement.
  • Test-order: the order is a test order and not a real order.

What is a Tag Date?

A tag date simply represents the fulfilment timeline of the tag.

How to Add Tags and Tag date?

Tags can be added and edited for an order in the Order List. You can find the Order List by navigating to Orders in the left navigation bar. To add a tag follow the following steps:

  • Locate an order in the Order List and click on it.
  • in the Order detail view, the option to add/edit a tag is on the right side of the displayed view.
  • Select a tag from the tag dropdown menu
  • Select a tag date from the date picker.
  • Click on SAVE CHANGES

Note: If you have a "Delivery Date Picker" in your checkout, the selected delivery date will be used for the Tag date value for the order in question.

Conclusion

Tags and tag date are meant to be used for internal operations. They do not have any affect on the order or customer data. If there are multiple users of the operations backend, tags can help in efficiently managing rentals by providing a visual aspect.

Read more
Vouchers
Voucher creation

Create vouchers in the circuly Hub

Create a voucher in the circuly backend for single or multi-use purposes.

You can create vouchers directly in the circuly Hub. The voucher creation functionality allows you to customise various parameters, such as the voucher code's validity period, the voucher amount, and even link the voucher to a specific customer.

How to create vouchers in circuly

  • In your circuly Hub > navigate to the Vouchers tab in the left navigation bar.
  • Click on the + Create voucher button to create a new voucher.

  • In the Create Voucher window, fill in the details and click on the Create voucher button to save the voucher.

  • The new voucher will appear in the Voucher list. 1307113071
  • To copy the voucher code, hover over the voucher of your selection and click on the copy icon under Voucher Code.

Instructions and explanation for filling the input fields

  • Voucher Name: Select a name that will help you and your team distinguish the voucher from other vouchers in the system and in use. Create an internal guide for voucher names that all your team members can use. The voucher name is only meant for internal use.
  • Description: Provide a clear and concise description of the voucher, outlining its purpose or specific use case. This helps your team understand the context or intention behind the voucher at a glance. While optional, including a description can be useful for tracking and managing vouchers effectively, especially when multiple team members are involved. The description is for internal use only and will not be visible to customers.
  • Voucher code: The code is what your customers will see and use during checkout. You can create codes using a combination of letters, numbers, and special characters. To make the code more engaging and effective, use actionable and descriptive formats like 10%BIGDISCOUNTor 20%LASTOFFER. These types of codes clearly communicate the discount amount and create a sense of urgency or exclusivity, which can help drive higher conversions.
  • Discount type: In the circuly operations backend you can decide between offering a fixed amount such as €30/€40/€50 or percentage like 20%/50%/76%, to your customers. Choose the one that fits your business case best.
  • Discount amount: After selecting the discount type, select the discount amount or discount percentage.
  • Minimum Cart Value: To make the voucher code usage conditional on the cart value, enter a numeric amount in this field. The voucher code will only be applied successfully if the customer's cart meets or exceeds this specified value.
  • Voucher-Specific Email: To restrict the use of the voucher to a specific email address, enter the desired email in this field. The voucher code will only be valid for a customer using the exact email address provided.
  • Limit bought tent: Limit the use of the voucher code to specific products. Available options:

    - All
    : the voucher code can be used for all products.
    - Bought
    : the voucher code can only be used if the cart contains bought that is one-time purchase products.
    - Rent
    : the voucher code can only be used if the cart contains rental/subscription products.
  • Recurring discount checkbox(s): Available options:

    - Apply discount to initial payments and all recurring payments
    : The discount amount/percentage will be applied to all transaction amounts in a particular subscription. For example, if you want to offer a  20% or 20€ discount to a customer who has rented a product from you for (let's say) 12 months, with a monthly payment of 50€, then 20% or 20€ will apply to every monthly transaction.
    - Apply discount to initial payment only:
    Use when you want to offer your customer a one time discount on their entire cart value. The one time discount applies only to the very first payment and every payment after that will be of the original amount.
  • Expiry Date: Set an expiration date for the voucher.
  • Limit voucher to one time use: If you do not want to restrict the voucher to an email address but still want to limit the use of the voucher code to a single person, you can check the "Limit voucher to one time use" checkbox.
  • Valid checkbox: The "Valid" checkbox determines whether the voucher is active and can be used. If checked, the voucher is valid and available for customers to redeem; if unchecked, the voucher is inactive and cannot be used.
  • Product filters: Restrict the use of the voucher code to specific products by applying product filters. You can use the "Include" option to specify the products the voucher can be applied to or the "Exclude" option to list products where the voucher cannot be used. This feature allows for targeted promotions, such as offering discounts on a new product launch or excluding discounted items from additional voucher use.
Read more
Admin
Retailer portal

circuly Retailer Portal & Point of Sales

Discover how Circuly’s Retailer Portal streamlines subscription orders for retail employees, with easy management and integration with the self-service portal.

Introduction

circuly’s Retailer Portal is a new, simplified solution that enables you to empower your retailers to create subscription orders without the complexity of accessing the full circuly Hub.

Here are a few use cases of how you can employ the retailer portal:

In-store orders and physical locations:

  • Retail employees can create orders for customers who walk into the store.
  • A company may want to push for subscriptions in their physical stores. In this case, employees don’t need full system access but just an easy way to create an order, with management handled by someone else.

Multiple locations:

  • A company with several stores can give each one its own portal, making it easy to manage orders at each location.

Sign-up with in-store verification:

  • A company can allow customers to sign up via a contact form, but the order can only be finalised once the customer comes to the store, verifies their ID, and completes the process in person.

Feature overview

Once an order is created through the portal, it follows the same logic as all other orders, including cancellations, swaps, buyouts, payment retries, and more—based on the settings you’ve configured in your circuly Hub.

Here's a brief overview:

  • Retailer profiles creation: you create retailer profiles in the circuly Hub.
  • Login credentials: you share the login credentials (location ID, password) and the retailer portal login URL with the retailer.
  • Order creation: Retailers log into the Retailer Portal and can easily create subscription orders in a simplified environment.
  • Prefilled checkout link: Once an order is created, it is sent as a prefilled checkout link to the customer in an email and the link is also available to the retailer in case the customer wishes to finalise the order on the device of the retailer.
  • Customer finalistion: The customer finalises the order by adding their payment details.
  • Order confirmation: After the customer completes payment, the order appears in the circuly Hub.
  • Same logic and workflows: The order follows the same cancellation, swap, buyout, and payment retry logic as other orders in circuly.

Step-by-step setup guide

Here's an overview of the steps:

  • Set up your retailer portal
  • Create retailer profiles in the circuly Hub.
  • Make products available in the retailer portal.
  • Share login credentials with the retailers.
  • Order creation process for the retailers.

- Set up your retail portal:

Customise the retailer portal with theming. These customisations control how the it appears to your retailers and its users, ensuring a consistent brand experience.

  • In your circuly Hub > Go to the Theming tab.
  • Add Logo: Upload your company’s logo to appear in the Retailer Portal.
  • Add Favicon: Upload a favicon to represent your brand in the portal’s tab.
  • Customise other options: Set other available customisation options to match your branding, such as colors and fonts.
  • - Creating retailer profile in circuly Hub:

    • In your circuly Hub > Go to the Retailers Tab.
    • In the Retailers window > Click on the + Create retailer button.
    • In the Create retailer window > Add the retailer details such as name, location ID, password & address.
    • Turn on the switch to make the retailer 'Active' so they can log in.

    - Make products available in the retailer portal:

    • In the circuly Hub > Go to the Products tab.
    • Select the products you want to make available in the Retailer Portal.
    • Click on the Edit button for each product.
    • Scroll to the right and enable the switch under Allow Order Create.
    • Only the products with this switch enabled will be shown in the Retailer Portal for order creation.

    - Share login credentials with the retailers

    You need to share the login details with the retailer. To do that > Go to Settings > Company settings > Company data > Retailer domain. Share this URL with the retailer along with the location ID and the password.

    - Retailer login and order creation process:

    • In the Retailer Portal > Log in using the location ID, and password.
    • Click on Create New Order.
    • Choose the product, variant, quantity, and subscription start date. Repeat the process to add more products tp the same order.
    • Add the customer’s shipping and billing address and contact details.
    • In the Review window > Review the order and click on the Create Order button.
    • The customer receives an email with a pre-filled checkout link to finalise the order by adding their payment details.
    • Once the order is finalised by the customer > The order appears in the circuly Hub and is processed like any other order.

    The Retailer Portal makes it easy for retailers to create subscription orders without needing access to the full circuly Hub. It’s simple, works on all devices, and integrates with the customer self-service portal, streamlining the order process.

    FAQ's

    Will the customer have access to the self-service portal if the order originates from a retailer?
    Yes, all orders created through the Retailer Portal are fully integrated with the customer self-service portal, so customers will have access to manage their subscription, update details, and track their orders.

    Can I control which products are available in the Retailer Portal?
    Yes, you can control which products are available in the Retailer Portal, but this applies to all retailers. You manage the product selection centrally in the circuly Hub.

    What happens if a customer doesn’t complete the checkout process?
    If the customer doesn’t finalise their checkout, the order will not appear in Circuly, but it will be visible with the status "Open" in the Retailer Portal. Retailers can follow up with the customer and encourage them to complete the order.

    Can I restrict which retailers can access certain products?A: No, product availability is controlled globally for all retailers. You cannot restrict specific products to individual retailers, but you can control which products are available across all retail locations.

    Read more
    Customer Self Service
    Refer a friend

    Refer a Friend Feature Setup & Settings

    Refer a friend is a feature that allows your existing customers to get some monetary incentive for encouraging other people to become your customer. Read more

    Introduction

    The Refer a friend feature in circuly allows your existing customers to share unique voucher codes with their friends. When a friend uses the voucher code during checkout, they receive a discount—and the referring customer earns a reward, added to their account balance.

    This win-win setup helps you acquire new customers while rewarding loyal ones.

    Feature overview

    • Customers with active subscriptions (past the early cancellation period) see a Refer a Friend button in the Self-Service Portal.
    • A unique voucher code is generated for each eligible customer.
    • When a friend uses the code during checkout, they receive a discount.
    • The referring customer receives a reward added to their account balance, used toward future recurring payments.
    • Both reward and discount amounts, as well as voucher validity, are fully customisable in the settings.

    Step-by-step guide

    Step 1: Enable the feature

    • Go to the Settings tab in your circuly Hub.
    • Navigate to Refer a Friend.
    • Toggle Enabled to turn on the feature.
    • Define the values:
      • Reward amount: Amount the referring customer receives.
      • Voucher amount: Discount given to the new customer.
      • Valid until days: How long the voucher remains valid (in days).

    Step 2: Set up email templates

    • Go to Email Templates.
    • Scroll to Refer a Friend and click Create Template (choose language if applicable).
    • Also update your Order Confirmation, Invoice, and One-time Transaction templates:
      • Option 1: Reset to circuly’s default templates and adjust branding.
      • Option 2: Manually insert the required HTML code snippet that supports the account balance logic.

    Variables used include: is_account_balance, from_account_balance, and final_invoice_amount.

    Step 3: Inform your customers

    Clearly explain how the reward will be used (account balance, not cashback), and ensure transparency to avoid misunderstandings.

    Customer experience flow

    • A customer with an active subscription logs into the Self-Service Portal.
    • They click the REFER A FRIEND button.
    screenshot of refer a friend feature in circuly operations backend

    • A unique voucher code appears, which they can copy and send to a friend.
    screenshot of refer a friend feature in circuly operations backend

    • The friend applies the code at checkout and enters their email address.
    screenshot of refer a friend feature in circuly operations backend

    • If the email is not already associated with a circuly customer, the code is validated and applied.
    screenshot of refer a friend feature in circuly operations backend

    • The referring customer receives a balance update.
    • This balance is automatically used for future recurring payments and reflected in the invoice.

    Good to Know

    • The feature becomes available only after the early cancellation period is over.
    • The customer balance can only be used for recurring payments, not for new orders at checkout.
    • If the balance exceeds the recurring amount, the remainder is carried over to the next payment.
    • A new column in the Recurring Payments section shows whether account balance was used.

    FAQ

    Q: Can customers use their balance for new checkouts?
    A: No, account balance is only applied to future recurring payments.

    Q: What happens if the balance is greater than the recurring amount?
    A: The surplus remains in the account and is used for upcoming payments until exhausted.

    Q: Why is the feature only available after the early cancellation period?
    A: To reduce fraud and ensure the referring customer remains subscribed for a certain period.

    Read more
    Subscriptions
    Serial number

    How to Replace a Serial Number?

    You may want to replace an existing serial number because of reasons such as typing errors. Here's how you can perform this action.

    Introduction

    Every product in circuly is tracked using a unique serial number. Serial numbers allow you to monitor key product KPIs like:

    • Product lifecycle and usage
    • Wear and tear
    • Remaining value or resale potential

    Sometimes, a serial number may need to be replaced—for example, due to a typing error or internal stock adjustment. circuly gives you the option to manually update the serial number from either the Orders or Subscriptions tab in the circuly Hub.

    Step-by-step guide: Replace a serial number

    You can replace a serial number from two places:

    Option 1: From the orders tab

    1. Log in to your circuly Hub.
    2. Go to Orders in the left navigation bar.
    3. Select the order you want to edit from the Order List.
    4. Scroll to the Linked Subscriptions section.
    5. Click on the three dots (⋯) next to the subscription.
    6. Choose Replace serial number from the dropdown menu.
    7. In the Change Serial Number window:
      • Enter the new serial number
      • Enter the previous serial number
    8. Click Confirm and submit to complete the update.

    Option 2: From the subscriptions tab

    1. Navigate to the Subscriptions tab in the circuly Hub.
    2. Locate the subscription you want to edit.
    3. Scroll to the right until you see the three dots (⋯).
    4. Click the dots and select Replace serial number.
    5. In the Change Serial Number window:
      • Enter the new serial number
      • Enter the previous serial number
    6. Click Confirm and submit to save your changes.
    Read more
    Subscriptions
    Mark as settled

    Manually Mark Payment as Settled

    Learn more about marking a payment as settled.

    Introduction

    Not all payments in your subscription business are processed automatically through your Payment Service Provider (PSP). In cases where payments are handled manually—such as invoice-based payments or offline transfers—you can use circuly’s “Mark as Settled” feature to keep your payment records accurate and transparent.

    This article explains when to use the feature, what it does, and how to mark a payment as settled from two places within the circuly Hub.

    Feature Overview

    The Mark as Settled feature allows a circuly user to manually mark a payment or invoice as paid, even if the transaction occurred outside the circuly system (e.g., bank transfer, invoice payment).

    Key points:

    • It applies to any payment that hasn’t been automatically charged yet.
    • It’s especially useful for companies that manage some payments outside of circuly.
    • Once marked as settled, the payment is assigned a "Paid" status in the system.
    • No actual charge is triggered—the feature is purely administrative for record-keeping.

    For payments processed by circuly through your PSP, there's usually no need to mark them manually. These are automatically settled once charged.

    Step-by-Step Guide

    You can mark a payment as settled from two places in the circuly Hub: the Subscriptions tab and the Recurring Payments tab.

    Option 1: From the Subscriptions Tab

    • Go to the Subscriptions tab in the circuly Hub.
    • From the Subscription List, select the subscription that includes the payment you want to mark as settled.
    • Scroll down to the Recurring Payments section.
    • Click the three dots next to the relevant payment to open the action menu.
    • Select Mark as Settled.
    • Confirm your action by clicking Mark as settled.

    Option 2: From the Recurring Payments Tab

    • Navigate to the Recurring Payments tab in the circuly Hub.
    • Search for and locate the specific payment you want to mark as settled.
    • Click the three dots next to the payment.
    • Select Mark as Settled from the dropdown.
    • Confirm by clicking the MARK AS SETTLED button.

    What Happens Next

    Once confirmed:

    • The payment is marked as Paid in the circuly Hub.
    • No actual transaction is initiated—this is for tracking purposes only.
    • Your payment records stay clean, even for offline or manually settled invoices.
    Read more
    Account & Setup
    Checkout
    Supported languages in circuly

    Language Settings in circuly

    Languages supported by the various circuly modules and the setup process to make the different languages available to your customer.

    Introduction

    circuly supports multiple languages to help you deliver a localized experience across your Checkout, Self-Service Portal, and email communication. With just a few settings in your circuly Hub, you can configure the languages available to customers and how those language preferences influence the user experience and system communication.

    This guide walks you through the languages supported, how to activate them, and how the system handles language preferences.

    Feature Overview

    To see the languages currently supported by circuly, go to your Settings in the circuly Hub and check the available options under Allowed Languages.

    circuly is constantly expanding the list of supported languages to help you offer a localized experience to your customers across different markets. If your desired language isn’t listed yet, feel free to reach out to us via the service desk—we’re always improving and updating language support based on customer needs.

    Step-by-Step Guide to Enabling Languages

    Step 1: Define Allowed Languages

    Allowed languages are the ones your customers can choose from during checkout or in the Self-Service Portal.

    To enable them:

    1. Go to Settings > Company Settings > Locale in your circuly Hub.
    2. Under Allowed Languages, select the languages you want to offer from the dropdown.

    When you select an allowed language, a new column is added in the Email Templates tab for that language—so you can configure email templates accordingly.

    Step 2: Set Up Email Templates (If Needed)

    Selecting a language under “Allowed Languages” does not automatically create translated email templates. You’ll need to:

    • Go to the Email Templates tab in your circuly Hub.
    • Use the new language column to manually create or translate the templates for that language.

    Step 3: Define a Default Language

    The default language acts as the fallback language for all communications when a customer's preferred language is missing or email templates aren't set up in their chosen language.

    To set the default language:

    1. Go to Settings > Company Settings > Locale.
    2. Choose your Default Language from the dropdown list.

    Note: You can only set one default language.

    Terminology Explained

    Allowed Language

    Languages made available to customers in the Checkout and Self-Service Portal, selected via the "Allowed Languages" setting.

    Preferred Language

    The language selected by the customer during checkout or in the portal. This preference is saved and used for all communication (emails, invoices, etc.).

    Default Language

    Used when:

    • No preferred language is available for the customer, or
    • The email templates for the preferred language are not configured.

    How circuly Uses Language Preferences

    • When a customer visits the checkout and switches to a different language from the available list, circuly saves that language as their preferred language.

    • Any email or transactional message sent afterward (automatically or manually) will use this preferred language—if email templates are set up.
    • If templates are missing for the preferred language, circuly defaults to the default language set in your settings.

    FAQ: Common Language Questions

    What language is shown to customers the first time they access checkout?
    The checkout language is based on the browser language. If the browser is set to English, the checkout and communication will start in English—even if your default language is different.

    What changes the customer’s preferred language?
    If the customer switches languages in the Self-Service Portal, circuly automatically updates their preferred language and uses it for all future communications.

    What language is used when I manually resend an email?
    The email will be sent in the customer’s saved preferred language, regardless of whether it’s triggered manually or automatically.

    Tip If you don’t see a specific language in the Default Language dropdown, make sure it’s first added under Allowed Languages.
    Read more
    Customer Self Service
    Login to the Customer Self-Service Portal

    Login Process for the Customer Self-Service Portal

    Here's how your customers can log in to the Self-Service Portal.

    Introduction

    The circuly Self-Service Portal (CSS) gives your customers full control over their subscription—allowing them to manage payments, view invoices, update details, and more.

    To maintain security, access to the portal is limited to the email address used during checkout or order placement.

    Step-by-Step Guide: How the Login Process Works

    Step 1: Access the Self-Service Portal

    Customers can access their portal by visiting your company’s URL and clicking on a link that indicates that its a portal for the customer.

    Example: See how Strollme guides customers to their Self-Service Portal below.

    Step 2: Enter Email Address

    On the login screen, the customer enters the same email used at checkout in the email input field.

    Step 3: Receive One-Time Password (OTP)

    If the email matches a subscription in your system, the customer receives a one-time password via email.

    Step 4: Log In with OTP

    • Copy the OTP from the email and paste it into the login page.
    • Alternatively, click the login link provided in the email to access the portal directly.

    Step 5: Explore the Portal

    Once logged in, the customer will see an overview of their subscriptions, payments, and more.

    What customers can do in the Self-Service Portal

    Read more
    Email Templates
    Email delivery

    Issues With Email Delivery

    Here are some of the most common reasons for failure in the delivery of emails to your customer. Learn more about email delivery.

    Introduction

    When a transactional email doesn’t reach your customer, it’s important to understand that sending an email and successfully delivering it to the inbox are two separate things. circuly may send the email without any errors, but the customer still might not receive it due to issues on their end or with the email provider.

    This guide helps you determine whether an email was sent and what to do if it wasn’t delivered.

    Step-by-step guide

    Step 1: Check if the email was sent

    Before diving into possible inbox issues, first verify whether the email was actually sent from circuly.

    Option 1: Check via the Email History Tab

    1. In your circuly Hub > Go to the Email History tab.
    2. Enter the customer’s email address in the search bar.
    3. Look for the relevant email and check its status.

    Option 2: Check via the Customer Profile

    1. Go to the Customers tab.
    2. Select the relevant customer from the list.
    3. Open the History tab inside the customer profile.
    4. Look through the list of actions and emails to find the one in question.
    5. Check the status of the email:
      • Success = the email was sent.
      • No status or missing email = it may not have been sent. Try Option 1 again or continue to Step 2.

    Step 2: If the email was sent but not delivered

    If the email status is "Success" but the customer didn’t receive it, the issue likely lies with delivery. Here are the most common reasons and what you can do:

    1. The email landed in the spam folder

    • Ask your customer to check their spam or junk folder.

    2. DNS settings are misconfigured

    • The reverse lookup for your sender email may have failed.
    • Check your DNS records with your email provider to ensure they’re correctly set up.

    3. Using an unsuitable email provider

    • Some providers (e.g., Gmail or Outlook) may block or deprioritise transactional emails—especially those that look repetitive or "promotional."
    • Recommendation: Use a dedicated transactional email service like Mailgun for better deliverability.

    4. External links in your email template

    • Many mail providers filter out emails with external links (e.g., login URLs).
    • A common issue is with one-time password (OTP) emails that include login links.
      • Try removing the link and sending a new version to test deliverability.

    Step 3: Retry Sending the Email Manually (if needed)

    If circuly shows that the email failed to send, you can manually resend the email from the circuly Hub. This helps test whether the issue was temporary or ongoing.

    Final Step: Contact circuly support (if necessary)

    If you’ve verified that:

    • The email was sent correctly,
    • You’ve checked common deliverability issues,
    • And you’re still facing problems...

    Submit a ticket to the circuly Service Desk. We’re happy to investigate further or guide you on the next steps.

    Read more
    Products
    Initiating product buyout

    Initiating product buyout when customer wants to buy the product

    Learn more about initiating a product buyout in the circuly operations backend when a customer requests to buy the product in the middle or during the subscription period.

    Introduction

    In a rental or subscription model, customers may eventually want to keep the product they’ve grown to love. Whether it’s at the end of their subscription period or somewhere in between, circuly gives you the flexibility to manage buyouts efficiently—without disrupting your operations.

    This article explains how to initiate and manage product buyouts from the circuly Hub, especially when you want to offer custom prices. It also covers what changes take place in the subscription and what happens after the buyout is processed.

    Feature Overview

    There are two ways to initiate a product buyout in circuly:

    1. From the Customer Self-Service Portal
      Once enabled, customers can initiate a buyout themselves. The process is fully automated.
    2. From the circuly Hub
      You (or a circuly user) initiate the buyout manually—ideal when offering custom pricing for specific cases without affecting other product prices or if you do not offer buyouts for product as a default option but accomodate it on special request.

    The difference between the two options:

    The key difference between the two buyout methods lies in how much control you want over pricing.

    • If you want to offer a custom price for a specific customer—without changing the default price for all products of that type—the best option is to manually initiate the buyout from the circuly Hub. Learn more here.
    • If you're using standard pricing and don’t need to set individual buyout prices, the Customer Self-Service Portal is the more convenient choice, allowing customers to handle the process on their own.

    What a product buyout changes in the subscription:

    When a product buyout is initiated, several things happen in the background to update the subscription and inventory status:

    • Outstanding amount is charged (if applicable)
      The system calculates and charges any remaining amount based on:
      Buyout price – total already paid = amount due
    • The product is marked as "Bought Out"
      This tells the system that the product is no longer expected to be returned.
    • Inventory is updated
      The product is removed from your shop system’s available stock, reflecting that it’s been purchased by the customer.

    Why you should always use the buyout process (not just cancel the subscription)

    In circuly, products are expected to be returned at the end of the subscription period. If a product isn’t returned by the “Return until” date, the system automatically reactivates the subscription and resumes charging the customer for the unreturned product.

    However, when a product is purchased through a buyout, no return is expected. That’s why it’s important to formally initiate the buyout process—so Circuly can:

    • Properly mark the product as "bought"
    • Prevent the return workflow from triggering
    • Ensure the subscription doesn’t reactivate unnecessarily

    Skipping this step could cause confusion for your operations team and frustration for your customers.

    If you wish to enable your customers to request buyouts on their own from their customer portal follow this guide on Enable And Process Buyout/Purchase of Subscription Products.

    For information of how to deal with buyouts from the circuly Hub, continue reading this article.

    Step-by-step guide

    • Step 1: Check the retail price
    • Step 2: Initiate the buyout

    Step 1: Check the retail price

    Before initiating a buyout, make sure the retail price of the product is correct:

    • Go to the Products tab in the circuly Hub.
    • Locate the product and verify the retail price.
    • If needed, edit the price to ensure the correct amount will be charged during the buyout.

    Step 2: Initiate the buyout

    • Navigate to the Subscriptions tab in the circuly Hub.
    • Find the subscription from the list > Click on the three dots to see the subscription action menu.
    • Choose buyout subscription from the dropdown menu.
    • In the Buyout Overview window:
      • Review the Buyout Price (adjust if needed).
      • Add a message in the Invoice Line Item Text field—this will appear in the invoice email sent to the customer.
      • Click Buyout to confirm the transaction.

    Make sure the email template you use includes the {{description}} variable so the custom message appears correctly in the customer communication.

    What happens next

    • The status of the asset is marked as bought out. Assets with bought out status do not trigger the return workflow because they are not expected to come back (no further action is required from your side).
    • Recurring payments are stopped so that the customer is not charged additionally for the bought out subscription.
    • The customer receives the "Buyout Order Confirmation" email first from the email templates to confirm the subscription buyout.
    • After the "Buyout Order Confirmation" email is sent, a one time transaction is triggered with the amount in the Buyout Price input field. The amount is charged immediately using the customer's stored payment method.
    • Once the payment is successfully charged, an invoice is generated for the one time payment (the email template "One time transaction" is used to generate an invoice) and sent to the customers (the email template "Payment was successful" is used to send the invoice to the customer that the payment was successful)

    Additional things to note

    Buyout payment can take some time to process when SEPA is chosen. This should be mentioned in the email communication with the customer. Example text that you can include in your buyout email: "Thank you for your order. You will receive an order confirmation by e-mail shortly. Depending on the payment method, it may take several days to process your payment. As soon as the payment has been successful, your subscription will be changed to "{statusBoughtOut}" and you will receive an email with your purchase invoice. If your payment cannot be processed, we will also notify you by email.

    Learn more about the buyout process.

    Read more
    Subscriptions
    Mark subscription status as pending return

    Mark a Subscription’s Status as Pending Return

    Marking the subscription status as “pending return” can be either done manually or it can be automatically triggered.

    Introduction

    When a customer ends their subscription, it’s essential to initiate the return process smoothly. circuly handles this through the “Pending Return” status, which helps trigger return workflows and customer communication automatically.

    The subscription can be marked as pending return automatically by the system or manually by a circuly user—depending on the situation.

    Feature Overview

    The Pending Return status plays a key role in return management:

    • It tells circuly that the customer is expected to return the product.
    • It ensures the return process (including automated emails) is triggered.
    • It prevents the need for manual tracking or intervention in standard return scenarios.

    There are two ways to set the subscription status to pending return:

    1. Automatically when the subscription reaches its end date.
    2. Manually—e.g. if a customer submits a cancellation request before the end date.

    💡 You can also automate this process using the Customer API:
    Use this PUT request to set a real subscription end date →

    Step-by-Step Guide: Manually Set Status to “Pending Return”

    Use this method if a customer requests a cancellation before their subscription ends.

    Step 1: Log in and Find the Subscription

    • Go to your circuly Hub
    • Navigate to the Subscriptions tab
    • Select the relevant subscription from the list

    Step 2: Set Status to Pending Return

    1. In the subscription details window, click the three dots in the top right corner.
    2. Select Set status as pending return.

    Step 3: Add Details (Optional)

    In the Set subscription to pending return window:

    • (Optional) Add a reason for setting the status, e.g. "Customer cancellation request."

    Step 4: Decide on Future Charges

    You’ll see the option: Delete future recurring payments.

    • Check this box if:
      You don’t want to charge the customer while the return is in progress.
    • 🚫 Leave unchecked if:
      You want to encourage timely returns by keeping the recurring charges active until the product is returned.

    Step 5: Confirm the Action

    Click the CONFIRM button to finalise.

    What Happens Next

    Once the subscription is marked as Pending Return:

    • The return workflow is triggered in circuly.
    • The customer receives the "Subscription Pending Return" email from your email templates.
    • Depending on your settings, future recurring payments may be deleted or continue.
    Read more
    Products
    Returns
    mark as bought

    Mark Products as Bought

    ‍Mark products as "bought" during the return process

    Introduction

    During the return process, not all products are actually sent back. Some customers choose to buy the product instead of returning it—especially near or after the end of their subscription period.

    To reflect this accurately in your system, circuly now allows you to mark a product as bought directly in the return handling process—eliminating the need for a separate buyout workflow.

    Feature Overview

    This feature lets you handle two common scenarios more efficiently:

    • The customer returns the product as expected → ✅ Mark as Returned
    • The customer keeps (buys) the product → ✅ Mark as Bought

    By marking a product as bought during the return process, the circuly system will:

    • Skip return-related workflows
    • Reflect the product status as Bought Out in your Asset List
    • Give you control over whether to stop or continue charging recurring payments

    Step-by-Step Guide: Mark a Product as Bought

    1. Go to the Returns section in the circuly Hub.
    2. Select an order from the Return List.
    3. In the Return Handling window:
      • Click on Mark as bought instead of Mark as returned.
    4. (Optional) Check the box Delete future recurring payments depending on your contract terms.

    When to Use or Skip the “Delete Future Recurring Payments” Option

    • Check the box if:
      The customer has bought the product and should no longer be charged any future payments.
    • Do NOT check the box if:
      The customer is still within the minimum contract period but is returning or keeping the product early—you may still want to charge them for the remaining duration.

    What Happens Next

    • The product will be marked as Bought Out in your Asset List.
    • No return workflow will be triggered.
    • Future recurring payments will be stopped if you checked the option.

    This gives you operational flexibility while keeping your inventory and payment records accurate.

    Retaled articles

    Buyout process for your customer from the customer portal.

    Buyout process for a circuly user from the circuly Hub.

    Read more
    Orders
    Edit order

    Edit an order

    Edit order is a feature available in the circuly Hub that you can use to edit orders by adding, changing or deleting order items that do not have a subscription attached to it.

    Introduction

    In circuly, you can edit orders—such as changing products, addresses, or prices—before a subscription has been created. Once a subscription is attached to an order, the order becomes locked and can no longer be modified. This edit functionality is especially useful when handling last-minute customer requests or internal adjustments, such as correcting details or switching products before finalising the subscription.

    Feature Overview

    The Edit Order feature allows you to update key components of an existing order directly from the circuly Hub. When you select “Edit Order,” circuly creates a draft copy of the original order, preserving all items, customer details, and payment info. You can then adjust the draft as needed and confirm it as a new, active order.

    Key things you can do during editing:

    • Add, delete, or modify order items
    • Update shipping or billing addresses
    • Send the updated order directly to the customer as a pre-filled checkout link or simply confirm it internally
    • Choose whether customer confirmation is required or not
    • Trigger new payment collection if needed

    Once confirmed, the edited order is treated as a new order in both circuly and your shop system. The original order must be cancelled and, if applicable, refunded manually.

    Step-by-Step Guide

    Editing an Order

    • Log into your circuly Hub.
    • Navigate to the Orders tab and select the order you wish to edit.
    • Click on the three dots in the top-right corner and select Edit Order.
    • circuly will create a draft version of the order.
    • From here, you can:
      • Click Add to include new products or the cross icon to remove products (note: this doesn't trigger an automatic refund).
      • Click Edit to modify item details such as product variant, pricing, or quantity.
      • Update shipping and billing address fields.
    • Choose how the updated order should be processed:
      • Send to customer for confirmation (toggle on): Sends a pre-filled checkout link for approval.
      • Process internally (toggle off): The order is confirmed without customer involvement, using their original payment method.
    • Click Create Order to finalize the updated order.

    Customer journey

    If the updated order is sent to the customer:

    • The customer receives a new checkout link.
    • They open the link, review the updated order, and re-enter their payment details.
    • Once checkout is complete, the draft becomes a finalized order.

    If the order is processed internally:

    • The customer does not need to take any action.
    • The payment method from the original order is reused.
    • The customer receives an updated order confirmation email.

    In both cases, the updated order becomes active, and the original order should be cancelled and refunded manually if needed.

    What happens next

    Cancelling and refund the original order

    You need to cancel (and refund) the old order manually with a suitable message so that your customer understands why he / she is charged (again).

    To do so open the order > click on the three dots at the top right > select cancel order to do so and select the checkbox "full refund". If you only want to partially refund an order, please learn more about refunding an order here.

    Charging the initial payment of the updated order

    Once the updated order is created, you have to charge the initial payment manually.

    To charge the initial payment open up the updated order > click on the three dots at the top right > select Charge Initial Payment.

    When charging the initial payment, you can add a custom message to explain why your customer is charged. Make sure to click on charge xx,xx so that the payment will be initiated through your payment service provider. The customer will then also automatically receive an invoice.

    How to identify edited orders?

    You can identify edited orders easily since they marked as Origin: Clone. You can always find the original order by copy / pasting the parent ID in the order search (for example if you want to cancel and refund the original order).

    You will also find this information in the order list:

    Read more
    Payments
    Initial payment

    Initial Payment

    Initial payment is the payment that is due when an order is placed. Learn more

    Introduction

    Initial payment is the payment that is due when an order is placed. The initial payment often refers to the first recurring payment plus any other payment (setup, shipping, additional products) you charge when a customer places an order on your checkout page. You can choose not to charge the initial payment in the checkout and delay the charge, (delayed charge) until a later point in time. 

    Read more
    Orders
    Subscriptions
    Start subscription

    All Different Ways to Start a Subscription in the circuly Hub

    There are multiple paths you can take in the circuly operations backend to create a subscription. This article highlights all of them.

    Introduction

    As your subscription business grows, manually creating subscriptions for each incoming order can become time-consuming and inefficient. That’s why circuly offers an automatic way to create subscriptions—by linking the subscription creation process to the “Mark as fulfilled” action in the circuly Hub.

    This method allows your team to create subscriptions automatically when an order is marked as fulfilled, saving time while ensuring accuracy and consistency in your workflow.

    Settings overview

    To enable automatic subscription creation, you need to configure two settings in your circuly Hub:

    1. Auto activate subscriptions
      • When enabled, this setting triggers the creation of a subscription automatically when an order is marked as fulfilled.
    2. Auto activate offset
      • This defines how many days after fulfillment the subscription should start.
      • Example: If the offset is set to 3, the subscription start date will be 3 days after the order is marked as fulfilled.

    Step-by-step setup guide

    1. Enable auto activate subscriptions

    • Go to Settings > Subscription > Create Subscription.
    • Turn on the switch for Auto activate subscriptions.

    2. Define the subscription start date offset

    • In the same settings section, find the auto activate offset field.
    • Enter the number of days you want to delay the subscription start after fulfillment (e.g., 3).

    3. Process orders as fulfilled

    • Go to the Orders or Customers tab in the circuly Hub.
    • Once the order has been shipped, click the three-dot menu next to the order.
    • Click Mark as fulfilled.

    That’s it—circuly will automatically create a subscription for that order using the configured settings.

    Good to Know

    • The “Mark as fulfilled” option is designed for workflows where the order has already been shipped via the shop system, and the circuly user is simply updating the system so that it can start the subscription.
    • This method reduces human error and manual effort while ensuring that subscriptions only start after confirmed shipping.
    • It's ideal for operations with high order volume, or where fulfillment is triggered externally and only needs to be mirrored in circuly.

    Read more
    Account & Setup
    Subscriptions
    Subscription start date

    Automate Subscription Start Date Selection

    Every time you create a subscription, you can select the subscription start date. You can automate the process of selecting a subscription start date.

    Introduction

    In a subscription business, timing matters—especially when it comes to starting the billing cycle. To ensure a smooth experience for both your business and your customers, circuly enables you to define a custom subscription start date. This ensures that subscriptions begin only after the product has had time to reach the customer, avoiding complaints or confusion about billing before delivery.

    Settings overview

    When a customer places an order via your website and completes the checkout process, a new order appears in the circuly Hub. At this point, you need to manually create a subscription for the order to start collecting recurring payments.

    During subscription creation, you’ll see a subscription start date picker in the creation window. If you’ve configured the Subscription Start Date setting in advance, circuly will automatically pre-fill this date based on the custom logic you’ve defined.

    Step-by-step setup guide

    1. Navigate to Settings
      Go to Settings > Subscription > General.
    2. Enter a custom start delay
      In the Subscription start date input field, enter a numeric value representing the delay in days.
    3. How it works
      Every time you create a new subscription, the start date will automatically be set to:
      1 + the value you entered.
      Example: If the value is 3, the subscription will start 4 days after the order is placed.
    4. Subscription creation
      When you open the "Create Subscription" window for a new order, the start date calendar will automatically reflect the custom value you’ve set—saving you time and ensuring consistency.

    Good to know

    • The extra “+1” in the formula accounts for the order creation day.
    • You can always manually adjust the start date during subscription creation if needed.
    • This setting only impacts the default start date—it doesn’t lock you into a fixed value.

    Best practices

    • Base your subscription start date on shipping time.
      If your products typically take 3 days to reach customers, set the custom value to 3, making the total delay 4 days (1 + 3).
    • Ensure operational alignment.
      Work with your logistics or operations team to determine the average delivery time so that subscriptions don’t start before the product arrives.
    Read more
    Orders
    Subscriptions
    Create a subscription

    Create a Subscription

    You got a new order? Woo-hoo! Congratulations! Before you start earning that beautiful monthly recurring revenue, here are are few things you need to set up first to get going!

    Introduction

    When your customer goes over your checkout and places an order by completing the payment process, an order is created in the circuly Hub. In order to start collecting recurring payments for the order a subscription needs to be created for it.

    Feature Overview

    In circuly the process of creating a subscription for an order enables various subscription-specific tasks such as creating a recurring payment schedule, charging the payment on the due date, tracking the minimum subscription duration, end date, renewals etc.

    The process of creating a subscription for an order can be either performed manually or it can be automated. Under the manual process there are a few different options to create a subscription, whereas the automated way of creating a subscription is through circuly's Customer API.

    To ensure these processes run smoothly, you need to decide how subscriptions are created—either manually or through automation. You can always change your approach at a later stage. When you are new to circuly and just getting started, the manual approach may be better suited as it gives you the possibility to see how the system works.  

    Available options to create a subscription

    There are multiple ways to create a subscription in the circuly Hub. You can create a subscription from the following:

    • Manually for every order
      • From the Orders tab
      • From the Customers tab
    • Bulk create subscriptions
    • Bulk upload subscriptions
    • circuly API for automated creation

    Step-by-step guide

    In this article we'll cover both the manual and the automated process of creating subscriptions for order.

    - Manual creation via Orders tab

    • In your circuly Hub > Go to the Orders tab.
    • In the Order List click on the order for which you want to create a subscription.
    Note: To identify which order have a subscription already and which don't, you can look at the Active subscription column.
    • In the Order overview window > Click on the Process subscription button to start the subscription creation process.
    • Generate or add a serial number to the subscription to assign a product to the subscription and connect it with the customer and the associated subscription.
    Note: When you click on "Generate", circuly assigns a random unique ID to the product. If your products already have pre-defined serial numbers, you can manually enter them. This ensures accurate product-level tracking—like revenue, rental cycles, repairs, and usage—since all tracking in circuly is tied to the serial number.
    • Select a start date or confirm the one already displayed.
    • Finalise the process by clicking on the Submit button.

    Tip: This process can be automated via our customer API. This is the POST request you can use https://api-docs.circuly.io/docs/customers-api-docs/f301d280d321c-creates-a-new-subscription that you can use for creating a subscription.

    - Manual creation via Customers tab

    • In your circuly Hub > Go to the Customers tab.
    • From the Customer list select the customer for whom you want to create a subscription.
    • Click on the Process open order button
    • Use the left and right arrow keys to switch between orders or get to orders that do not have an attached subscription yet.

    • In the Create Subscription window > Generate or add a serial number to the subscription to assign a product to the subscription and connect it with the customer and the associated subscription.
    Note: When you click on "Generate", circuly assigns a random unique ID to the product. If your products already have pre-defined serial numbers, you can manually enter them. This ensures accurate product-level tracking—like revenue, rental cycles, repairs, and usage—since all tracking in circuly is tied to the serial number.
    • Select a start date or confirm the one already displayed.
    • Finalise the process by clicking on the Submit button.

    Good to know

    • Typically the starting date of a subscription can only be in the future but you can also create the starting date in the past if you have the associated setting enabled. Learn more about the past date setting.
    • You can automate the process of selecting a subscription start date so that you don't have to manually select a date every-time you create a subscription. Learn more.

    - Bulk create subscriptions

    In order to create a subscription in the regular way you have to select an order (or customer if you are using the customer tab to create the subscription) and go to the Order Overview to create a subscription. You can skip that by bulk updating Orders into Subscriptions.

    Detailed steps: How to bulk update orders into subscriptions

    - Bulk upload subscriptions

    With circuly you can create subscriptions in bulk and skip manually assigning serial number to a product in case you have thousands of orders coming in on a daily basis.

    Detailed steps: How to create subscriptions in bulk

    - Create subscriptions via the circuly API

    You can use the circuly API to create subscriptions. Follow the link to the circuly Customer API documentation.

    What happens next

    1. The "Subscription activated" email is sent to the customer from the Email Templates.
    2. The order is displayed in the Subscription List under the Subscription tab because the order now has an active subscription attached to it. 
    Read more
    Subscriptions
    Account & Setup
    past start date

    Setting: Allow start date in past

    Learn how to enable and use the circuly setting that allows subscription start dates in the past.

    Introduction

    When creating a subscription manually, you have the option of selecting a start date for the subscription. selecting a start date is important because this impacts the end date of the subscription. By default, circuly only allows you to set a subscription start date in the future. However, in some operational scenarios—such as aligning with a shipment date or correcting delayed data entry—you may need to set a start date in the past.

    circuly provides a setting that enables this flexibility, allowing you to manually create subscriptions with a past start date.

    Setting Overview

    The setting to allow past start dates can be found in your circuly Hub. Once enabled, it lets you manually choose a start date that lies in the past when creating a new subscription. This setting only affects manual subscription creation via the circuly Hub.

    Use Cases:

    • The product was shipped earlier, and the subscription needs to match that timeline.
    • Subscription data (e.g., billing cycle, usage tracking) should reflect actual usage.

    Step-by-step guide

    To enable the option to create subscriptions with a past start date:

    • Log in to your circuly Hub.
    • Go to the Settings tab in the navigation menu.
    • Navigate to Subscription settings > Create Subscription.
    • Find the setting labeled "Allow start date in past".
    • Enable the switch next to this option.

    Once enabled, the date picker in the subscription creation flow will allow you to select both past and future dates.

    Read more
    Customer Self Service
    Subscription cancellation from self service portal

    Self-Service Portal - Cancel Subscriptions

    Your customers can make cancellation requests from the self-service portal. Learn more.

    Introduction

    circuly gives your customers the option to cancel their subscriptions directly via the Self-Service Portal. This article outlines the cancellation process, types of cancellations, and what your customers can expect depending on the timing of their request.

    Types of Cancellation

    There are two main types of cancellations your customers can make:

    1. Cancellation within the Early Cancellation Period ("Widerrufsfrist")
    2. Regular Cancellation (outside of the early cancellation period)

    Note: The key difference between these two types is that if the cancellation is within the Early Cancellation Period, customers will see the option to return the product—either immediately or after the minimum subscription duration. In contrast, if it's a Regular Cancellation, the return option is not shown; customers can only request cancellation.

    Customer Journey: Cancellation Within the Early Cancellation Period

    If a customer’s subscription is still within the early cancellation period, they can cancel as follows:

    • Log in to the Customer Self-Service Portal.
    • Go to "Your Subscriptions" and select the subscription to cancel.

    • Click on "CANCEL NOW".
    • In the subscription overview window:
      • Select a Cancellation Type (Normal or Extraordinary).

    • Choose a Cancellation Reason from the dropdown.
    • Choose how to return the product:

    • Option 1: Immediately
      • A confirmation email is sent.
      • The subscription status changes to "cancelled".
      • The customer receives return instructions.
      • Once the product is returned, a refund is issued.
    • Option 2: After Minimum Duration
      • The subscription status becomes "cancellation requested".
      • An email confirms the request.
      • A reminder email is sent when the end date is near.
      • After the end date, return instructions are sent.
    • Customers can optionally leave a message.
    • Click "CANCEL NOW" to submit the request.

    Customer Journey: Regular Cancellation (Outside Early Cancellation Period)

    • Log in to the Customer Self-Service Portal.
    • Go to "Your Subscriptions" and select the subscription.

    • Click "CANCEL NOW".
    • In the subscription overview window:
      • Select a Cancellation Type.
      • Choose a Cancellation Reason.

    • The return product option is not displayed.
    • The subscription status updates to "cancelled" or "cancellation requested".
    • The cancellation date and end date are displayed.

    Processing Rules:

    • If still within the minimum duration: cancellation is scheduled for the end date. An email will be sent with next steps.
    • If outside the minimum duration: Circuly checks for notice period compliance and cancels accordingly.

    Note: In both cases, subscriptions will not renew again, but the actual cancellation depends on timing.

    Read more
    Account & Setup
    Customer Self Service
    Change language

    Self-Service Portal - Changing the language

    Your customers can switch between languages if there is more than one language available in the self-service portal. Learn more

    Introduction

    circuly allows you to offer a localised experience for your customers by supporting multiple language options in the Customer Self-Service Portal. This article explains how language preferences are managed and how they influence customer communication.

    How to configure available languages

    As an admin, you can control which languages are available to your customers. For details on configuring language options or troubleshooting issues, refer to the language settings article.

    How language preferences work

    The language selection feature in the Customer Self-Service Portal allows customers to choose the language in which the portal is displayed. This preference not only affects the interface language but also determines the language of transactional email communications sent to the customer.

    Customer journey: changing the portal language

    Here’s how your customers can change their preferred language:

    1. Log in to the Customer Self-Service Portal.
    2. Click the small grey language selector button in the top-right corner.
    3. Select a preferred language from the list.

    Implication: Once changed, all future transactional emails will be sent in the selected language. The circuly system automatically saves this preference.

    How to configure available languages

    For more details on configuring language options or troubleshooting issues, refer to the language settings article.

    Read more
    Account & Setup
    Checkout
    Delayed charge

    Delayed charge

    Delayed charge is a feature available in the circuly operations backend that you can use if you do not want to charge the initial payment in the checkout and instead delay the charge until a later point in time. 

    Delayed charge - delayed charge is a feature available in the circuly operations backend that you can use if you do not want to charge the initial payment in the checkout and instead delay the charge until a later point in time. 

    Currently the option to delay a charge in your white-label checkout or the initial payment is only available if you use the following Payment Service Providers: 

    Here's when you might want to delay a charge: 

    • Limited stock availability - If you are unsure whether you can fulfil the order or not because you don’t have the necessary stock amount and need to order the stock from your supplier first.
    • Validating the credit worthiness of the customer - If you want to check the credit score of the customer first and based on the credit score decide whether you actually want to fulfil the order or not.
    • Checking if delivery is possible - If you want to check first whether you can actually deliver your product to the requested area & you need to manually follow up with the customer for the delivery of the product.

    Learn more about delaying initial payments in this article

    Read more
    Orders
    Draft orders

    Creating Manual Draft Order

    The Manual Order feature enables you to manually create orders in the circuly Operations Backend and send the order as quotes to the customer. Learn more

    Introduction

    Typically an order appears in the circuly Hub when a website visitor goes over your checkout page and places an order. The next step is to create a subscription for the order to start collecting recurring payments.  However you also have the possibility of creating orders from the circuly Hub. The Draft order feature in circuly allows you to create an order manually from the circuly Hub. This is especially useful in B2B transactions where you may operate on order-to-quote basis, in-store purchases, or customer service teams placing orders on behalf of customers.

    Feature overview

    The Draft Order feature enables you to manually create a complete order in the circuly Hub. You can:

    • Add customer information
    • Assign a product and subscription plan

    Once the draft is created, you have two powerful options for how to send it to the customer:

    • Send as a quote (pay-by-invoice): Ideal for B2B customers who prefer traditional payment methods.
    • Send as a pre-filled checkout link: Maintains the standard eCommerce experience while speeding up the process. The link brings the customer directly to a ready-to-pay checkout page with all order details pre-filled.

    This dual delivery method gives you flexibility while retaining the smooth, familiar buying experience of your existing shop system.

    Step-by-step guide

    Creating a draft order

    • In the circuly Hub > Navigate to the Orders tab.
    • then go to the Draft tab and click on the + Create order button dispalyed in the to right corner.

    • In the Create order window start by adding an item. To do so click on the Add item button.
      • In the Add item window fill in the needed information such as:
        • Selecting the product and the product variant (Note: Only limited number of products are visible in the dropdown menu. Therefore if you can’t find a product, simply type the name of the product in the input field. )
        • Type of subscription: normal, consumable or digital
        • Price & quantity
        • Subscription details such as duration, freuency etc.
        • Select the start
      • Confirm your selection by clicking on the Add item button.
      • Repeat the process if you want to add more items to the same order.

    • Continue to the Address section > And add the customer information. 
    • Alternatively you can also choose an existing customer if the order is for a customer whose details already exist in the system. You can do so by clicking on the Select existing customer dropdown option and selecting a customer (You can search via first name, last name or email address).
    • Check the details.

    Sending the order to the customer

    • Option 1: Send the order as quote to the customer. In this case the customer gets a pre-filled checkout link and can finalise the order by adding their payment details.
    • Option 2: Let the customer pay via invoice.
      Keep in mind that the payment processing will need to be managed outside of circuly. You can still mark the invoices manually as Paid to keep an overview of the outstanding invoices. 

    Optional: You can also add a note for the customer under the Remarks field. Whatever you add here will be added to the email sent to the customer. You can use this field to inform your customer about any additional information.

    Finally click on the Create button to finalise the draft order.

    • Once the order has been created, it will appear under the Draft tab.

    Note: You can also work with the circuly API to create manual order. You can find the documentation here. Please keep in mind that this works only for offline payments. If you want to create an order with other payment service providers, kindly write a service desk ticket to our customer support.

    Customer actions and journey

    • Once you’ve successfully created a draft order > Your customer receives an email from the Email Templates that contains the link to the checkout and to the invoice. 

    Note: The email templates used to send the email are: Order Offer and Order Offer PDF. Set up the email template before you start using this feature.

    • When the customer clicks on the link, they are taken to the checkout page. All the details on the checkout page are pre-populated. 

    • The customer continues and finalises the order by adding the payment details and proceeding to the Order confirmation page. 
    • The customer also receives the Order Confirmation email when the order has been successfully processed. 

    What happens next

    The status of the order will change from open to completed once the customer has successfully completed the process by adding their payment details on the checkout page. 

    Create a subscription for the order to start collecting the recurring payments.

    Read more
    Account & Setup
    Checkout
    Delayed charge

    Delayed Charge or Delayed Initial Payment in the Checkout

    In the circuly Hub, you have the option to delay charges or payments and not charge anything when your customer places an order on your checkout. Learn more about the delayed charge feature.

    Introduction

    Delayed charge is a feature available in the circuly Hub that you can use if you do not want to charge the initial payment in the checkout and instead delay the charge until a later point in time. 

    Currently the option to delay a charge in the checkout or the initial payment is only available if you use the following Payment Service Providers: 


    Here’s when you might want to delay a charge:

    • Limited stock availability - If you are unsure whether you can fulfil the order or not because you don’t have the necessary stock amount and need to order the stock from your supplier first. 
    • Validating the credit worthiness of the customer - If you want to check the credit score of the customer first and based on the credit score decide whether you actually want to fulfil the order or not. 
    • Checking if delivery is possible - If you want to check first whether you can actually deliver your product to the requested area & you need to manually follow up with the customer for the delivery of the product. 

    Good to know

    If you choose to delay the charge during checkout, here’s what happens:

    • The order amount is only reserved on your customer’s bank account—no money is charged immediately.
    • The order will be created in both your shop system and Circuly, but the payment status will show as Payment Required.
    • You won’t be able to start the subscription until the initial payment has been charged.
    • You need to charge the payment manually first before you can create a subscription for the order.

    Why this matters:By default, circuly prevents subscription creation without the initial payment to protect your business from fraud and to avoid unintentionally activating unpaid subscriptions.

    However, if you have internal processes that require creating subscriptions for unpaid orders, circuly allows you to do this via the Allow unpaid subscriptions setting.

    To enable it:Go to Settings > Subscription > Create Subscription > Allow unpaid subscriptions and toggle the switch on.

    Once enabled:

    • You can create a subscription even if the payment hasn’t been charged.
    • circuly will automatically trigger the initial payment once the subscription is created.
    • The customer will receive the Order Confirmation email.

    📢 Be sure to clarify in the Order Confirmation email that it confirms receipt of the order request—not its acceptance. Update your email template accordingly to manage expectations.

    In the Order Overview, you'll also see a new menu option under the three-dot menu: "Charge initial payment"—in case you prefer to initiate the payment manually.

    Step-by-step guide

    Enable the setting

    • Go to SettingsCheckout > End checkout > Enable the switch for Delay charge in checkout.
    • Change the Default payment status to “payment required”. 
    • Navigate to the Email Templates tab and adapt the Order Confirmation email. Make sure you communicate that this is only a confirmation email for order request and not order confirmation. 
    • Optional: adapt the content of your Order fulfilment completed email or your Subscription Activated email. You may want to do this if you officially want to confirm the order to your customer. You can do this either when you are sending out the product to the customer (in the order fulfilment email) or with the subscription activation. Inform your customer that you can confirm the order, that the money has been therefore charged and that the product is delivered or is under delivery.
    Note: The change applies to all orders only after you have activated the associated setting.

    What happens next

    You need to charge the initial payment.

    •  When the Delay charge in checkout setting is enabled, in your Order overview Window under the menu options, you will find a new menu option “charge initial payment”. 
    • Go to the menu option and and charge the initial payment. 
    • Once the initial payment has been successfully charged from your customers’ account, the Payment was successful email will be automatically sent to the customer. 
    • The payment status will then change to paid
    • Continue with your planned fulfilment / subscription process. 
    Note: You can only Create a subscription once the initial payment has been processed. The button/option to so will now we be available to you or you've enabled the Allow unpaid subscription setting.
    Read more
    Customers
    Edit customer information

    Edit the Customer Information

    Customer information can be edited either by the customer in the Customer Self Service and it can also be edited by you in the Customer Profile and in Orders. Learn more about editing customer information

    Introduction

    Customer information in Circuly can be updated in three ways:

    • Manually by a circuly user through the circuly Hub
    • Directly by customers through the Customer Self-Service Portal
    • Programmatically via the circuly API.

    Editing customer details is essential for keeping records accurate—whether it's correcting a typo, updating a phone number, or changing the delivery address for a specific order.

    However, not all customer-related data is editable in one place. This is intentional: a customer might have multiple orders or subscriptions, and changes like address updates (shipping and billing) may apply only to a specific order—not their entire profile.

    Tip: You can also update customer details using circuly's API. refer to the Update a customer endpoint for more information.

    Step-by-step guide

    Editing email address and phone number

    • Go to the Customers tab in your circuly Hub.
    • Select or search the customer you wish to edit from the Customer list.
    • In the Customer Overview, go to the Billing information section on the bottom right.
    • Click the edit (pencil) icon to make the fields editable.
    • In the Edit Customer window, update the email or phone number.
    • Check the box to consent to the update, then click Submit.
    • You will see the changes reflected under Billing information.

    In B2C contexts, the email and phone number typically belong to the customer themselves. However, in B2B scenarios, one customer profile may be used to place orders on behalf of multiple individuals. In such cases, the contact information (email and phone) may reflect the person placing the order rather than the actual recipient. This information may need to be updated over time, especially when responsibilities shift within a company, while the shipping address remains tied to the end recipient.

    Editing the address details and date of birth of the customer

    When editing the address, you'll see separate fields for the shipping address and the billing address. Make sure to update the correct one based on what the customer needs changed—for example, the delivery destination versus the invoicing contact.

    • Go to the Orders tab in the circuly Hub.
    • Select the relevant order from the Order List.
    • In the Order Overview, go to the Billing information section on the bottom right.
    • Click the edit (pencil) icon.
    • In the Edit Customer window, update the address and/or birth date.
    • Check the box to consent to the update, then click Submit.

    In many cases—especially B2B—orders are placed by one contact person but delivered to different recipients. For this reason, address and birth date updates are made per order rather than globally across a customer profile. This ensures the right delivery information is applied where it's needed without affecting other subscriptions or orders linked to the same account.

    Editing customer details via the Self-Service Portal

    Customers can also update their own information through the Customer Self-Service Portal.

    However, similar to how it works in the circuly Hub, address changes are made on a per-order basis. If a customer needs to change their shipping address, they must do so from the specific order view—ensuring that address updates apply only to the relevant order and not universally across all active subscriptions.

    These updates are reflected directly in the circuly Hub.

    For a detailed breakdown of how customers can update their information in the portal, refer to:

    Read more
    Subscriptions
    Edit subscription start date

    Edit the Subscription Start Date for an Existing Subscription

    Learn how you can edit the subscription start date of a subscription that has already been created.

    Introduction

    In a typical eCommerce flow, a customer places an order, the product is shipped, and the seller estimates a delivery time—usually within a few days. The subscription is created, either manually or through automation, and a start date is assigned accordingly.

    When creating a subscription manually, the circuly user has the option to select the subscription start date. By default, this field is pre-filled with a date influenced by the Subscription start date setting (e.g., “+3” to indicate a start date 3 days from today). If no such setting is defined, the field may default to a random future date. In automated flows (bulk upload or API), the start date is included in the incoming data and adopted directly by the Circuly system.

    It's important to note: if a subscription has not yet been created for an order, the start date can be freely defined or adjusted during the subscription creation process. However, if a subscription already exists and the start date needs to be changed, then the approach is different—and that’s where the Edit Recurring Payments feature becomes relevant.

    This is especially useful in scenarios where the initial billing plan—let’s say starting on the 2nd of the month—no longer aligns with reality due to delays (e.g., the product was only delivered on the 15th). Instead of canceling and recreating the subscription, you can shift the start date and all future billing to the 15th of each month going forward, while preserving the subscription structure.

    Step-by-step guide

    • In your circuly Hub > Go to the Recurring payments tab.
    • Locate the subscription that needs an updated start date by selecting the appropriate entry from the Recurring Payment List.
    • Click on the three dots (•••) next to the entry.
    • Choose Edit Recurring Payment(s) from the dropdown menu.
    • In the Edit Recurring Payment(s) window, turn on the toggle for Change all future payments.
    • Select a new start date from the calendar—this date must be in the future and should reflect the estimated delivery or actual product usage date.
    • Save your changes.

    The subscription’s billing will now align with the new start date, and the end date will shift accordingly to maintain the original contract duration.

    circuly gives you the flexibility to correct subscription timelines when things don’t go as planned. By adjusting the start date after delivery delays or other operational reasons, you ensure billing fairness and maintain customer trust—without disrupting the overall contract terms.

    Read more
    Subscriptions
    Bulk upload

    How to Bulk Upload Subscriptions?

    With circuly you can create subscriptions in bulk and skip manually assigning serial number to a product in case you have thousands of orders coming in on a daily basis.

    Introduction

    There are multiple ways to create a subscription for an order in circuly. One of them is to Bulk upload subscriptions. With this feature you can skip the step of manually going through every order and starting a subscription.

    Feature overview

    To bulk upload subscriptions you simply create a a CSV file with all the information needed by circuly to start the subscription and then you simply use the upload function to import that information to circuly.  Here's an example of how the CSV upload should look.

    Step-by-step guide

    To bulk upload subscriptions:

    • In your circuly Hub > navigate to the Subscriptions tab
    • Click on the CSV button near the search bar.
       
    • In the Import subscription from CSV window click on Select your file and select the file you want to import. 


    Once the file has been imported, a feedback window will be displayed that tells you how many orders have been imported. In case there is an error, it will be displayed in the feedback window. To know the reason for the error, you can download the error report and check the reason for the error message. All the orders that are now imported have a subscription created automatically. 

    What happens next

    1. The "Subscription activated" email is sent to the customer from the Email Templates.
    2. The order is displayed in the Subscription List under the Subscription tab because the order now has an active subscription attached to it.
    Read more
    Account & Setup
    Customer care email address setting

    Setting: Customer Care Email Address

    Get notified via email for certain important subscription operations like cancellation requests, chargebacks etc. Learn more.

    Introduction

    In circuly, you can designate a specific customer care email address to receive automatic notifications when key customer-related events occur. These notifications help your internal team stay informed and take timely action when needed.

    Feature Overview

    The email address you define in your circuly Hub will receive alerts for the following types of events:

    • Failed Payments – When a recurring payment attempt does not go through.
    • Unreturned Products – When the return deadline has passed and no product has been received.
    • Subscription Cancellation Requests – When a customer initiates a cancellation.
    • Chargebacks – When a customer disputes a transaction with their payment provider.
    • Issues Reported – When a customer reports a problem via the Self-Service Portal.

    This setting ensures that your customer service team is always in the loop and can respond quickly to customer needs or potential problems.

    How to set up the customer care email address

    1. Login to your circuly Hub
    2. Navigate to: Settings > Company Settings > Base Setup
    3. Locate the field labeled Customer Care Email Address
    4. Enter the email address that should receive the notifications.
    5. Click Save Changes at the bottom of the page.

    ✅ Tip: Use a shared customer support email (e.g., support@yourcompany.com) so multiple team members can monitor incoming alerts.

    Examples of Email Notifications

    Below are examples of the kinds of notifications your team might receive:

    1. Unreturned Product Notification
      Subject: “Product not returned – [Order ID]”
      Body: Alerts the team that a return deadline has passed without product return.
    2. Failed Payment Notification
      Subject: “Failed Payment – [Customer Name or ID]”
      Body: Informs about unsuccessful payment attempts requiring follow-up.
    3. Issue Reported from Self-Service Portal
      Subject: “Customer reported an issue – [Subscription ID]”
      Body: Includes the customer's message and issue details.
    4. Subscription Cancellation Request
      Subject: “Cancellation request received – [Subscription ID]”
      Body: Lets your team know a customer wants to end their subscription.
    5. Chargeback Notification
      Subject: “Chargeback initiated – [Transaction ID]”
      Body: Notifies you that a dispute has been raised by the customer’s payment provider.

    Setting up the Customer Care Email Address in Circuly ensures that your team receives critical updates without delay. With automated notifications for cancellations, payment failures, and other key events, you can proactively manage customer support and maintain high service standards.

    Read more
    Account & Setup
    Email provider set up

    Set up Your Email Provider

    There are two options available to set up your email provider. Learn more.

    Introduction

    circuly gives you the flexibility to decide how your system-generated emails are sent to your customers. You can either use your own SMTP server or take advantage of circuly’s built-in Mailgun SMTP integration. This guide explains both options and outlines all the necessary steps for setup.

    Feature Overview

    You can configure your outgoing email setup in two ways:

    • Option 1: Use your own SMTP server (e.g. Gmail, Outlook, or another email service)
    • Option 2: Use Circuly’s pre-integrated SMTP server via Mailgun

    Each approach ensures that all automated customer communication (order confirmations, subscription updates, etc.) is delivered reliably under your brand identity.

    Option 1: Using Your Own SMTP Server

    1. Navigate to: Settings > Setup and Design > Email Server Settings
    2. Enter your SMTP details:
      • Host
      • Username
      • Password

    This method gives you full control over email authentication and deliverability using your company’s own email infrastructure.

    Option 2: Using Circuly’s Mailgun SMTP Server

    This is a fully managed option handled by Circuly, ensuring professional-grade deliverability while still allowing emails to appear as if sent from your domain.

    Step 1: Set Sender and Reply-To Emails

    • Navigate to: Settings > Emails > General
    • Enter:
      • Sender Email Address (e.g. service@yourcompany.com)
      • Reply-to Email Address

    Circuly will use these to set up your email identity in Mailgun.

    Even though emails are routed via Circuly's Mailgun SMTP server, your customers will only see your company's branded email addresses.

    Step 2: DNS Configuration

    Circuly will generate TXT and MX DNS records that you must add to your domain provider’s DNS settings.

    Explanation of DNS Records:

    • MX (Mail Exchange): Directs incoming emails to the right mail servers.
    • TXT (Text Records): Verifies domain ownership and is used for SPF, DKIM, and DMARC to prevent spoofing.

    ⚠️ Verifying your MX records is highly recommended to prevent email delivery failures and improve authentication reliability.

    Step 3: SMTP Credentials Setup

    Circuly’s technical team will:

    • Create SMTP credentials in Mailgun
    • Add them to the Email Server Settings in your Circuly Hub

    These credentials ensure that emails are securely sent via Mailgun with the correct authentication.

    Step 4: Update Your Domain DNS Records

    You will receive DNS entries (TXT & MX) from Circuly. Here’s how to add them:

    1. Log into your DNS hosting provider (e.g. GoDaddy, IONOS, Cloudflare).
    2. Navigate to your DNS management area.
    3. Add or update DNS records as provided.
    4. Save changes.

    DNS propagation may take anywhere from a few minutes to several hours to reflect globally.

    Conclusion
    Whether you choose to manage your email delivery through your own SMTP provider or use Circuly’s Mailgun setup, both options ensure reliable, branded communication with your customers. For most businesses, the Mailgun integration offers a hands-off, secure, and scalable solution. If you need help or would like Circuly to configure this for you, simply contact our service desk.

    Read more
    Products
    Account & Setup
    Tax rules

    Set up Tax Rules

    Set up tax rules in the circuly operations backend.

    Introduction

    If your business ships products within Europe or internationally, understanding how VAT (Value Added Tax) applies is essential. VAT obligations apply whether you're located inside or outside the EU. Additionally, even within a single country—like the USA—tax rates may vary by state. This guide will help you set up taxes properly in circuly to ensure compliant and accurate billing.

    Note: If you're operating in the USA, circuly offers an integration with TaxJar for automated tax calculations. Reach out to the service desk to activate this integration.

    Key concepts

    - Value Added Tax (VAT)

    VAT is a consumption tax charged as a percentage of the value of goods and services purchased by consumers. VAT applies to nearly all goods and services, but different products may be subject to different tax rates depending on their category.

    - VAT regulations for cross-border sales within the EU

    The EU has set a threshold amount for businesses situated within the EU selling to customers in another EU country:

    • If the business generates less than €10,000 in revenue from sales in another EU country, it charges VAT based on the country where it is registered.
    • Once the business reaches the threshold, it must charge VAT based on the country where the customer is located.

    - Factors influencing VAT calculation and application

    As mentioned above, the VAT is calculated and applied on the basis of three things:

    • The category of the product - different products fall under different product categories and are therefore subject to the tax rates of the respective category.

    • The country you plan on shipping to - if the minimum threshold amount is reached then the tax rates of the country you are shipping to apply.

    • Whether or not the threshold amount has been reached - if the threshold amount has been reached then the tax rates of the country you are shipping to applies. If the threshold amount has not been reached yet then the tax rates of the country you are located in apply.

    Note: If you are below the threshold you can choose to apply the tax rates of either the country you are located in or the country you are shipping to. 

    - When tax configuration is not required

    You do not need to configure tax rates if:

    • Your business operates in only one country.
    • You do not have different tax categories for your rental products.
    • Tax rates remain the same regardless of the shipping destination.

    Feature Overview

    With this feature you can set up tax logics that apply to different categories of products based on the different factors that influence it. This features enables you to assign the right taxes to the products. Before you begin setting up the taxes make sure you have set up the following:

    Step-by-step setup guide

    • Prerequisite: Define base country, delivery country and product collection
    • Set up tax rules

    Prerequisite: Define base country and delivery country

    Before getting started with the tax rate set up you need to do the following:

    • Define your base country: The base country is treated as your default country for tax calculation in case the minimum threshold has not been reached in the long-distance shipping country (the country you are shipping to).

      In your circuly Hub > Go to the Settings Tab > Company Settings > Company data > In the Country dropdown menu select your default country > To save your changes, scroll to the bottom of the page and click on the Save changes button. 
    • Define your delivery countries: When you define your delivery country, a new country column is added to the Tax rules tab so that you can assign the tax percentages to the product collections.

      In your circuly Hub > Go to the Settings Tab > Checkout > DELIVERY > Scroll to Delivery countries and select your delivery countries from the dropdown menu > To save your changes click on on the Save changes button. 

    Note: If you do not set up the delivery countries in the Settings, you will only see the tax collection from the country that you have entered in your company address (company settings). As a result you will not be able to set up tax rules in the Products tab for countries that have different tax percentages and where you want to offer shipping.

    Step 1: Create Product Collections

    By default, all products are mapped to the default product collection. If you offer products that fall under different tax categories (e.g., standard vs. reduced rate), you must create new collections.A new tax rule row will appear for this collection under both the base and delivery countries.

    • Navigate to: Products > Taxes
    • Click + Product Collection
    • Enter a title and description
    • Click Create

    A new tax rule row will appear for this collection under both the base and delivery countries.

    Step 2: Assign Tax Percentages

    Now configure tax percentages for each collection and delivery country:

    • For the base country, check the box with the applicable tax rate.
    • For each delivery country:
      • If your revenue from that country exceeds €10,000: Check the box for the correct VAT rate.
      • If below threshold: Leave the delivery country box unchecked — the base country VAT will apply automatically.

    Here’s an example.

    Scenario: Your default country is Germany and you’re shipping to Austria and Norway. In Austria you earn a revenue of over 10.000 euros and in Norway, you’re under the threshold amount.

    How should the tax percentage boxes be checked for the above scenario?

    • For Germany, the highest tax percentage will be applicable for the default category.
    • For Austria (since it is over the minimum threshold) check the box for the tax percentage that is applicable for the default category. 
    • For Norway (since it is below the threshold)  you do not have to check any checkbox. Since the threshold amount has not been reached, the tax rates will be automatically calculated as per the default country.

    Step 3: Map Products to Collections

    To apply the correct VAT logic, map products to the appropriate collection:

    • Navigate to: Products > Products
    • Select the products to reassign
    • Click Map to Product Collection
    • Choose the correct collection from the dropdown
    • Click Map to Collection

    How tax is applied on the checkout page

    • Before Delivery Country Selection:
      • Tax is calculated using your base country rates.
      • An info note alerts customers that final tax will update based on delivery country selection.
    Screenshot of checkout to show the tax rules feature

    • After Country Selection:
      • Above revenue threshold: Tax from the selected delivery country applies.
      • Below revenue threshold: Base country VAT continues to apply.
    Screenshot of checkout to show the tax rules feature

    Important: Tax percentages in circuly are fixed in the system. If your business is enrolled in a special tax program or needs custom rules, contact our service desk for adjustments.

    Configuring your tax rules in circuly allows you to operate compliantly across borders while ensuring customers are charged the correct VAT. With automated logic tied to product type, revenue thresholds, and shipping destinations, you can reduce errors, simplify reporting, and deliver transparency at checkout.

    Read more
    Customer Self Service
    Refer a friend

    Self-Service Portal: Referring Friends

    Refer a friend is a feature that allows your customer to get monetary incentives for encouraging people in their network to become your customers. Learn more.

    Introduction

    circuly enables you to reward loyal customers for helping you grow your customer base. With the Refer-a-Friend feature, customers with an active subscription can share a unique code with friends and receive credit when that code is used for a new order. This article explains how your customers use this feature and how the process works behind the scenes.

    Feature overview

    • The feature is only available to customers with an active subscription that has passed the early cancellation period.
    • Customers generate a unique referral code via the Self-Service Portal.
    • Friends use the code during checkout for a discount.
    • The referrer receives account credit once the order is placed.
    • This credit is automatically applied to the next recurring payment.

    Customer Journey: Generating and Sharing a Referral Code

    • The customer logs in to the Self-Service Portal.
    • Clicks on the "REFER A FRIEND" button.
    • In the voucher window, clicks "CREATE REFERRAL CODE".

    Customer Journey: Friend Using the Referral Code

    • The friend visits the checkout page.
    • Adds the referral code in the voucher input field.
    • Clicks "VALIDATE".

    • To verify the code, the friend adds their email address and clicks "VALIDATE" again.
      • Note: The voucher is only valid for new customers.
    • Once verified, the discounted price is shown on the checkout page.

    • The friend proceeds to payment to complete the order.
    • Proceed to the payment process to finalise the checkout.

    What happens next

    • Once the referred friend completes their order:
      • The original customer (referrer) receives a credit on their account.
      • This credit is not transferable or withdrawable.
      • It is automatically applied to the next recurring payment.
      • The customer receives an invoice with the adjusted amount reflecting the credit.

    Note: Credit cannot be transferred to a bank account and is strictly applied to future subscription payments.

    Read more
    Account & Setup
    Customer Self Service
    Change personal details in the circuly self-service portal

    Self Service Portal - Change Personal Details

    In the customer self-service portal, you can change your personal details, such as your name, email, phone number and address (shipping and billing). 

    Introduction

    circuly enables your customers to independently update their personal details through the Customer Self-Service Portal. This article outlines how the experience looks for your customers when they update their contact details or address, and why the process differs slightly for each type of information.

    Customer Journey: Updating Profile Information

    Your customers can change their name, email, and phone number by following these steps:

    1. Log in to the Customer Self-Service Portal.
    2. Click the "YOUR PROFILE" button.
    3. In the "Your Profile" window, click the pencil icon to begin editing.

    1. Make the necessary changes.
    2. Click "SEND" to submit the updates.

    These changes are sent to the Circuly system and updated accordingly.

    Customer Journey: Updating Shipping or Billing Address

    To update the shipping or billing address for a specific order:

    1. Log in to the Customer Self-Service Portal.
    2. Go to the "Your Orders" section.
    3. Select the relevant order and click the arrow icon to view the order overview.
    4. On the order overview page, click the pencil icon next to the address.
    5. Make the necessary updates.
    6. Click "SEND" to confirm the change.

    The updated address is saved in the Circuly system and associated with the selected order.

    Why Contact Details and Address Are Handled Separately

    Customers may use a single email ID to place multiple orders—for themselves, family, or colleagues—each potentially with a different delivery address. To avoid conflicts or incorrect data changes across orders, addresses are managed separately at the order level.

    Read more
    Customer Self Service
    Change products

    Self-Service Portal - Change Product

    Your customers can change their products in the self-service portal from a predefined group. Learn more

    Introduction

    circuly gives your customers the flexibility to change their subscribed product directly from the Self-Service Portal. This article explains how the product change experience looks for your customer and what happens in the background once the request is submitted.

    Step-by-step guide

    • Log into the Self-Service Portal. 
    • Click on the dropdown menu to see the option.
    • Select "Change product" from the menu options.
    • Click the "CONFIRM" button.
    • A new window slides in from the right-hand side.

    • Click the dropdown arrow to view available product options.

    • Select a new product from the collection displayed.

    • Once a product is selected, the product image and price are shown.

    • Clicks on the Save changes button to confirm your selection. 

    Once the change is submitted:

    • The subscription status changes from “active” to “pending replacement”

    • This marks the end of the customer’s interaction.
    Read more
    Account & Setup
    Customer Self Service
    Download invoices

    Self-Service Portal - Download Invoices

    Your customers can directly download invoices from their self-service portal.

    Your customers can download invoices for payments that have already been charged.

    Given below are steps you can share with your customers or add to your FAQ section:

    To download an invoice > Go to Your invoices > Click on the download icon > Your invoice will be downloaded and available for you to view in your browser > To view your invoice click on the downloaded file > The invoice will open up in a new window > From there you can download and/or print your invoice. 

    Read more
    Products
    Account & Setup

    Everything About Exchanging and Swapping Products

    The set up and the process of changing products in a subscription also depend on the reason why the product needs to be changed. Learn more.

    There can be various reasons for swapping subscription products, such as product breakage, product loss, upgrades, downgrades or simply because of the nature of your business. 

    The set up and the process of changing products in a subscription also depends on the reason why the product needs to be changed. 

    Use case based set up overview

    The set up process based on the use case for exchanging a product. 

    • Use case 1: Nature of your business
      • Enable product swaps as a built-in part of your subscription model. Choose between:
        • Exchange Groups: Customers select from a predefined collection.
        • Free Selection: Customers can choose any product from your full catalog.
    • Use case 2: Swapping lost products
    • Use case 3: Swapping broken products.

    Use case 1: Nature of your business

    If you have a business model that allows your customers to exchange products from a predefined group, continue reading this article about Exchange Groups

    What are exchange groups?

    When you want your customers to select a product for exchanging from a predefined group, you can set up exchange groups in the circuly Operations Backend. Typical use cases include an exchange group for consumable subscription products such as protein powder, where the customer can change between the different flavours, an exchange group for kids bike, where the customer can select a bigger size, or an exchange group for toys, where your customer can swap between toys.

    Use case 2: Swapping lost products.

    Since lost products are not expected to come back, the swap process for such products looks slightly different than the regular swap process. 

    The reason why Lost product swaps are treated differently from other product swaps is because Lost products are not expected to come back. Speaking in technical terms, Lost products will not have a Pending Return status. This essentially means that normally you would expect a product to come back and if the customer doesn't send the product back, you can keep billing them. But in case of Lost products there is no possibility to get the product back hence no reason to bill the customers for two subscriptions. 

    In order to utilise the swap feature within the circuly Operations Backend, it is important to go through the following steps:

    Step 1: Review and configure the swap settings.

    Step 2: Add swap reasons. Swap reasons are used for internal communication. 

    Step 3: Learn how to process a swap request for missing products

    Use case 3: Swapping broken products.

    Make sure you’ve configured the swap settings and added the swapping reasons

    Continue reading this article to learn more about swapping broken products

    Read more
    Products
    Product buyout

    Enable And Process Buyout/Purchase of Subscription Products

    If you have a rental model that allows subscription products to be bought in the middle of the subscription period or at the end of the subscription period, you can tackle the operations in the circuly Operations Backend.

    Introduction

    If your rental subscription model allows customers to purchase their subscribed products either during or at the end of the subscription period, circuly makes the buyout process seamless through the circuly Hub and the Customer Self-Service Portal.

    Feature overview

    The Subscription Product Buyout feature in the circuly Hub allows your customers to purchase their subscribed product before or at the end of their subscription period. This feature simplifies the operational steps for your team and offers a smooth, self-service experience for customers.

    You can choose to:

    • Enable customer-initiated buyouts via the Customer Self-Service Portal — ideal if you want to automate the process and use the default retail price.
    • Initiate buyouts manually from the circuly Hub — best suited for custom pricing or exceptional cases or if you do not want to offer buyout as a default option but are still willing to acomodate the request when made by the customer under certain conditions.

    Key operational processes are handled automatically:

    • Calculation of the buyout amount
    • Charging the buyout amount via a one-time transaction
    • Generating and sending an invoice
    • Sending confirmation and success emails
    • Updating the subscription status to “bought out”

    Additional settings allow you to:

    • Apply a discounted buyout calculation based on already made payments
    • Include a two-step process with acceptance of custom terms and conditions

    This flexibility lets you adapt the buyout process to your business model, pricing structure, and customer experience preferences.

    Step-by-step guide

    Summary of steps:

    1. Check the retail price of the subscription product.
    2. Enable the buyout feature in the Customer Self-Service Settings.
    3. Go through the additional settings options.
    4. Accessing the buyout option in the Customer Self Service Portal.
    5. The buyout process for your customers.

    If you do wish to offer custom product prices when a customer request to buy the product, you can check out this article on initiating the buyout process manually from the circuly Operations Backend

    To learn more about the buyout process initiated by the customer from the Customer Self-Service Portal, continue reading this article.


    1. Check the retail price of your subscription product

    Before enabling the buyout feature, ensure the retail prices of all relevant products are correct.

    • Go to Products tab in the circuly Hub.
    • Click on the Edit button to make all the fields i the product list editable.
    • Edit the Retail price of the products you want.
    • Confirm by clicking on the Submit changes button.

    2. Enable the buyout feature in the settings.

    To make the buyout option available in the Customer Self-Service Portal you need the enable it in your settings first.

    • Go to Settings > Self-Service Portal.
    • Under Features > Navigate to the "Allow subscription buyout" setting > Enable the switch.
    • Scroll down and click Save Changes

    3. Additional buyout settings

    There are additional settings options available that enable you to customise certain aspects of the buyout process from the Self-Service Portal.

  • Two-Step Buyout Process
    • Enables an extra confirmation screen for customers to accept your terms and conditions.
    • Terms are hardcoded; contact circuly support to define them.
  • See the image below to see how the terms and conditions appear to your customer.

    Your customer then sees a second page where they have to check the box for the terms and conditions set by you.

    • Discount Payments for Buyout Calculation
      • Default value = 100 (100% of prior payments are deducted from the retail price)
      • Adjust if you want to retain some operational cost
      Example:
      • Retail Price: €200
      • Payments made: €30 (initial: €20 + recurring: €10)
      • Discount setting: 80%
      • Deducted: €16 + €8 = €24
      • Final Buyout Price: €176

    4. Accessing the buyout option in the Customer Self Service Portal

    Once enabled, customers will see a "Buy Product" option in the dropdown for each active subscription.Step 5: Confirming Buyout

    • Upon clicking, a side panel displays:
      • Retail Price
      • Total Paid (Initial + Recurring)
      • Final Buyout Price
    • If you've enabled the two-step process, a confirmation screen with checkboxes for terms appears first.
    • Customers then click "Confirm and Pay" (or "Continue" if two-step is active)


    5. The buyout process for your customers

    • When your customers click on the buy product option from the dropdown menu and confirm, a new window slides-in from the right with details about the product, the subscription and the price of the product.
    • The calculation shows the Retail price and the Buyout price of the product after subtracting any payments already made by the customer such as the Initial payment and the monthly subscription payments. 

    Important: The buyout price may vary based on your settings. Read information under point 2 and 3.
    • In case the payments already made by the customer is more than the retail price of the product, a symbolic buyout price of €1 is charged. The reason for doing so is also already given and explained to the customer. 

    • The customer can then click on the CONFIRM AND PAY button.

    IMPORTANT: If you've enabled the Two step buyout process setting then the button will say CONTINUE. Read information under point 2 and 3.
    • Once the process is through, a confirmation box appears on the screen with more information about the buyout.

    • The status of the Subscription goes to pending buyout until the payment goes through (see explanation box above). 
    • All dropdown menu options under the selected subscription disappear except the option to Report an issue. This is done in order to make sure that the customer does not request another buyout for the same product and also does not cancel the subscription while the product attached to the subscription is under the pending buyout process.

    • The customer additionally receives an invoice as confirmation for requesting a buyout.

    • The customer receives the "Buyout Order Confirmation" email first from the email templates to confirm the subscription buyout.
    • After the "Buyout Order Confirmation" email is sent, a one time transaction is triggered with the amount in the Buyout Price input field. The amount is charged immediately using the customers’s stored payment method.
    • Once the payment is successfully charged, an invoice is generated for the one time payment (the email template "One time transaction" is used to generate an invoice) and sent to the customers (the email template "Payment was successful" is used to send the invoice to the customer that the payment was successful)

    Note: Buyout payments can take some time to process when SEPA is chosen. This should be mentioned in the email communication with the customer. Example text that you can include in your buyout email: "Thank you for your order. You will receive an order confirmation by e-mail shortly. Depending on the payment method, it may take several days to process your payment. As soon as the payment has been successful, your subscription will be changed to "{statusBoughtOut}" and you will receive an email with your purchase invoice. If your payment cannot be processed, we will also notify you by email.

    • When the payment is successful, the status of the subscription goes from pending buyout to bought out.
    • The same is reflected in your circuly operations backend as the status of the subscription goes to bought out.

    Good to know

    • Identify whether a failed payment is due to a failed recurring payment or a failed product buyout payment - If you want to add specific information for failed buyout payments, you can use the variable {is transaction-buyout} in the Payment has failed email template (e.g. that the subscription is set back to active due to the failed payment).

    • Add buyout link to the Subscription almost over email - when your customers get the Subscription almost over email you can encourage your customers to instead buy their subscription product. You can additionally make the customer journey easier by adding the redirect link for the buyout in the email body itself. The variable for that is {css buyout_link}.

    Read more
    Account & Setup
    Email Templates
    Subscription is almost over

    Email and Setting: Subscription Is Almost Over

    In this article, we’ll explain the process of subscription renewal, reminder emails and the associated settings in detail. 

    Introduction

    Subscription fatigue poses a growing challenge for consumers juggling multiple recurring payments and contract renewals. While auto-renewals are a great sign of retention, they can also lead to frustration—especially when customers forget about upcoming charges.

    circuly helps you tackle this issue by enabling you to send automated reminder emails before a subscription ends and giving you full control over whether a subscription should renew automatically. In this article, we’ll explain how to set up reminder emails, configure auto-renewals, and make your subscription experience more transparent and customer-friendly.

    Feature Overview

    circuly enables you to:

    • Send automated reminder emails before a subscription ends, giving customers time to decide whether to continue or cancel.
    • Renew subscriptions automatically if the customer doesn’t cancel in time.
    • Customize settings to handle edge cases, such as short-term subscriptions or auto-renewed contracts.

    The result: A smoother customer experience and fewer support tickets related to surprise charges.

    Step-by-step setup guide

    Sending reminder emails before subscription ends

    Step 1: Navigate to Email Settings

    • Go to your Circuly Hub
    • Click on Settings > Emails > Subscription Information

    Step 2: Enable Reminder Email Option

    • Toggle the switch "Subscription is almost over when auto renew is off" to ON.

    Step 3: Define Timing for the Reminder Email

    • Enter a numeric value in "Days calculation before ending"
      • Example: Enter 14 to send the reminder email 14 days before the subscription ends.

    Step 4: Understand When the Email Triggers

    • The email will only be sent if the auto-renew switch is inactive for that subscription.
    • Auto-renew switch is inactive if:
      • The global Auto-renew subscriptions setting is OFF.
      • The subscription was created before auto-renew was enabled.

    Enabling auto-renewal for subscriptions

    Step 1: Navigate to Subscription Settings

    • Go to your Circuly Hub
    • Click on Settings > Subscription > Auto-renew subscriptions

    Step 2: Enable Auto-Renew

    • Toggle the switch "Auto-renew subscriptions" to ON.
    • This enables auto-renew for all newly created subscriptions.

    Step 3: Manually Enable Auto-Renew for Specific Subscriptions (if needed)

    • Go to the Subscription Overview for the desired subscription
    • Manually activate the auto-renew switch

    📝 Note: Simply activating the switch manually does not renew the subscription unless the global auto-renew setting is enabled.

    Optional Settings: Enhance Your Reminder StrategyI

    If you'd like to send reminder emails in edge cases, toggle these additional settings in Settings > Emails > Subscription Information:

    • "Subscription is almost over" for one-month subscriptions: enabling this switch will send the subscription is almost over when subscription duration is less than or equal to one month.

      Use case: When you do not have a minimum subscription duration and all your subscriptions are for a month. The subscriptions are extended on a monthly basis. If you enable this switch then the subscription is almost over email will be sent to the customer every month.
    • "Subscription is almost over" for auto-renewed subscriptions: typically when subscription have been auto-renewed there is no need to send the subscription is almost over email to the customer. Additionally when subscriptions are auto-renewed due to the auto-renew subscription setting, the auto-renew switch in the subscription overview window is made active. The active state of the auto-renew switch prevents the “subscription is almost over” email from being sent. 

      However enabling this setting will bypass this rule and send the email even if subscriptions have been auto-renewed and the auto-renew switch in the subscription overview window is active. 
    • "Subscription is almost over" email also if auto-renew is active: as explained above, the subscription is almost over email is not sent to the customer i the auto-renew button switch is active. However you can still decide to send the email and by pass this rule.

    These options help you stay flexible and customer-friendly across different use cases.

    By combining automated renewal reminders with clear subscription policies, circuly helps you reduce subscription fatigue, avoid customer frustration, and strengthen long-term customer relationships. Use these step-by-step guides to customise your renewal flow and keep your customers informed and satisfied.

    Read more
    Account & Setup
    Create or add users

    Create a User

    If you have access to the Admins section in the circuly Operations Backend, you can add users to your company instance and customise their permissions. 

    Introduction

    If you have access to the Admins section in the circuly Hub, you can add users to your company and customise their permissions. 

    Feature Overview

    With advanced user management in circuly, you can:

    • Invite both internal team members and external partners
    • Assign roles based on responsibilities
    • Control access per tab (e.g., limit a user to only the “Invoices” tab)

    This gives you full flexibility to tailor permissions to each person’s role — without giving more access than needed.

    Step-by-step guide

    • In your circuly Hub > Go to the Users tab.
    • Click on the + Invite user button. 
    • In the Invite User window enter the user's:
      • Email
      • Name  
      • Role of the user
    • Click on the Submit button.

    Admin - when you give a user the role on an “Admin”, the user is able to see the Admins section in the left navigation bar and access everything that comes under it, such as Settings, Repair Questions etc.

    User - when you give a user the role of a “User”, the user is only able to access the non-admin tabs in the circuly Hub.

    Once invited, the user appears in the list. You can adjust their permissions at any time by clicking on their name and checking/unchecking access to specific tabs.


    What happens next

    • The invited user receives an email invitation with a link to create their account.
    • This link is valid for 24 hours, so they must complete the sign-up within that time.
    • The user creates a password and logs in to the circuly Hub using their email and password.

    Login options:

    • Social login: If their email is linked to Google or GitHub, they can log in using that account.
    • Standard login: If not, they can create a password using the same email.

    User is unable to log in

    The most common reason is an expired invitation link.
    If the user doesn’t create a profile within 24 hours, the link becomes invalid.

    ➡️ In this case, please contact our Customer Success team via a Jira ticket to resend the invitation.

    To avoid login issues, ensure users complete their sign-up promptly.


    How to Remove a User

    1. Go to the Users tab
    2. Search for the user in the list
    3. Click on the three dots next to their name
    4. Select Remove user
    5. Confirm by clicking Remove
    Read more
    No items found.

    Edit customer balance

    The Customer Balance is a flexible way to apply credits or discounts to a customer's next recurring payment. Whether you're offering a goodwill gesture or rewarding loyalty, the balance amount is automatically deducted from the next payment due.

    Introduction

    The Customer Balance is a flexible way to apply credits or discounts to a customer's next recurring payment. Whether you're offering a goodwill gesture or rewarding loyalty, the balance amount is automatically deducted from the next payment due.

    Feature Overview

    In the circuly Hub, the customer balance can be manually customised for any subscriber.

    • This feature also interacts with Refer a Friend, where referral rewards are added as customer balance.
    • If the customer has a balance, it is automatically applied to their next recurring payment.
    • If the balance exceeds the upcoming payment, the remaining amount is carried forward to future payments until fully used.
    • You can add or reduce the balance as needed — but the balance can never go negative.

    Common Use Cases:

    • Offering a discount due to a product issue during the subscription
    • Providing a one-time loyalty credit for long-term or returning customers

    Step-by-step guide

    • Go to the Customers tab in your circuly Hub
    • Find and select the customer you'd like to update
    • On the right-hand side, click the Customer Balance button
    • In the popup:
      • Enter a positive value to add credit (e.g. 20)
      • Enter a negative value to reduce the balance (e.g. -10)
    • Click Submit
    • Refresh the page to see the updated balance reflected in the customer profile

    The full balance (if available) will be automatically deducted from the customer's next payment.

    Read more
    No items found.

    Edit user permissions

    In the circuly Hub, you can manage user access with precision — deciding who sees what, and what actions they can perform.

    Introduction

    In the circuly Hub, you can manage user access with precision — deciding who sees what, and what actions they can perform. This helps keep your operations secure, focused, and aligned with your team’s responsibilities.

    Feature Overview

    With Advanced User Management, you can define access per individual tab giving you full control over what each user can view or manage.

    Example Use Case:

    If someone in your team only needs to download invoices at the end of the month, you can give them access to just the Invoices tab — without exposing other sensitive data like customers or operations.

    Step-by-Step Guide

    1. Log in to the circuly Hub
    2. Go to the Users tab
    3. Find the user whose permissions you want to update
    4. Click on the user’s name to open the Access Scope window
    5. You’ll see a list of all Hub sections (Orders, Customers, Invoices, Email History, etc.)
    6. For each tab, you can check or uncheck the available permission types:
    7. Once done, simply close the window — changes are saved automatically

    ✅ The user’s access is updated immediately.

    Read more
    Invoices
    Charge Invoice

    Charge Invoice

    Manually charge an invoice from the invoice tab when a payment fails.

    Introduction

    When a payment fails in circuly, you can retry the payment manually or automate the retrial process. However, even after retrying, the payment may still fail. At this point, it’s recommended to reach out to your customer to resolve the issue. Once the customer confirms that they’ve resolved the problem on their end, you can use the Charge Invoice feature to attempt the payment again.

    Feature Overview

    Charge invoice is a feature available in the circuly Hub that enables you to manually charge an invoice with the "failed" payment status. An invoice has the "failed" payment status if a payment attempt was made but failed.

    Step-by-step guide

    • In your circuly Hub > Go to the Invoices tab.
    • Search and click on the invoice you want to charge.
    Tip: You can user the filters options to filter the Invoice list and only display payment that have the "failed" payment status".

    • Click on the invoice > In the Invoice overview window > Click on the Charge invoice button.

    • Then click on the Submit button.

    What happens next

    The circuly system attempts to charge the invoice.

    • If successful, an email is sent to the customer to inform them about the charge.
    • If unsuccessful, you'll see a notification that the charge was unsuccessful. At this point you can either get in touch with your customer or hand over the invoice for debt collection.
    Read more
    Products
    Product collections

    Create a Product Collection

    Product collections enables you to group products together and have common functions, actions, logic and rules for these group, aka collection instead of having a separate rule for each product. 

    Introduction

    E-commerce businesses rarely sell just one type of product as a subscription. As soon as different product categories come into play, various factors—like tax rates and shipping costs—start influencing the final price a customer pays. For example, smaller bike components might qualify for standard parcel delivery, while larger items like bike tires or the bike itself may have different tax rules and higher shipping costs. Manually managing these variations for each product can quickly become complex and time-consuming.

    To simplify this process, circuly introduces a feature that allows businesses to group products based on shared rules, logic, or actions. Instead of setting tax rates and shipping costs individually for every product, they can be applied at the group level. This ensures that when a customer reaches checkout, the correct taxes and shipping costs are automatically calculated based on the product collection—streamlining setup, reducing errors, and making it easier to manage large inventories.

    In this article, we’ll explore how this feature works, how to set it up, and how it helps businesses optimise their pricing calculations effortlessly.

    Feature Overview

    In circuly, products can be grouped together into a Product Collection. This allows businesses to apply shared tax rates, shipping costs, and other relevant rules to multiple products at once, rather than configuring them individually.

    - Key Concepts

    • Product Collections: When products are grouped together, they form a collection known as a Product Collection.
    • Mapping Products to Collections: Once a collection is created, products can be added to it. This process is referred to as mapping products to collections.
    • Default Collection:
      • Initially, when no custom collections exist, all products are assigned to the default collection by default.
      • The default collection cannot be deleted or edited, ensuring that every product is always part of a collection.
      • If a product is not explicitly mapped to any other collection, it remains in the default collection, and the tax and shipping rates set for the default collection (if configured) will apply.

    By structuring products into collections, businesses can automate tax and shipping calculations, making pricing management more efficient and reducing manual effort.

    Step-by-step setup guide

    • Define and set up product collections
    • Map products to the product collection

    - Define and setup product collection

    In your circuly Hub > Go to the Products Tab > Navigate to the Taxes tab > Click on the + PRODUCT COLLECTION button.

    In the Create product collection window > Give a Title, and a description to your collection so that you can differentiate it from other collections > Click on the Submit button to save your collection.

    Note: You do not need to define the Tax code as it is only relevant for you if you are based or operate in the US and use the Taxjar integration.

    The collection is then added to the Product Collections list along with the option to assign the tax percentages.


    - Map products to the product collection

    By default all products are mapped to the default collection.

    To reassign products to a different collection > Under the Products tab > Navigate to the Products > Select products to map to a collection by checking the check box > And click on the Map to product collection button.

    • In the Map to product collection window > Select the right collection from the dropdown menu > Click on the Map to collection button. 

    The selected products are now mapped to your chosen product collection.

    Next steps

    If you want to define the tax rules and shipping costs for each collection, follow these guides:

    Read more
    Payments
    Charge Initial payment

    Charge the Initial Payment Manually

    Charge initial payment is a feature available in the circuly operations backend that lets you manually charge the initial payment.

    Introduction

    When a customer completes the checkout process and finalises their order by making a payment, an order is created in circuly, and the initial payment is processed. This initial charge corresponds to the amount the customer agreed to on the checkout page.

    However, if you have enabled the "Delay charge in checkout" setting, no payment is processed automatically during checkout. In such cases, the initial payment must be charged manually. This step is essential because, typically, a subscription cannot be created unless the initial payment has been made. This safeguard prevents accidental subscription creation for orders where no payment exists or has not been collected yet.

    An exception to this rule occurs if you have also enabled the "Allow unpaid subscriptions" setting alongside "Delay charge in checkout." This configuration allows you to create a subscription even if no payment has been processed. However, this should be treated as a special case and communicated clearly to all users of the circuly Hub to avoid confusion.

    Feature Overview

    If you have enabled the "Delay charge in checkout" setting, no payment is collected after a customer finalises the order. The payment must be charged manually. To do so you can use the charge initial payment feature available in the circuly Hub that lets you manually charge the initial payment.

    Step-by-step guide

    The option to charge the initial payment can be approached either from the Orders tab or the Customer tab. No matter which way you choose, the result is the same.

    - Charge the initial payment from the Customers tab

    • In your circuly Hub > Go to the Customers Tab > Select the corresponding customer from the Customer list.
    • In the Customer Overview Window > Navigate to Orders > Click on the three dots to display the menu options > Click on Charge initial payment.
    • In the Charge initial payment window > Type a message in the Message to customer input field (Optional). The message will be sent as an in-line text to the customer with the "Payment" email.
    • Confirm your action by clicking on the Charge x,xx € button. 

    - Charge the initial payment from the Orders tab

    • In your circuly Hub > Go to the Orders Tab > Select on the corresponding order from the Order List.
    • In the Order Overview Window > Click on the three dots in the top right corner to display the manu options > Click on Charge initial payment.
    • In the Charge initial payment window > Type a message in the message input field (Optional). The message will be sent as an in-line text to the customer with the "payment"email.
    • Confirm your action by clicking on the Charge x,xx € button. 

    Next steps

    After you have charged the initial payment, you can proceed to create a subscription for the order.

    Read more
    Customer Self Service
    customer self-service

    Everything about the circuly Self-Service Portal

    The customer login gives your customers the freedom to do self-service and manage their subscriptions themselves.

    Introduction

    The circuly Customer Self-Service (CSS) Portal is a dedicated place for your customers to manage their subscriptions. It provides your customers with the necessary flexibility they need in managing their subscriptions and the transparency they expect from you. In the CSS, your customers can see all their subscriptions (active, ended, cancelled), make cancellation requests, make swap requests, report problems etc. 

    Why is a dedicated space aka customer self-service portal important?

    • Majority of the consumers today prefer and care about transparency.
    • A self-service portal takes away some burden (and operations) off of your shoulders.
    • It gives the customer the feeling of being in control - a priority among most consumers.
    • Transparency helps builds trust

    Feature Overview

    If you decide to use circuly's Customer Self Service Portal solution you can customise it with your logo and brand colours (just like the checkout) to fit your branding and you can also customise various options and features available to your customer in the customer portal. This article summaries all the relevant information related to the self-service portal. Follow the links to the deciated articles to learn more about it.

    Bonus: Webinar on the self-service portal.

    Did you miss the customer login webinar? No worries. You can watch it here to get in-depth information about it.

    Read more
    Checkout
    Account & Setup
    checkout

    Checkout Options and Checkout Limitations

    There are several options and settings available in the circuly Operations Backend to customise your checkout page. Learn more.

    Introduction

    The checkout is perhaps one of the most important step in any online shopping experience. With circuly you can not only customise the branding of the checkout but you can also decide how your checkout behaves.

    Feature Overview

    The available customisations are categorised into two groups: Options and Limitations. As the name suggests, Options allow you to enhance the checkout experience by adding features such as use of Google places, credit check, stock check etc. Limitations let you set specific restrictions in the checkout process such as minimum cart value to be reached for free shipping, maximum number of items per SKU permitted to proceed to payment page etc.

    Let's understand each of these options and limitation in detail.

    • Check system stock - The circuly system performs a stock validation and checks if the desired product is in stock. If the product is not in stock, an error message is displayed and the customer is prevented from proceeding to the payment page. Enable the switch for this setting if you would like to have the option of stock validation in your checkout. This feature is useful if you have limited stock availability and do not want the hassle of refunding orders manually.

    • Limit number of total cart items - This setting enables you to add a limitation on the maximum number of items allowed to proceed to checkout and finalise the order.

    • Limit number of items per SKU - This setting enables you to add a limitation on the maximum number of items allowed per SKU to proceed to checkout. 
    • Allowing the use of voucher codes - If you use vouchers you can enable the toggle for this setting to allow the use of voucher codes on the checkout.
    • Allow selecting delivery date - decide if you want to offer your customers the possibility to select a delivery or pick up date on the checkout page. Prerequisite: Set up the availability calendar.
    • Mandatory date of birth - You can make the date of birth input field a mandatory field like the name and address field. We recommend making the date of birth field mandatory if you use CRIF to do credit checks as CRIF requires date of birth to perform credit checks. 
    • Set minimum age - You can define a minimum age that a visitor needs to have to proceed to the payment page when placing an order. The circuly system checks the age of the visitor against the value inserted in the date of birth input field. 
    • Validate phone number - when you enable this switch the visitor is prompted to add a valid phone number in the phone number input field.
       
    • Allow company name - when you enable this switch an additional input field is added to the checkout where the visitor can add their company name. 
    • Mandatory company name - when you enable this switch the company name input field is converted into a a mandatory input field. 
    • Allow VAT number - enable this switch if you want to offer your customers the possibility to add their VAT number on the checkout page. 
    • Mandatory VAT number - enable this switch if you want to make the VAT number input field a mandatory input field. The customer will be prevented from going to the payment page if they do not add a value in this field. 
    • Limit delivery countries - enable this switch if you want to offer delivery services only in a few selected locations. 
    • Allow different shipping address - enable this switch if you want to allow your customers to add a different shipping address than the address already added on the checkout. 

    Displaying information on the checkout and checkout Overview page. You can choose to display or hide information on the checkout page. Given below are few options that can be customised.

    • Show subscription start date - this setting, as the title suggests, enables you to decide if you want to show the subscription start date on the checkout and order overview page.
    • Show cart sum - decide if you want to display the sum of the cart.

    • Show subtotal - decide if you want to display the subtotal (that is the price before any shipping or tax calculation) on the checkout page.

    • Show purchases sum - decide if you want to display the purchases sum. 


    • Show subscription sum- decide if you want to display the sum of all subscriptions on the checkout page.


    • Show shipping cost - decide if you want ti display the shipping costs on the checkout page. 
    • Show total - decide if you want to show a total amount on the checkout page. 
    • Show shipping methods - Display shipping methods on the checkout page. Prerequisites: Set up the shipping methods.
    • Show legal terms above buy button - Decide if you would like to display the legal terms above the buy button and change its position. 
    • Show apple warning - you can decide to display a warning message when checkout is on safari browser on Apple devices for PayPal issues. 

    Checkout options

    • Use Google places - enable your customers to search for their address when filling out the address input field.
    • Hide street number - enable this switch if you want your customer to add the street number and house number in the same inout field.
    • Delivery countries - select a list of countries that will be displayed on the checkout page as possible delivery locations.
    • Free shipping cart value - define a free shipping cart value. The circuly system will calculate the total and add shipping charges base don the subtotal. If the cart qualifies for free shipping (as per the value inserted here) shipping costs will bot be charged. 
    • Delay charge in checkout - you can decide to delay the initial charge when an order is laced and instead charge it at a lter point manually. 

    Options for cart limitation

    • On your own product page - limit your "add to cart button" by limiting the quantity to be added to one. You can also use visual aids (such as greying out the add to cart button after the maximum amount has been added) to make it easily recognisable for your visitors.

    If you would  like to limit your cart and have some limitation logics, we recommend doing so on the product page level with the support of your developers if you do not use the circuly cart.

    • Via the circuly settings: if you are using the circuly cart, you can also use our settings to limit the amount of items / SKU per cart. Continue reading the article for settings available in circuly.

    NOTE: You still may want to apply the above mentioned visual suggestions on your product page to avoid confusion. 

    There are several options and settings available in the circuly Operations Backend to customise your checkout page.

    Step-by-step guide

    To access the checkout limitation and options, in your circuly Hub > Go to Settings > Checkout and customise the given settings as per your business needs.

    Use cases for using limitations & options

    • Pilot phase - in the pilot phase you may have limited units of a product but may still want to have a large test group. 
    • Limiting fraud or suspicious business activities - for some people subscription businesses make it possible to acquire large quantities of product at a low (initial) price. In order to prevent such cases, products can be limited based on SKU or quantity so that a prospect with large units of products is prevented from placing the order.
    • Product / target group based limitations: another use case can be to show a custom message on the product page if the visitor has added more than x number of items in the basket or given any other indication of being a business customer. For B2B cases you ideally want to negotiate differently.
    Read more
    Payments
    Chargebacks

    Chargebacks in the circuly Hub

    Here's how you can see chargebacks in the circuly Operations Backend.

    Introduction

    What are chargebacks?

    A chargeback is a term used to describe a customers request to reverse a payment by disrupting the charge on their account statement. Chargebacks were introduced to offer customers an easy way to dispute suspicious transactions and to protect them against financial fraud. A chargeback need not always be due to fraudulent activities but can also be due to simple processing errors such as charging the customer twice or sending a damaged product. A customer can file a chargeback with their bank. Once approved, the customer receives the amount back. But merchant have the option of disagreeing with the chargeback and claiming it back. 

    Chargebacks and refunds both involve the return of funds but a major differentiating factor between the two is that for refunds the customer directly gets in touch with the merchant while for a chargeback they contact their bank. The process also tends to be longer for chargebacks and the fees are often significantly higher. 

    How are chargebacks bad for business?

    Chargebacks often come with additional fees which are to be paid by the merchant. Banks and card providers also tend to penalise the merchant if the chargeback ratio becomes too high. 

    How does a chargeback occur?

    When customers place an order through your checkout page, they receive an Order Confirmation email. Additionally, they receive a Payment Confirmation email when the initial payment is successfully charged, as well as subsequent Payment Confirmation emails for recurring payments.

    In some cases, a customer may dispute a payment, claiming they did not authorize it, and request a chargeback. To initiate this, the customer can click the Payment Service Provider (PSP) link included in the Payment Confirmation email. The PSP processes the chargeback request, and once approved, the customer is refunded the payment.

    Feature Overview

    When a chargeback occurs, circuly automatically updates the order and payment status in your system to reflect the chargeback. Here’s how the feature works in detail:

    • In your circuly operations backend, the payment status of the order changes to “chargeback”. 
    • The order is automatically canceled, and the cancellation reason is set to “chargeback.”
    • The asset revenue is updated with the chargeback amount. 
    • If the customer has not received the asset then the subscription status is updated to “cancelled by customer”.
    • If the customer has received the asset then the subscription status is changed to "cancelled by customer" and the customer receives the Order Cancellation email. Additionally the subscription status is changed to pending return and the customer receives the return instruction email. 

    - How to identify orders with chargeback in circuly

    Chargebacks can be identified in both the Payments and Subscriptions tabs within the circuly Hub. Here's how to view chargebacks in each section:

    • Payments Tab
    • Subscriptions Tab

    Chargebacks in the Payments tab

    To see the chargeback > Go to the Payments Tab > You’ll see a list of all the payments > Use the filter function to only display payments with the chargeback status. 

    Chargebacks in the Subscriptions tab

    Go to the Subscriptions tab and select a subscription from the Subscription List > In the Subscription Overview Window scroll down to Payments and Recurring Payments

    • When recurring payments are charged back, you can see it in the Recurring Payments section. The status of the payment is displayed as “failed” and the reason for the failed payment is marked as chargeback payment under the Failed Reasons column. (See image)

    Screenshot of the recurring payments to show the chargeback feature

    • When a non recurring payment is charged back, you can see it in the Payments section. The status of the payment is marked as chargeback. (See image)

    Screenshot of the payments to show the chargeback feature

     

    - How to deal with chargebacks

    Follow up with your customer manually to find out why they have initiated a chargeback. Depending on the outcome of the call you can either agree to the chargeback or charge the customer a one-time payment if the chargeback was mistakenly reported.

    Read more
    Account & Setup
    Customer Self Service
    Cancellation reasons

    Adding Cancellation Reasons

    When your customer makes a cancellation request from the self-service portal, they have to select the type of cancellation and reason for making the cancellation request. 

    Introduction

    If you allow your customers to make cancellation requests from the Customer Self-Service Portal, they will be required to select a reason for their cancellation during the process. Collecting cancellation reasons allows you to gain valuable insights, make informed decisions, and improve your offerings. It also demonstrates that you value customer feedback and are committed to enhancing their experience, ultimately fostering stronger customer relationships.

    The importance of collecting cancellation reasons

    Some of the reasons to consider adding cancellation reasons to your cancellation process are:

    1. Feedback and Improvement: By providing a cancellation reason, customers can offer valuable feedback to the business about why they decided to cancel the product or service. This feedback can help the business understand customer preferences, identify common issues, and make necessary improvements to their offerings.
    2. Problem Resolution: Sometimes customers might be cancelling a product due to a specific problem or issue they encountered. By selecting a cancellation reason, the business can proactively address these issues and work towards resolving them to prevent future cancellations.
    3. Personalisation and Retention: If a business understands why customers are cancelling, they may be able to offer targeted solutions or incentives to encourage customers to reconsider the cancellation. For instance, if the cancellation reason is related to price, the business might offer a discount or a better pricing plan. This can potentially lead to retention rather than loss of a customer.
    4. Data Analysis: Collecting cancellation reasons allows businesses to gather data and perform analysis to identify patterns or trends in cancellations. This can provide insights into broader issues that might be affecting multiple customers or specific areas that need improvement.
    5. Product and Service Evaluation: The cancellation reasons can also be used to evaluate the performance of different products or services. If a particular product consistently receives certain cancellation reasons, it might indicate that there's something about that product that needs attention.
    6. Customer Experience Enhancement: Understanding cancellation reasons can contribute to an overall improvement in the customer experience. Businesses can use this feedback to refine their processes, enhance customer support, and streamline their offerings.
    7. Reporting and Accountability: Cancellation reasons can be used for reporting purposes, helping businesses track the reasons for cancellations over time. This can be useful for managerial decisions and accountability within the company.

    Feature overview

    When using the circuly's Self-Service Portal to make cancellations, the process includes selecting a "type of cancellation" and providing a cancellation reason. The "type of cancellation" is standardised and consists of two fixed options: normal and extraordinary. However, the cancellation reasons within these categories are fully customisable. You can define and tailor these reasons to suit your business needs, directly in your settings.

    - Normal cancellation

    The process of terminating a subscription within the standard terms and conditions set forth by the service provider. 

    - Extraordinary cancellation

    Extraordinary cancellation refers to the termination of a subscription under exceptional circumstances that deviate from the regular terms and conditions. 

    - Customisable cancellation reasons

    The cancellation reasons that you as a circuly user add under normal and extraordinary cancellation.

    - Language & translation

    While adding cancellation reasons, you also have the option to enter translated versions of the reasons. The available language options in the "Add Cancellation Reason" window are based on your Allowed Language settings. Only the languages selected in the Allowed Language dropdown will be available for defining the cancellation reasons and its translation.

    Step-by-step setup guide

    To add cancellation reasons, follow these steps:

    • Go to Settings > Subscription > Scroll down to Cancellation reasons.

    • Click on the “+” icon under Normal Cancellations or Extraordinary Cancellations to begin adding cancellation reasons for the selected cancellation type.
    • The Name input field is for internal use only, helping your team distinguish between different cancellation reasons. The text entered in the Translation input field is what will be displayed to customers in the Self-Service Portal.

    • After adding the name and its translation, click the Submit button.
    • Once you’ve completed adding all the cancellation reasons, click Save Changes to finalize your updates.
    Read more
    Payments
    Charge initial payment

    Charge initial payment

    Charge initial payment is a feature available in the circuly operations backend. Learn more

    Feature Overview

    Charge initial payment is a feature available in the circuly operations backend that lets you manually charge the initial payment. The reason why you may want to manually charge an initial payment could be because you use the delayed charge feature.

    Automation via API

    The process of charging the initial payment can be automated via our customer API. This is the POST request you can use https://api-docs.circuly.io/docs/customers-api-docs/3ouxo0e215vwt-charge-initial-payment-by-id that you can use to charge the initial payment.

    Read more
    Subscriptions
    Subscription billing frequency

    Change Billing Frequency

    Swap between billing frequencies.

    Introduction

    Billing frequency refers to the interval at which your business charges customers for a product or service, defining how often payments are collected. In circuly, you can adjust the billing frequency for both consumer durable and consumable products. However, the process for modifying billing frequency differs based on the product type. This article focuses specifically on changing the billing frequency for consumable products.

    Good to know

    The option to change the subscription frequency is only available for consumable subscriptions and will be greyed out for all other subscription types. To change the billing frequency for consumer durable products, follow this guide on changing subscription attributes.

    Step-by-step guide

    • In your circuly Hub > Go to the Subscriptions tab.
    • Click on the three dots to displayed the menu options > Click on change billing frequency.
    • In the Change subscription frequency window select the new Time-unit (weekly, monthly, quarterly) and and a numeric value under interval.
    • Confirm your selection by reviewing the output under Frequency and click on the Confirm button to finalise your change.

    Read more
    Invoices
    Cancellation invoices

    Create Cancellation Invoices and Regenerate Wrong Invoices

    A wrongly generated invoice first needs to be cancelled, and a new invoice must be created for the same with the correct information. Learn more about cancellation invoices.

    Introduction

    When it comes to efforts in invoicing, ensuring accuracy is crucial to maintain legal and financial integrity. Occasionally, errors may arise in invoices, such as incorrect details or missing information. While minor typos can often be overlooked, any mistake that affects mandatory information—such as those outlined in § 14 Paragraph 2 No. 2 of the German VAT Act—must be corrected. Essential invoice details, such as the correct names and addresses of both the supplier and recipient, the invoice date, a clear description of the goods or services, and the VAT charged must be present in the invoice. If any of these mandatory elements are missing or incorrect, the invoice must be corrected to ensure compliance with legal requirements and avoid potential issues with tax authorities.

    Process Overview

    As part of the correction process, the wrongly generated invoices first must to be cancelled and a new invoice needs to generated with the correct information. Cancelling the wrong invoice is an important step for the following reasons:

    1. Legal Compliance: According to tax regulations, such as § 14 Paragraph 2 No. 2 of the German VAT Act (UStG), invoices must contain certain mandatory information. If this information is incorrect, the original invoice cannot be considered valid. By canceling the incorrect invoice, you maintain a clear and legally compliant record of the transaction.
    2. Audit Trail: Canceling the incorrect invoice and issuing a new one creates a clear, traceable audit trail. This ensures that both the original and corrected invoices are documented separately, making it easier to track changes and comply with tax laws in case of an audit.
    3. VAT Accuracy: For VAT purposes, invoices must match the goods/services provided and the tax obligations. Correcting the original invoice could lead to confusion, as tax authorities require a clear breakdown of each transaction. A canceled invoice with a new one ensures that VAT is correctly accounted for and that both the buyer and seller have accurate records.
    4. Customer Transparency: By issuing a new invoice, the customer can clearly see the corrected details and understand that the previous one had errors. This process helps avoid confusion or misunderstandings, especially if the error impacts the amount billed, payment terms, or any other important information.
    5. Consistency: Canceling and reissuing the invoice ensures consistency across your invoicing system, ensuring that your records reflect the actual transaction and not a corrected version of an incorrect document. This avoids discrepancies in your financial reports.

    In summary, canceling the incorrect invoice and issuing a new one is the proper procedure to ensure legal compliance, accurate tax reporting, and transparency with customers.

    Feature Overview

    In circuly you can cancel an invoice with the wrong information and generate a new invoice in its space with just a few clicks.

    Good to know

    1. Cancelling an invoice does not automatically refund the associated payment because its purpose is different. Under German law, an invoice issued with incorrect information must be formally 'cancelled' to comply with legal requirements. However, the payment linked to the incorrect invoice may still be valid. As such, cancelling the invoice does not affect the payment. If you also need to refund the payment, you must initiate a separate refund operation.

    2. Generating a new invoice does not trigger any emails. If you want to send the invoice to the customer, you need to do so manually. To do so > Click on the ↓ PDF button to download the invoice and send it to the customer using your company email.

    Step-by-step guide

    Step 1: Correct the wrong information

    Step 2: Cancel the old invoice

    Step 3: Generate a new invoice

    - Correct the wrong information

    Typically invoice errors are related to either customer or order details. Therefore the first step is to correct the wrong information.

    Updating customer details
    For updating the customer details (such as email and phone number) go to Customers > Select the customer from the Customer List > Go to Billing information in the button right corner > Click on the edit icon > Update the details in the Edit customer window > Click on the Submit button to save your changes.



    Updating order details

    For updating order details (such as the address, date of birth, VAT number etc., of the customer) go to Orders > Select the order from the Order List > Go to Billing information in the bottom right corner > Click on the edit icon > Update the details in the Edit customer window > Click on the Submit button to save your changes.



    - Cancel the old invoice

    Once you have corrected the wrong information, you can proceed to cancelling the invoice with the wrong information. To do so:

    • In your circuly Hub > Go to  Invoices.
    • Search the invoice with the wrong information that needs to be cancelled and click on it.
    • In the invoice details window click the Cancel invoice button.

    • In the next window click on the Cancel invoice button again to confirm.

    • In the Cancel Invoice pop-up window, go through the information so you understand the consequences of the action.

    - Generate a new invoice

    • In the same window > Check the available checkbox to generate a new invoice with the updated information.
    • Click on the Cancel to confirm your action.

    What happens next

    A few changes take affect:

    • The old invoice gets a "cancelled" tag to show that this invoice has been cancelled. The cancelled invoice and the replacement invoice are liked to the original invoice.

    • The replacement invoice has the "replacement" tag.

    • The cancelled invoice has the "cancellation" tag.

    • You can further edit the corrected invoice by making them editable in the same window.
    Read more
    Products
    Bundle collection

    Bundle Collection

    As the name defines, a "bundle" is a collection of products that are grouped together. In subscription terms, a bundle is a collection of products that are categorised under one subscription.

    Introduction

    A "bundle" refers to a collection of products grouped together to offer a comprehensive service or package. In subscription terms, a bundle enables you to categorise multiple products under a single subscription.


    Examples

    1. Bike + lock + helmet + basket

    2. Baby Stroller + stroller rain cover + cup holder

    3. Motor + spring cradle + attachment

    Feature Overview

    Circuly’s Bundle Collection Feature simplifies the process of managing and presenting bundles. While each product in a bundle can have its unique serial number for internal tracking purposes, customers experience the bundle as a single, unified subscription.

    With this feature, you can:

    • Track individual products: Manage inventory effectively by assigning unique identifiers to each product in a bundle.
    • Simplify customer experience: Present the bundle as a single subscription, ensuring customers see a cohesive service without needing to manage individual products.

    Note: Bundles are predefined, meaning customers cannot swap individual items in a bundle. They will only see and manage the bundle as one complete subscription.

    Good to know

    1. Your products and product variants are always set up in your individual shopsystem. circuly only takes over the product information (product name, price etc.) from your shopsystem via a product sync and displays the information under the Product tab in the circuly Hub. 

    2. The product prices are also taken from the shop system, and the bundle collection feature makes use of the default shop system prices (as set up by you). However, it is also possible to have the same price for the entire bundle collection, irrespective of the product selected. If you would like to have this logic, kindly get in touch with us via service desk.

    3. The possibility to select products from a predefined collection is only available for new orders. If you want to make the feature available for your old subscriptions, get in touch with circuly via service desk.

    Step-by-step setup guide

    • In your circuly Hub > Navigate to the Products tab > Then switch to the Bundles tab.

    • Click on the +Bundle button.
    • In the Create bundle collection window > Start by adding a Title and a Description.

    • Use the Select the bundle components dropdown to choose up to 10 products for the bundle.
    Note: Each bundle can only have a maximum of 10 items.
    • Select the desired variants for your chosen products.
    • Click on the Submit button to finalise your bundle.

    You can view all your created bundles under the Bundles tab, where they can be easily edited by clicking the pencil icon.

    Read more
    Account & Setup
    Subscriptions
    Auto renew subscriptions

    Auto Renew Subscriptions

    If your customers do not actively cancel their subscription from the Customer Self-Service Portal or write an email to you to cancel the subscription, you can auto-renew the subscription either manually, or you can automate the process.

    Introduction

    In subscription-based businesses, renewing a subscription is a crucial process that helps maintain ongoing customer relationships and ensures continued access to your products or services. Renewing a subscription means extending its duration, typically after the initial subscription period ends, allowing the customer to continue using the service without interruption. Depending on the business model, subscription renewals can be handled in two main ways: either manually, based on specific customer requests or circumstances, or automatically, where the system renews the subscription at the end of the term.

    This article will guide you through the different methods available for renewing subscriptions in your circuly system—whether you want to manually extend a subscription or automate the renewal process to save time and ensure consistency.

    Feature overview

    Typically, when customers place an order on your website, they agree to a specific subscription duration. This duration is considered both the minimum and the full length of the subscription by the circuly system. Once this period ends, several outcomes are possible, including subscription renewal, cancellation, product return, or product buyout. You have the flexibility to choose whether or not to have the Circuly system automatically renew a subscription at the end of the term. If preferred, you can manually extend the subscription contract based on your specific needs or individual customer cases.

    Step-by-step guide for manual renewal

  • Navigate to the subscription that needs to be renewed.
  • Click on the three dots to open the menu options.
  • Select "Extend Subscription" from the menu.
  • In the Extend Subscription window, enter the desired number of months or duration to extend the subscription.
  • Click Save to confirm the extension.
  • When you use this option to change the end date of a subscription, there is no impact of this action on the auto renew button in the subscription overview window.

    Step-by-step guide for automated renewal: Renew by original duration

    If you want to renew or extend the subscription by its original duration then turn on the switch for the Auto renew subscriptions setting. From now on subscriptions will be renewed by the original subscription duration. For example if it was a 12 months subscription then towards the end of the subscription period it will be extended for another 12 months.

    Step-by-step guide for automated renewal: Renew by custom duration

    If you do not want to renew the subscription by its original subscription duration then you can define a custom value for the renewal. To do this > First go to the Auto renew subscriptions setting and turn on the switch > Next go to the Custom auto renew subscription setting and turn on the switch for this setting > Then add a numeric value in the Custom auto renew duration input field. From now on the subscription will be renewed by the value defined in this input field.

    Important: Do not enable the switch for the Auto renew subscriptions setting if you want to renew subscriptions manually on on individual subscription level as every subscription will be renewed automatically at the end of the subscription period if you enable the auto-renew subscription setting.

    When a subscription has been auto-renewed because of the auto-renew subscription setting, the auto-renew switch in the subscription overview window will be enabled. The button provides a visual reference to determine which subscription is renewed and which is not.

    Read more
    No items found.

    Auto cancel subscription when customer makes a cancellation request from the customer portal

    In the customer portal, your customers can make a cancellation requests. When they do so, the subscription is cancelled, and the subscription status is set to pending return.

    In the customer portal, your customers can make a cancellation request (if you've not disabled the option to do so in your settings). When they do so, the subscription is cancelled and the subscription status is set to pending return (if the Auto-cancel subscription setting is enabled in the Customer Self-Service Portal settings). Setting the subscription status to pending return triggers the return process.

    You can decide whether or not a subscription should be automatically cancelled and if the subscription status is set to pending return when a customer makes a cancellation request through the customer portal.

    In the circuly operations backend, you can enable or disable the auto-cancel subscription setting.

    • If you enable it then the subscription will be cancelled and the subscription status will be set to pending return.
    • If you disable the setting (default value of the setting) the subscription will not be automatically cancelled and will not be set to pending return.

    If you want to enable this setting, follow these steps:

    • Login to your circuly operations backend.
    • Go to Settings > Customer Login > COMPANY INFORMATION > enable the switch for Auto cancel subscription.

    Once you enable this, all future cancellation requests made via the customer login will be auto cancelled and the subscription status will be set to pending return so that return workflow can trigger.

    When this setting is disabled, and a customer makes a cancellation request from the customer login the following happens:

    For your customer: your customer will receive an email that the cancellation request is being processed.

    For you: the connected customer support inbox will receive an email that a cancellation request has been made from the customer login. Additionally, a note will be created on the order level that a cancellation request has been made for this order.

    Read more
    Orders
    Subscriptions
    Bulk update subscriptions

    Bulk Update Orders Into Subscriptions

    Learn how to bulk update orders into subscriptions and save operational time to improve efficiency.

    Introduction

    circuly provides a convenient way to bulk update orders and create subscriptions, helping you save time and maintain accuracy. This guide walks you through the steps to bulk update orders, create subscriptions, and understand the resulting actions in circuly.

    Step-by-step guide

    Follow these steps to efficiently bulk update orders and create subscriptions:

    • Filter Unprocessed Orders (Optional)

    Before you begin you can filter the Order List to only display orders that are currently unprocessed that is orders that do not have a subscription attached to them yet. To do so > Navigate to the Orders tab > Click in the button that says Predefined to display the predefined filter options > Select Unprocessed from the list.

    The Order List now displays orders that need to be processed.

    • In the Order List, select the orders you want to create subscriptions for by checking the corresponding boxes.

    • Once the desired orders are selected, click the BULK UPDATE button to proceed.

    • In the pop-up window, enter the required information, such as the serial number and other subscription details, as you would normally when creating a subscription)

    • After creating a subscription for an order, a success message will appear on your screen, confirming the action.

    • Use the left and right arrows in the pop-up window to move between orders and create subscriptions for each selected order.

    • After creating subscriptions for all selected orders, click the CLOSE button to exit the pop-up window.
    • Navigate to the Subscription List to view the newly created subscriptions

    What happens next

    1. The "Subscription activated" email is sent to the customer from the Email Templates.
    2. The order is displayed in the Subscription List under the Subscription tab.
    Read more
    Account & Setup
    Availability Calendar

    Date picker

    The date picker feature can be used to display a calendar in the checkout. You can use the calendar for either a delivery or a pickup logic for the product or both.

    Introduction

    The Date Picker feature in circuly enables you to provide your customers with the ability to select a delivery or pickup date when finalising their subscription product order on your checkout page. This feature allows for greater flexibility, helping customers schedule deliveries or pickups according to their preferences. Whether you use the calendar for delivery, pickup, or both, the Date Picker enhances customer experience by streamlining the ordering process.

    Feature Overview

    The Date Picker feature allows you to integrate a calendar on your checkout page, where customers can choose their preferred delivery or pickup date. This feature can be customised to suit various needs, including specifying which days are available for delivery, setting limits on the number of deliveries per timeslot, and defining specific times for delivery or pickup. You can also include custom messages to guide your customers through the selection process.

    Key options include:

    • Custom note: Display a personalised note on the checkout page and in the self-service portal.
    • Days availability: Choose the days of the week available for delivery or pickup.
    • Ignore quantity: Decide if there should be limits on how many deliveries/pickups can be scheduled for a given time slot.
    • Lead time: Specify how many days in advance a customer can select a delivery/pickup slot.
    • Quantity: Set the total number of deliveries/pickups available in a given timeslot.
    • Timeslot Days: Determine the number of available slots per day.
    • Timeslot Duration: Define the duration of each time slot.
    • Start and End Time: Control the earliest and latest available time slots.

    Step-by-step setup guide

    Follow these steps to set up the Date Picker and customise the options for your customers:

    • Navigate to Settings > Checkout > Delivery Date.
    • Click on the arrow to expand the section.
    • Enable the switch for Allow selecting delivery date.
    • Custom Note: Add a custom note to be displayed on the checkout page and in the self-service portal. This note can inform customers about specific details like opening hours, special instructions, etc.
    • Date: Select Available Delivery Days. Choose which days of the week customers can select for delivery or pickup. You can exclude weekends or offer specific days only (e.g., Saturday and Sunday).
    • Enable the Ignore quantity switch if you don’t want to limit the number of deliveries/pickups for a given timeslot. If you want to limit the number, set the Quantity value to define the total number of products that can be delivered or picked up per timeslot.
    • Set Lead Time. Define the Lead time by specifying how my days from today the first available timeslot will be offered.
    • Timeslot Days: Set the number of available slots for each selected delivery day (e.g., 6 slots per day).
    • Timeslot Duration: Set the duration for each timeslot (e.g., 2 hours per slot)

    See the image reference below to see how the time slots are displayed when the timeslot duration is 2 hours.

    • Start Time: Choose the earliest time that can be selected for delivery or pickup (e.g., 9 AM).
    • End Time: Choose the latest time available for a timeslot (e.g., 4 PM).
    • After customising all options, click Save changes to apply the settings.
    Read more
    No items found.

    Allowed, Default and Preferred Language in the circuly Operations Backend

    This guide explains how to configure and manage language options in circuly for the Checkout page, Self-Service Portal, and email communications, ensuring a tailored experience for customers across different regions.

    Introduction

    circuly offers multiple language options for the Checkout and Self-Service Portal to ensure a seamless experience for customers across different regions. This article outlines the languages currently supported, how to enable language options, and how the system uses language preferences to communicate effectively with customers. It also explains the importance of setting up a default language and answers commonly asked questions about language selection and email communication.

    Languages currently supported by circuly

    The Checkout and Self-Service Portal are available in multiple languages and can be displayed in the following options:

    • German
    • English
    • French
    • Spanish
    • Dutch
    • Swedish
    • Norwegian
    • Greek
    • Italian
    • Spanish
    • Slovenian

    Note: While translations of the checkout and self-service portal are available in the languages mentioned above, the email templates are only available in English and need to be translated for all other languages. 

    Language types in circuly

    To better understand how language settings function in Circuly, it's important to define the three main types of language settings used within the platform: Allowed Language, Preferred Language, and Default Language. Each plays a key role in ensuring effective and seamless communication with customers.

    - Allowed Language

    The Allowed Language refers to the list of languages that you, as a business, make available for your customers to choose from on the Checkout page and in the Self-Service Portal. These languages are configurable in the circuly Hub, allowing you to select which languages should be accessible for customers based on their region or preferences. Only the languages selected from the Allowed Languages dropdown are available for customers to select.

    - Preferred Language

    The Preferred Language is the language chosen by the customer from the Allowed Languages list during their interaction with the Checkout page or Self-Service Portal. It can also be based on their browser language settings. Once selected, the customer’s Preferred Language is saved in the circuly system and used for all future communications, such as emails, invoices, and notifications.

    - Default Language

    The Default Language serves as the fallback language in case no Preferred Language is selected, or if there are no email templates available in the customer's selected language. It is the language Circuly will use for all communications (emails, invoices, etc.) when no language preference is provided or when the customer’s Preferred Language is unavailable. This ensures there are no gaps in communication and that customers always receive the necessary information, even if their selected language is not available.

    Example: You have three language options available on your webshop; English, German, and Dutch. A prospect lands on your webshop and proceeds to the checkout page in Dutch. The preferred language of this customer is saved as Dutch in the circuly operations backend. If you have email templates set up in Dutch then the circuly operations backend will use Dutch as the language of communication with your customer. If you do not have email templates set up in Dutch then the circuly operations backend will use the default language and the email templates set up in the default language.

    As you can see setting up a default language is important to avoid any communication gaps and operation hassles. 

    Step-by-step setup guide

    Follow the steps given below:

    - Setup guide for Allowed languages

    • Log into your circuly Hub.
    • Navigate to the Settings tab in the top navigation bar.
    • Go to Company Settings > LOCALE > Allowed Languages.
    • In the Allowed Languages section, you will see a dropdown menu where you can select the languages you wish to offer to your customers.
    • Pick the languages you want to make available for your customers in the Checkout page and the Self-Service Portal.
    • To finalise and save your settings, click on the Save changes button.

    Once selected, these languages will be displayed in the language switcher, allowing your customers to switch between the available options.

    Note: When you update the Allowed Languages settings by adding or removing languages, a corresponding language tab will appear or disappear in the Email Templates tab. Please note that emails for newly added languages are not automatically created; you will need to manually configure the email templates for these languages.

    - Setup guide for Default language

    • Log into your circuly Hub.
    • Navigate to the Settings tab in the top navigation bar.
    • Go to Company Settings > LOCALE > Default Language.
    • Click on the dropdown arrow to see the dropdown list and proceed by selecting a language that should be used as the default language.
    • To finalise and save your settings, click on the Save changes button.

    - Setup guide for Preferred language

    There is no separate setup guide for Preferred Language, as the Preferred Language is automatically based on the language selected by the customer during the Checkout process or in the Self-Service Portal. When a customer chooses a language from the available Allowed Languages, their selection is saved as their Preferred Language in the system, which is then used for all subsequent communications.

    Frequently asked questions

    1. What language will be shown to the customer when they access the checkout for the first time t?

    The language shown in the checkout is based on the browser preference. Hence if your browser preference is English but your default language is German, the checkout would still be shown in English and also the email sent in English. 

    2. What triggers the email to be sent in a different language?

    If the customer changes the language after checkout in the Self-Service Portal, this will also change the selected email language. 

    3. In what language will be the email sent if I trigger the email manually again from the circuly Hub?

    The email will be always sent out in the saved preferred language that the customer selected.

    Read more
    Orders
    Order list

    How to Customise the Order List View Window

    De-clutter your Order List view and customise it to only see what you want to see.

    You can easily select and deflect what you want to see in the Order List view by following these steps.

    • Go to Orders and navigate to the view icon on the right. (see image below)

    • Click on it to view the currently selected and deflected columns.
    • Hover over the columns you want to select/deselect and click on it to make the checkbox appear/disappear.
    • Once you are done, click on the little floppy icon on the right to save your selection.
    • Click anywhere else on the screen to exit out of the Table columns window.
    Read more
    Orders
    order list

    The Order List: Explained

    The order list contains a list of all orders that come in from your shop system when your customer proceeds through the checkout.

    When you go to Orders in the left navigation bar, the Order List is displayed. The Order List shows the order List Columns that can be customised to display only what you want to see. In the order List are also additional functionality, explained below:

    • Search bar: the capabilities of the search bar can be used to search for an order ID, customer email ID, amount (associated to the product), customer name, status of the order and tag of an order. How you use it is completely under your control. One use case that we can think of is when there is a customer query about a particular order and you want to search for the information based on the information provided to you by your customer. If a customer has the ID, you can enter the ID in the search bar to locate the order associated with that ID. In case your customer is unable to locate the ID then you can even search for the order based on the email address or name of the customer. 
    • Filter: the filter feature enables you to refine your search even more. Instead of going through the order list, you can use filters to display exactly what you are looking for. 
      Use case: you want to see all the orders that came in on a particular date and want to check the status of all those orders. The way you proceed would be to select the order date as the field in the filter window and select the date range. Next you can insert an additional filter, let’s say status, and insert the value as (open….) in the value input field. The filter feature enables you to have a granular view of what you’re looking for. Needless to say it saves time by enabling you to combine  multiple filter fields. 
    • Hide Processed: the HIDE PROCESSED button removes all processed orders from the Order List view and only displays unprocessed orders.
    • Export: You can download the entire order list if you want or download selected items by checking the checkbox on the left most side. If there is something particular that you wish to download, then you can do so by first using the filter feature to define what you are looking for and once you have the desired result, you can export the file by clicking the EXPORT button. you can export a file either as .CSV or as .XML
    • Mark Completed: mark completed means that the order has been prepared and shipped to the customer. It then receives the "fulfilled" status in the circuly operations backend.
    • Bulk update: to use the BULK UPDATE feature, you first need to select a few order from the Order List that you want to update. Once you've selected a few orders, you can click on the BULK UPDATE button to create a subscription for multiple orders without having to go inside the order and creating a subscription from the Order Detail view.
    • Three dots: the three dots let you customize the Order List view by selecting and deselecting which columns are displayed. Particularly handy when you want to export the data to some other tool but do not want to download unnecessary fields. 
    Read more
    Customer Self Service

    Actions and operations your customers can do and see in the Self-service portal.

    Here's a list of actions that your customer can take from the self-service portal.

    By embracing the power of the circuly Self-Service Portal, you're not just freeing your Customer Success team from operational constraints, but also delivering the transparency your customers crave. This transparency isn't just a feature – it's a catalyst that fuels the transformation of customer experience into something truly extraordinary.

    This article offers detailed insights into the self-service portal's features. Written for your customers, you can easily copy and paste this information onto your website, providing them with a clear guide to navigate their self-service options effectively. We only recommend that you make use of your own screenshots so that the information appears to be tailored to your audience.

    Note: If you do not provide one or more options mentioned below, compile your own custom article based on the information mentioned in this article and make it available on your own website.

    What you see in the customer self-service portal

    In the Customer self service portal (CSS), you have an overview of all the products subscribed by you. Additionally, you can also access your invoices and personal detail. Given below is a list of all the things you can see in the CSS. 

    • Your subscriptions
    • Your orders
    • Your invoices

    Your subscriptions

    You can see both active and ended subscriptions in the CSS. You can also see the monthly subscription price for all your subscriptions. Under "Your Subscriptions", you can only see products that have or were a subscription. If you have one-time orders, they are displayed under "Your Orders". 

    Your orders

    You can find all your orders, both subscription and one-time, under "Your Orders.

    Your invoices

    You can access and download invoices for subscription payments that have already been paid under “Your invoices”. 

    What can you do in the CSS?

    The CSS enables you to perform actions such as cancelling subscriptions, changing your payment and personal details, downloading invoices and reporting product issues without calling customer support or writing an email. Given below is a list of actions you can perform in the CSS. 

    Read more
    Subscriptions
    Extend subscription duration

    Change or Extend the Subscription Duration

    Change subscription duration, subscription price and so on easily in one place.

    Subscriptions have a duration attached to it and there can be a number of circumstances under which you might be required to change the duration of a subscription. 

    Use cases covered

    Scenario: When your customer makes a request to extend the subscription duration and there is no change in the subscription price. 

    Action: Use the Extend subscription function. The “Extend Subscription” function only changes the end date of the subscription and extends it. 

    Scenario: When your customer changes their mind and wants to revert the change and set it back to its original duration. 

    Action: First check the already changed end date of the subscription. Then use the “Change subscription duration” function to revert the change. 

    Scenario: When your customer wants to change their subscription duration and as a result their is a change in the price of the subscription   

    Action: Use the “Change subscription duration function” to change the subscription and the subscription duration.  

    The function you use depends on the end result you desire.

    If you only want to change the duration and do nothing with the payments attached to it, then we recommend using the "extend subscription duration" function. 

    If you want to change the duration and also make changes to the subscription price, then we recommend using the "change subscription duration" function.

    Change subscription duration


    To change the subscription duration follow the steps given below or the video tutorial given below:'


    Steps:

    • Go to the Subscriptions tab > Locate a subscription thet you want to edit > Scroll to the right to display the three dots.
    • Click on the three dots to display the menu options > Select Change subscription attributes from the options.

    • In the Change Subscription Attributes window make the necessary changes > Click on the SUMBIT CHANGES button.

    Options

    1. In the Change Subscription Attributes window check the box on top for Change end date only, if you only want to change the end date. If you dont want to do that, then don't check the checkbox.
    2. If you want to change the subscription duration then edit the Subscription length field.
    3. If you want to change the subscription price then edit the Subscription installment price field.
    4. If you want to change the total subscription amount then edit the Total subscription price field.
    5. If you want to change the payment collection interval then select your choice from the dropdown list. Avaliable options include monthly, daily, yearly and weekly.

    Alternatively you can also click on a subscription in the Subscription List to go to the Subscription overview. If you are in the Subscription overview, you can access the subscription duration setting by clicking on the three dots in the top right corner (see image).

    Then follow the same steps mentioned above to edit the subscription duration.

    Extend duration

    To only extend the subscription duration, follow the steps given below:

    • Go to the Subscriptions tab > Locate a subscription thet you want to edit > Scroll to the right to display the three dots.
    • Click on the three dots to display the menu options > Select Extend subscription from the options.

    • In the Extend subscription window make the necessary changes > Click on the CONFIRM button.

    Alternatively you can also click on a subscription in the Subscription List to go to the Subscription overview. If you are in the Subscription overview, you can access the subscription duration setting by clicking on the three dots in the top right corner (see image).

    Then follow the same steps mentioned above to only extend the subscription duration.

    Use case: Customer changed their mind about extending the subscription and wants the subscription to be restored to its original duration. How can you cancel the change already applied?

    To cancel the extension of the subscription duration, simply use the Change subscription duration function to restore it to it's original duration.

    Follow the steps mentioned above under Change subscription duration.

    Read more
    Account & Setup
    Auto cancel subscriptions

    Setting: Auto Cancel Subscription

    The auto-cancel subscription setting automates the process of setting the subscription status as pending return and triggering the return workflow.

    Your customers can make cancellation requests either from the Customer Self-Service Portal or by getting in touch with your customer support. 

    Cancellation request via Customer support 

    When they get in touch with your customer support, you have full control over how you want to cancel the subscription and if you want to cancel it. This process is manual as it requires a circuly user to cancel the subscription manually from the circuly Operations backend.

    Cancellation request via Customer Self-Service Portal 

    However when cancellation requests are made from the Self-Service Portal, a few actions can be taken by the circuly system depending on your setting. 

    One setting that influences what happens when a customer makes a cancellation request is the Auto cancel subscription setting. 

    The Auto cancel subscription setting is disabled by default and can be made active by turning on the switch. 

    Scenario overview

    Here’s an overview of the different cancellation situations and their implication based on the Auto cancel subscription setting:

    Cancellation within early cancellation period and interaction with the Auto cancel subscription setting

    Scenario 1

    • Auto cancel subscription setting enabled.
    • Customer makes cancellation request from the customer Self-Service Portal.
    • Cancellation request is within the early cancellation period.
    • Customer selects “immediately” as an option to return the product.

    Result: The auto renew button is turned off (if it was originally in an active state), the subscriptions gets cancelled and the subscription status is set to pending return to trigger the return workflow. 

    Scenario 2

    • Auto cancel subscription setting disabled.
    • Customer makes cancellation request from the customer Self-Service Portal.
    • Cancellation request within the early cancellation period.
    • Customer selects “immediately” as an option to return the product.

    Result: The auto renew button is turned off (if it was originally in an active state), the subscriptions gets cancelled and the subscription status is set to pending return to trigger the return workflow. 

    You might have noticed that the state of the "Auto cancel subscription" setting has no impact if the cancellation request is made within the early cancellation period and the the option selected by the customer to return the product is "immediately". This is because the customer has the right to cancel the subscription if the cancellation has been made within the early cancellation period and therefore the auto cancel subscription setting has no impact on the cancellation request.

    Scenario 3

    • Auto cancel subscription setting enabled
    • Customer makes cancellation request from the customer Self-Service Portal.
    • Cancellation request within the early cancellation period.
    • Customer selects “after minimum duration” as an option to return the product.
    • The auto renew button is turned off (if it was originally in an active state).
    • The subscriptions gets cancelled and the subscription status is set to pending return to trigger the return workflow.
    • You see the tag cancelled by customer to denote that the cancellation has been made by the customer and that the cancellation will be processed on the end date. 

    Scenario 4

    • Auto cancel subscription setting disabled.
    • Customer makes cancellation request from the customer Self-Service Portal.
    • Cancellation request within the early cancellation period.
    • Customer selects “after minimum duration” as an option to return the product.
    • The auto renew button is turned off (if it was originally in an active state).
    • The subscriptions DOES NOT get cancelled and the subscription status IS NOT set to pending return.
    • You see the tag cancelled by customer to denote that the cancellation has been made by the customer and that the cancellation will be processed on the end date. 

    Cancellation outside of early cancellation period and interaction with the Auto cancel subscription setting

    Scenario 5

    • Auto cancel subscription setting enabled
    • Customer makes cancellation request from the customer Self-Service Portal.
    • Cancellation request is outside of the early cancellation period.
    • Customer does not see an option to return the product and only sees the cancellation reasons field.
    • The subscription status is set to pending return to trigger the return workflow and the tag cancelled by customer to denote that the cancellation has been made by the customer and that the cancellation.
    • The "Auto renew" button in the Subscription overview window is turned off so that the subscription doesn't renew
    • The minimum subscription period is ignored and the subscription sets cancelled.

    Scenario 6

    • Auto cancel subscription setting disabled.
    • Customer makes cancellation request from the customer Self-Service Portal.
    • Cancellation request is outside of the early cancellation period.
    • Customer does not see an option to return the product and only sees the cancellation reasons field.
    • The subscription status IS NOT SET to pending return and remains in an active state. The tag cancelled by customer is assigned to denote that the cancellation has been made by the customer and that the cancellation. Additionally the tag cancelled on end date tag is assigned to denote that the cancellation will be processed on the end date of the subscription.
    • The "Auto renew" button in the Subscription overview window is turned off so that the subscription doesn't renew.

    Learn more about the entire cancellation process in this Miro board to understand actions taken by a user and by your customer for cancellations.
    Read more
    Account & Setup
    Customer Self Service
    Change payment details

    Self-Service Portal - Change Payment Details

    Enable your customers to update their payment details without contacting your customer support.
    Tip: This process can be automated via our customer API. This is the GET request you can use https://api-docs.circuly.io/docs/customers-api-docs/tyvbuteuftq44-get-the-order-s-update-payment-link that you can use to get the link for updating the payment details. You can forward the link to your customer via email.

    Your customers can change their payment details in the Self-Service Portal in the same window as their address. 

    Given below are the instructions you can pass on to your customer about updating their payment details from the Self-Service Portal:


    To change payment details > Go to Your Orders > Choose an order and click on the arrow icon > You will be taken to your order overview page > in the order overview page scroll down to Current payment method > Click on UPDATE PAYMENT METHOD

    Note: If you wish to add a custom description to this window, you can write us a service desk ticket, with your desired text.

    You will be taken to a new browser window where you will have the option to update your payment method > Click on your desired option > Fill in your payment details > Confirm your selection.

    Your payment method will now be updated.

    Read more
    Subscriptions
    Two-click cancellation

    Two-Click Cancellation flow in circuly

    In October 2021, a new law was introduced in Germany about the termination of subscription contracts. Here's how the implementation of the two-click cancellation process looks in circuly.

    In October 2021, a new law was introduced in Germany about the termination of subscription contracts.

    Here a recap:

    • All consumer-facing businesses can no longer bind consumers for yearly renewals.
    • Businesses must provide a VISIBLE cancellation button on the website so consumers can easily cancel their subscription contracts.
    • The cancellation button must be permanently accessible on all pages and clearly labelled.
    • The cancellation button must lead the consumer to a confirmation page where they can provide information on the type of termination, the reason for termination, clear means of identification, the time at which the termination shall take effect and contact data to confirm the termination easily by electronic means.
    • Customers should also be able to save and be provided with the termination notice.  The notice should clearly indicate that the termination was submitted by pressing the confirmation button.
    The two click cancellation law is effective as on 1st July 2022.

    How the process should looks

    Button on the website (taken care of by you): As part of the "two-click cancellation" process you must add a button on your website that indicated that it's a cancellation button.

    Confirmation page (taken care of by circuly): The button should then lead to another page where the customer can provide information on the type of termination, the reason for termination, clear means of identification, the time at which the termination shall take effect and contact data to confirm the termination easily by electronic means.

    Here’s how the implementation looks with circuly

    Step 1: Add a button on your website

    Add a cancellation button on your website that is easily visible and accessible at all times and gives clear indication that it is a cancellation button. Your customers can click on this button to proceed to the cancellation steps.

    Step 2: Button leads to the customer self-service portal

    Clicking on the button will take your customer to the customer self-service portal where they can sign in with their email (the email used to place the order on your website) to access and manage their subscriptions and request cancellation.

    Step 3: Cancellation button for every subscription

    A visible cancellation button has been added to every product and can be seen under all the active subscriptions by the customer, as shown in the image below.

    Screenshot of the circuly customer self-service to show the cancellation button


    Step 4: Button leads to the confirmation page

    The cancellation button leads your customer to a confirmation page within the customer self service portal itself (as shown in the image below). The confirmation page provides the customer with the necessary information about the subscription they are cancelling and additional options to conclude their cancellation request.

    Screenshot of the circuly customer self-service to show the cancellation flow

    On the confirmation page your customer can do the following:

    • Select the “Cancellation type” from the dropdown menu, that is, a Normal cancellation or an Extraordinary cancellation. Based on the selection under “Cancellation type” the “Cancellation reasons” are displayed (the “Cancellation reasons” can be edited in the Settings in the circuly Operations Backend).


      Normal cancellation: the process of terminating a subscription within the standard terms and conditions set forth by the service provider.

      Extraordinary cancellation: extraordinary cancellation refers to the termination of a subscription under exceptional circumstances that deviate from the regular terms and conditions


    Screenshot of the circuly customer self-service to show the cancellation flow

    Important note: Read more about how to set up cancellation reasons at the end of this article.

    • Select the “Cancellation reason”.
    Screenshot of the circuly customer self-service to show the cancellation flow



    • Select a “Pickup date”.
    Screenshot of the circuly customer self-service to show the cancellation flow

    Important note: Displaying the “Pickup Date” on the confirmation page is optional. It is by default turned off and disabled. To enable it go to your circuly operations backend > Settings > Customer login > CANCEL OPTIONS >  Enable the switch for Pickup date as shown in the image below.

    • Write a message in the “Your message” input field.

    Step 5: Display the cancellation details for confirmation

    If the customer has already sent the cancellation request for a particular product, then the following happens:

    • The buttons that say “Cancel subscription” disappears (as shown in the image below)
    • The status of the subscription is changed to “cancelled” and displayed under the product (as shown in the image below).
    • The customer can also see the Cancellation date and the Subscription end-date (as shown in the image below).

    Important note: The subscription end date is based on the subscription start date. If the customer has selected a 12 months subscription and started the subscription on 1st April then the displayed subscription end date will be 31st March. When the subscription end date has arrived and the subscription is still active, the subscription is extended by a month (if auto renew is enabled) and the end date changes accordingly as per this date, that is the new end date will then be 30th of April.

    Step 6: Customer receives a confirmation email.

    As part of the “two-click cancellation” law, your customers get a confirmation email about their cancellation. The email that you customers receive from the Email templates (in circuly) is called Subscription Cancellation Received.  Edit the email template to your liking and branding and include cancellation specific variables of your choice.


    Important note: If you are using the “Auto cancel subscription” setting option to process the cancellation requests, remember to add return instruction in the Subscription Cancellation Received email because this option (that is using the “auto cancel subscription setting to process cancellation requests) bypasses the Subscription almost over email (which typically contains the return instructions for the product when the subscription is about to end).

    Scrrenshot of the email templates tab in the circuly operations backend to show the email



    How the cancellation process works for you?

    Option 1: When the “Auto cancel subscription” setting is enabled

    The “Auto cancel subscription” setting is used when you want a subscription to be set to pending return automatically and bypass the minimum subscription duration period when a customer makes a cancellation request from the self-service portal.

    Setting the subscription status as pending return triggers the return workflow which means that the minimum subscription period is not valid anymore and the subscription cancellation request will take effect as soon as the subscription status is set up pending return.

    Example: Your customer made a cancellation request via the Customer Self-Service on 1st of July. If the “Auto cancel subscription” setting is enabled then the subscription is set to pending return immediately and the return workflow is triggered. Now the customer has “x” no. of days to return the product back to you (x is defined in the Return until period setting) after which the reminder emails will be sent and if the customer does not return the product the subscription will be reactivated and the recurring payments will continue to be charged again.


    How to enable the Auto cancel subscription setting?

    Go to Settings > Customer login > CANCEL OPTIONS > Enable the switch for Auto cancel subscription.

    When this setting is enabled and when the customer makes a cancellation request from the self-service portal, the following happens:

    • Your connected support inbox receives a copy of the Subscription Cancellation Received email.
    • The Auto renew button is turned off (if it was originally turned on).
    Screenshot of the subscription overview in the circuly operations backend to show the auto renew button switched off

    • In the Subscription List the status of the order changes to “pending return” plus “cancelled by customer” to indicate that the cancellation request was made by the customer via the self-service portal and that the subscription status is automatically set to pending return. Setting a subscription to pending return triggers the return workflow.
    Screenshot of the subscription list in the circuly operations backend to show the status cancelled by customer under status column

    • When the product is returned to you, mark it as returned to end the subscription and stop recurring payments.
    • The subscription almost over email is bypassed and not triggered. Kindly remember to add the return instructions in the Subscription Cancellation Received email.

    Option 2: When “Auto cancel subscription” setting is disabled

    When the “Auto cancel subscription” setting is disabled then the following happens:

    • The Auto renew button is turned off (if it was originally turned on).
    Screenshot of the subscription overview in the circuly operations backend to show the auto renew button switched off

    • The subscription is NOT set to pending return.
    • The status of the subscriptions remains active and the “cancelled by customer” status is added to it to indicate that it's a cancellation request from the Customer Self-Service.
    • Your connected support inbox receives a copy of the Subscription Cancellation Received email plus an additional email about the cancellation request.
    • Check if the cancellation request is valid and if you want to process the cancellation request.

    Cancellation request is valid: If you want to process the request, you don't have to do anything. The circuly system will wait until the minimum subscription period is over and will send the “subscription almost over email” x days before the actual end date of the subscription. (You can define the value for “x”, that is when the subscription almost over email is sent to the customer is your settings. To define a value for this go to Settings > Email > SUBSCRIPTION NOTIFICATIONS > Enable the switch for Subscription is almost over > Add a numeric value in the Days calculation before ending input field.

    Cancellation request is not valid: the only reason why a cancellation request is not treated as valid is when the request has been made while the subscription is still under the minimum subscription period. In this case the cancellation request is still valid but only after the minimum subscription period is over. Since auto renewal is turned off automatically and the subscription is not extended by another month, the system will follow the same process, that is it will wait until the minimum subscription period is over and will send the “subscription almost over email” x days before the actual end date of the subscription.

    • When the product is returned, you need to process it how you normally would, that is by marking the product as returned.
    • Marking the product as returned ends the subscriptions and stops recurring payments.

    Extra

    Adding a support email

    Support email is the email you’ve entered in the circuly operations backend under the Support email address setting.

    If you haven't added an email yet you can do so by logging in to your circuly operations backend > Go to Settings > Customer login > COMPANY INFORMATION > And enter an email Id for support and contact matters in the Support email address input field.

    Adding Cancellation reasons

    The cancellation reasons are displayed to your customer in the customer self-service portal and can be edited.

    To add cancellation reasons, follow these steps:

    • Go to Settings > Subscription > Scroll down to CANCELLATION REASONS.

    Screenshot of the cancellation reasons setting in the circuly operations backend

    • Click on the “+ plus icon under Normal Cancellations and/or Extraordinary Cancellations to to start adding cancellation reasons for the cancellation type.
    Screenshot of the set up of the cancellation reasons in the circuly operations backend



    • Add a reason in the name input field and then add the translation options in the respective input fields for the given languages.
    Screenshot of the set up of the cancellation reasons in the circuly operations backend

    • When you’ve added the name and their translation, click on the SUBMIT button.
    • Once you’re finished with adding all the reasons click on the SUBMIT CHANGES button.  

    Read more
    Orders
    Subscriptions
    Cancel order, set as pending return

    The difference between “cancel order” and “set as pending return”

    Both “cancel order” and “set as pending return” are ways to process a cancellation request but with different logic and background.

    Both “cancel order” and “set as pending return” are ways to process a cancellation request but with different logic and background.

    Orders can be “cancelled” and subscription status can be “set as pending return”.

    When should you use “cancel order”?

    Cancel order should be used when there is no active subscription attached to the order and the product has not been delivered yet. Cancelling an order in the circuly operations backend also cancels the order in the shop system. This is relevant if you work with fulfilment partners who do not have access to the circuly backend as a user but process the orders (that is send it out for delivery to the end customer) based on the order status in the shop system.

    Another reason for orders are cancelled and not set as pending return because cancelling an order has monetary implications: when you cancel an order, you can process a refund at the same time. Whereas when you set the subscription status as pending return, only future recurring payments are stopped.

    When should you use “set a spending return”?

    Marking the subscription status as pending return should be done when there is an active subscription for an order or when the product has already been delivered to the customer. Marking the subscription status as pending return means that you should expect the product to come back which is not the case when an order is cancelled because no product has been delivered anyway. But a subscription is created either when the product is being delivered or has been already delivered.

    Another reason why subscription status are set as pending return and not cancelled because setting the subscription status as pending return triggers the return process.

    Read more about the return process.

    Read more about what is pending return.

    Read more
    Account & Setup
    Webhook

    How to Create a Webhook?

    Easily transfer data from circuly to an API endpoint or Zapier via Webhooks.

    Webhooks are automated messages sent from one app to another in case something happens or something is updated/changed. Example: if you want to send all transactions from the circuly operations backend to your bookkeeping system (tool) you can do that via Webhooks. In your circuly operations backend, you can now access Webhooks. You will find them in the left main menu under Admins.


    How it works?

    In order for circuly to make the requested information available to you we need a URL where the information can be sent (pushed) to. The URL can be generated by tools like Zapier or it can be one of your API endpoints. Make sure that the URL where you want the information to be sent to, can be caught by circuly. To ensure that, make sure that URL allows a POST request since circuly PUSHES the information to your specified URL. Once you create an event for the information you want, circuly will push the information to the URL specified by you and will also push any changes made to the event.

    How to create a webhooks in the circuly operations backend?

    To create a web hook:

    • Go to Webhooks and click on CREATE WEBHOOK.

    • In the Create Webhook window select an Event for which you want information.

    At present Events can be created for customer, order, order item, subscription and transaction.


    • In the URL field attach the URL of the receiving app (URL generated by tools like Zapier or from your API endpoint).

    Bonus

    How Webhook works with Zapier?

    In Zapier you can create a new Zap and say that the source is a webhook. On doing that Zapier will generate a URL that you can paste in the URL field of the Create Webhook window in your circuly operations backend.

    Figure out what information is fired

    You can use websites like Webhook.site to check what information is being fired.

    Read more