> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cello.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Connect Cello to your payment gateway, CRM, and other systems

Cello provides flexible integration options to connect with any payment provider, CRM, or custom system. Choose the approach that best fits your architecture.

## Integration Methods

### Pre-built Webhooks

Ready-to-use webhook integrations for popular payment providers. These provide the fastest path to track referral conversions automatically.

<CardGroup cols={2}>
  <Card
    title="Stripe Webhook"
    icon={<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
<g clipPath="url(https://mintlify.s3.us-west-1.amazonaws.com/cello/integrations#clip0_19722_44991)">
<path d="M18 36C27.9411 36 36 27.9411 36 18C36 8.05888 27.9411 0 18 0C8.05888 0 0 8.05888 0 18C0 27.9411 8.05888 36 18 36Z" fill="#635BFF"/>
<path fillRule="evenodd" clipRule="evenodd" d="M16.596 13.995C16.596 13.149 17.289 12.816 18.441 12.816C20.097 12.816 22.185 13.32 23.841 14.211V9.09898C22.032 8.37898 20.25 8.09998 18.45 8.09998C14.031 8.09998 11.097 10.404 11.097 14.256C11.097 20.259 19.368 19.305 19.368 21.897C19.368 22.896 18.495 23.22 17.28 23.22C15.471 23.22 13.167 22.482 11.34 21.483V26.658C13.365 27.531 15.408 27.9 17.28 27.9C21.807 27.9 24.921 25.659 24.921 21.762C24.885 15.282 16.596 16.434 16.596 13.995Z" fill="white"/>
</g>
<defs>
<clipPath id="clip0_19722_44991">
<rect width="36" height="36" fill="white"/>
</clipPath>
</defs>
</svg>}
    href="/integrations/webhooks/stripe-webhook"
  >
    Automatically track Stripe payments
  </Card>

  <Card
    title="Chargebee Webhook"
    icon={<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M12.1464 18.0024L35.9265 12.3313V0H23.5953L12.1464 18.0024Z" fill="#FF3300"/>
<path d="M0.36 17.7853C0.36 19.2605 0.539827 20.6924 0.879691 22.0664L12.1451 18.0017L0.786251 13.9024C0.509734 15.1512 0.36 16.4499 0.36 17.7819V17.7853Z" fill="#FF3300"/>
<path d="M4.54902 6.32317L12.1436 18.0031L15.6415 0.177188C11.2091 0.799913 7.3026 3.05771 4.54902 6.32317V6.32317Z" fill="#FF3300"/>
<path d="M12.1464 18.0008L35.9265 23.6686V35.9998H23.5953L12.1464 18.0008Z" fill="#FF3300"/>
<path d="M4.54902 29.6798L12.1436 17.9978L15.6415 35.8204C11.2091 35.1977 7.3026 32.9399 4.54902 29.6744L4.54902 29.6798Z" fill="#FF3300"/>
</svg>}
    href="/integrations/webhooks/chargebee-webhook"
  >
    Track Chargebee subscriptions
  </Card>
</CardGroup>

### Cello REST API

Did not find an integration for your system? Send conversion events from any system using our REST API.

Perfect for connecting payment gateways (e.g. Paddle, Recurly, etc.), CRMs (e.g. Hubspot, Salesforce, etc.), or in-house built CRMs or billing systems.

<CardGroup cols={2}>
  <Card title="Setup Overview" icon="rocket" href="/integration-overview">
    Follow 4 easy steps to get your referral program up and running with Cello using any CRM or payment gateway
  </Card>

  <Card title="Cello API" icon="code" href="/api-reference/introduction">
    Send conversion events, validate referral codes, and manage referral links programmatically
  </Card>
</CardGroup>

### Debugging & Monitoring

Once your integration is set up, use **Integration Status** for a high-level health view of your integration, and the **Event Feed** to drill into individual events when you need to troubleshoot validation issues.

<CardGroup cols={2}>
  <Card title="Integration Status Guide" icon="heart-pulse" href="/guides/support/portal/integration-status">
    Get an at-a-glance health view across the four core integration components
  </Card>

  <Card title="Event Feed Guide" icon="list-check" href="/guides/support/portal/event-feed">
    Inspect every incoming event with per-field validation
  </Card>
</CardGroup>

## Next steps

