Stripe Webhook

Cello makes it easy to connect securely to your Stripe payment provider to automate transaction events, attribution, and payouts. Transactions are monitored and used to payout referrers based on your campaign reward rules.

How does it work?

A notification event is securely sent to Cello through the webhook endpoint every time a customer makes a payment or a customer record is created or updated. Cello checks these events to perform the following actions:

  • Determine if a reward for referrer needs to be created and paid out
  • Inform the referrer on new signups and rewards
  • Cancel recurring rewards if a subscription is cancelled

If the automation of Cello detects unclear cases the automation will be paused and Cello will reach out to you to clarify the case.

Connecting Stripe

You will add a Webhook to your Stripe configuration to connect Stripe and Cello. This can be done in both test and production environments separately. To setup:

  1. Log into your Stripe Dashboard
  2. Select Developers from the upper right menu
  1. Select Webhooks from the left menu and select Add a endpoint
  1. Enter the provided Endpoint URL based on the environment (listed at the bottom of this page).
  1. Select “Events on your account” and “Latest API version”
  2. Select the events
    1. charge.refunded, charge.succeeded, charge.updated
    2. customer.created, customer.deleted, customer.updated
    3. customer.subscription.created, customer.subscription.deleted, customer.subscription.updated
    4. invoice.paid - this is important since it is the main transaction event used to calculate rewards
  1. Endpoint created 🎉

Securing the webhook connection

To secure the connection, you need to add the “Signing secret” to Cello. Click “Reveal” and be sure to add your Secret within the Webhooks section in the Cello portal.

Endpoint URLs

Use the Endpoint URL that corresponds with the environment. ProductId can be obtained in the Cello Portal.

Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard