Chargebee + Loop

Integration time: 10 minutes


If a customer of Loop already uses Chargebee as a subscription management platform, a Chargebee integration with Loop offers many advantages and is often the best way for that customer to accept automated payments of crypto.

One of the advantages of using Chargebee as a central subscription management platform is that companies can use the exact same logic for managing their customers' subscriptions, regardless of whether their customers have chose to pay with cash/credit cards or crypto.

Chargebee allows for multiple payment gateways, including offline payments. When Loop is used for payment, Chargebee records the payment as an offline “other” transaction and then updates the customer's payment record for the subscription.

Getting started

Loop built a seamless integration for companies to get on-boarded in minutes. Our automated setup allows companies to provide Loop with a site URL and Chargebee API key that are used to pass information between the two systems.

For companies that prefer to sign their own transactions, or want to integrate custom flows for their use case that are beyond the scope of Loop's integration with Chargebee, please reach out to us at for access to a guide on how to deploy a Loop/Chargebee integration manually. Manual integration involves custom software development but can suit more complex use cases.

To check out the automated integration in action and see more details on the setup process, you can check out our video series.

How it works

This overview assumes an automated setup.

Adding in plans (subscriptions)

At integration, Loop will pull in any “plan” already configured. Going forward as plans are made in Chargebee, they will automatically be created in Loop.

For each Plan, Chargebee offers a variety of pricing models. The range of pricing models include:

  • Flat Fee - fixed recurring charge (e.g., $100 per month)

  • Per Unit - charges based on quantity used at a fixed per unit price (e.g., $1 per unit consumed)

  • Tiered - charges based on quantity used with per unit pricing adjusted based on quantity consumed.

  • Volume - charges based on volume usage tiers.

  • Stairstep - for each tier, a flat price is assigned instead of a per-unit price.

For more details on how to implement these pricing models with Loop, please refer to the Chargebee subscriptions page. For more details on how Chargebee pricing models work, please consult their documentation.

Collecting authorization

There are two ways to collect a customer's wallet authorization: (1) via a “payment link” that can be embedded in a "pay with crypto" button or sent directly to a customer or (2) via our checkout modal that can overlay on your custom checkout page.

Creating customers and invoicing them

Once a customer has successfully signed up to the subscription, we will create that customer in Chargebee and create a “subscription” associating the customer and the product. If the customer already exists, we’ll create a new subscription for that customer.

When Chargebee creates the invoice, we will pull this invoice into Loop and then collect the payment on-chain.

When the transaction confirms on-chain, we will mark the payment as paid in Chargebee and provide the metadata from Loop (e.g. transaction hash). You can download your transaction history in CSV format from the Loop dashboard.

Chargebee will then create the next invoice, and the loop (pun intended 😄) will start again.

Verifying receipt

As mentioned above, all of the transaction metadata (i.e. transaction hash, invoice number, receiving wallet, etc.) is available via the Loop dashboard and can be downloaded via CSV.

In terms of accounting, if you’re using Chargebee for invoicing and tracking accounts receivables, you can track all your invoices in Chargebee as usual, regardless of if the customer is paying in fiat or crypto. Separately, you can monitor the inflow of crypto to your balance sheet, which can be handled using Loop’s transactions page alongside crypto accounting solutions, such as Integral or Entendre Finance.

Additional notes on features supported

Loop's integration with Chargebee does not currently support the following features:

  • Addons - recurring fees that can be added on top of a subscription plan.

  • Charges - non-recurring fees that can be added on top of a subscription plan one-time.

Last updated