Choose your integration based on your setup:

<AccordionGroup>
  <Accordion title="I use Stripe or Chargebee and customer is created in payment gateway at signup">
    Follow one of our quickstart guides for **pre-built webhook integrations** for the fastest setup.

    <CardGroup cols={2}>
      <Card title="Stripe Webhook Quickstart" icon="book-open" horizontal href="/attribution/use-cases/stripe" />

      <Card title="Chargebee Webhook Quickstart" icon="book-open" horizontal href="/attribution/use-cases/chargebee" />
    </CardGroup>
  </Accordion>

  <Accordion title="I use Stripe or Chargebee and customer is created in payment gateway at purchase">
    Use the **Cello API** to send signup events and **Stripe or Chargebee webhook** to send purchase events from your payment provider.

    <CardGroup cols={3}>
      <Card title="Cello API" icon="code" href="/api-reference/introduction">
        Send signup events
      </Card>

      <Card
        title="Stripe Webhook"
        icon={<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
<g clipPath="url(https://mintlify.s3.us-west-1.amazonaws.com/cello/integrations#clip0_19722_44991)">
<path d="M18 36C27.9411 36 36 27.9411 36 18C36 8.05888 27.9411 0 18 0C8.05888 0 0 8.05888 0 18C0 27.9411 8.05888 36 18 36Z" fill="#635BFF"/>
<path fillRule="evenodd" clipRule="evenodd" d="M16.596 13.995C16.596 13.149 17.289 12.816 18.441 12.816C20.097 12.816 22.185 13.32 23.841 14.211V9.09898C22.032 8.37898 20.25 8.09998 18.45 8.09998C14.031 8.09998 11.097 10.404 11.097 14.256C11.097 20.259 19.368 19.305 19.368 21.897C19.368 22.896 18.495 23.22 17.28 23.22C15.471 23.22 13.167 22.482 11.34 21.483V26.658C13.365 27.531 15.408 27.9 17.28 27.9C21.807 27.9 24.921 25.659 24.921 21.762C24.885 15.282 16.596 16.434 16.596 13.995Z" fill="white"/>
</g>
<defs>
<clipPath id="clip0_19722_44991">
<rect width="36" height="36" fill="white"/>
</clipPath>
</defs>
</svg>}
        href="/integrations/webhooks/stripe-webhook"
      >
        Automatically track Stripe payments
      </Card>

      <Card
        title="Chargebee Webhook"
        icon={<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M12.1464 18.0024L35.9265 12.3313V0H23.5953L12.1464 18.0024Z" fill="#FF3300"/>
<path d="M0.36 17.7853C0.36 19.2605 0.539827 20.6924 0.879691 22.0664L12.1451 18.0017L0.786251 13.9024C0.509734 15.1512 0.36 16.4499 0.36 17.7819V17.7853Z" fill="#FF3300"/>
<path d="M4.54902 6.32317L12.1436 18.0031L15.6415 0.177188C11.2091 0.799913 7.3026 3.05771 4.54902 6.32317V6.32317Z" fill="#FF3300"/>
<path d="M12.1464 18.0008L35.9265 23.6686V35.9998H23.5953L12.1464 18.0008Z" fill="#FF3300"/>
<path d="M4.54902 29.6798L12.1436 17.9978L15.6415 35.8204C11.2091 35.1977 7.3026 32.9399 4.54902 29.6744L4.54902 29.6798Z" fill="#FF3300"/>
</svg>}
        href="/integrations/webhooks/chargebee-webhook"
      >
        Track Chargebee subscriptions
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="I have a different payment gateway (not Stripe nor Chargebee)">
    **Cello API** gives you full control over when and how to track conversions. Send events from your backend whenever a signup or purchase occurs.

    <CardGroup cols={2}>
      <Card title="Setup Overview" icon="rocket" href="/integration-overview">
        Follow 4 easy steps to get your referral program up and running with Cello using any CRM or payment gateway
      </Card>

      <Card title="Cello API" icon="code" href="/api-reference/introduction">
        Send conversion events, validate referral codes, and manage referral links programmatically
      </Card>
    </CardGroup>
  </Accordion>
</AccordionGroup>

<Note>
  All integration methods support both sandbox and production environments, allowing you to test thoroughly before going live.
</Note>