old_Loopcrypto.xyz
  • Introduction
  • Supported networks and tokens
  • Loop + Frames
  • Learn
    • How Loop works
    • Core components
      • Collecting authorization
        • Enabling payment on multiple networks
        • Accepting ETH and MATIC
      • Sending payment requests
      • Checking a customer's balance & allowance
      • Receipts and reminders
      • Customer portal
    • Loop + your financial stack
      • Linking on-chain transactions with invoices in your ERP system
      • Connecting with accounting software
      • Crypto off-ramp
    • Case studies
  • Dashboard functionality
    • Subscriptions
      • Free trials, discounts and more
      • Auto-invoicing
      • Auto-cancelations
    • One-time payments
    • Scheduling outbound payments
      • Internal notes
    • Editing an upcoming payment
    • Payments for platforms
  • Integrations
    • Stripe + Loop
      • Getting setup
      • Stripe Connect setup
      • Subscriptions
        • Free trials
        • Upgrading a customer or editing a subscription's products
      • Invoicing
      • One-time payments
      • Coupon codes
      • Stripe Connect - Subscriptions
      • FAQs about Stripe integration
    • Chargebee + Loop
      • Getting setup
      • Subscriptions
      • One-time payments
      • Coupon codes
    • Quickbooks + Loop
      • Invoicing
    • Xero + Loop
      • Invoicing
    • Ghost.org + Loop
    • Zapier + Loop
    • Manually add integrations
  • Technical Docs
    • APIs
      • Entity
        • Adding child entities
        • Adding user to child entity
        • Get child entities
      • Items
        • Adding items
          • Item types
          • Categories
        • Retrieving an item
        • Updating an item
        • Deactivating an item
      • Agreements
      • Transfer requests
        • Signing transfer requests
        • Loop CLI
        • Canceling transfer requests
        • Transfer request status
        • Handling unfulfilled transfer requests
        • Validations
      • Webhooks
        • Checking webhook signatures
        • Demo App
        • Slack, Airtable, Discord, Telegram
    • Archeticture
      • Smart contract
        • Deploying your smart contract
          • Modifying smart contract properties
      • Collecting authorization
        • Checkout page
          • Additional functionality
          • Add "pay with crypto" button
        • Checkout widget
          • NPM package readme
        • Checkout parameter examples
      • Providing on-chain payment based access
        • Subscription gated communities
    • Loop SDK
      • Verify Webhook
      • Transfers
      • Error Handling
      • Generating API keys
    • Sample guide: Collect a subscription or one-time payment
    • Integrating the Loop Protocol into your dApp
      • Payroll applications
      • Loan platforms (credit cards, BNPL)
    • Security
      • API Authentication
      • Securing with signatures
      • API Trust assumptions
      • Audits
  • FAQs
  • Company Dashboard
  • Loop Portal
Powered by GitBook
On this page
  1. Integrations
  2. Chargebee + Loop

Getting setup

PreviousChargebee + LoopNextSubscriptions

Last updated 11 months ago

Before getting started, you'll need an account with Loop. Reach out to your contact at Loop to help with this or email us at hello@loopcrypto.xyz. The setup process below should only take a few minutes.

Setup

Loop requires 2 pieces of information to configure a new Chargebee integration. Please follow the steps below to complete the integration setup. You can also check out the video below, which walks through the process as well.

Once you have the Chargebee integration set up, you can then use Loop's checkout page or checkout modal to collect payment.

1. Log into your Chargebee account. Send us the URL you see when you log into your account.

The URL contains your siteName, which Loop requires to generate a siteID for you. In the image shown above, the siteName would be loopcrypto-test.

2. Creation of an API key with "full access" and type "write key".

Within your Chargebee dashboard, go to Settings -> Configure Chargebee -> API keys and Webhooks -> + API Keys -> + Add API Key -> + Full-Access Key. Name the API key as you desire.

3. Send siteName (step 1) and API key (step 2) to Loop Crypto.

Send the siteName and API key to Loop Crypto. You can use FoxCrypt or another secure data sharing tool. Loop Crypto uses these two pieces of information to add Chargebee to your Loop account.

4. Receive siteID from Loop Crypto

The Loop team will send a Chargebee siteId back to you. This siteId is unique to your Chargebee instance that your are syncing with Loop.

5. Create webhook.

Now that you have the siteId from Loop. Head back to your Chargebee dashboard to create a webhook. Go to Settings.

Settings -> Configure Chargebee -> API keys and Webhooks -> + Webhooks -> + Add Webhook. Name the webhook "Loop Webhook" and add the URL with the format shown below.

API URL:

  • Production: https://api.loopcrypto.xyz/api/v1/chargebee/process-events?site={{siteId}}

  • Demo: https://demo.api.loopcrypto.xyz/api/v1/chargebee/process-events?site={{siteId}}

    • Note: Your {{siteId}} will be provided to you from Loop.

Under the dropdown for Events to Send, select the following events:

  • Invoice generated

  • Item price created

  • Item price updated

  • Item updated

Once you have entered the URL and selected the correct set of events, click Create to finishing creating the webhook.

The video below walks through the full process described above.