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:
- Log into your Stripe Dashboard
- Select Developers from the upper right menu

- Select Webhooks from the left menu and select Add a endpoint

- Enter the provided Endpoint URL based on the environment (listed at the bottom of this page).

- Select “Events on your account” and “Latest API version”
- Select the events
- charge.refunded, charge.succeeded, charge.updated
- customer.created, customer.deleted, customer.updated
- customer.subscription.created, customer.subscription.deleted, customer.subscription.updated
- invoice.paid - this is important since it is the main transaction event used to calculate rewards

- 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.
Endpoint URL | Environment |
---|---|
https://api.sandbox.cello.so/products/{your_productId}/transaction-webhook/stripe | Dev and Stage |
https://api.cello.so/products/{your_productId}/transaction-webhook/stripe | Prod |