Connect Stripe to Cellix
Follow these steps to connect your Stripe account. Cellix uses read-only API access to monitor transactions and manage disputes on your behalf.
Estimated setup time: 5 minutes
Required Credentials
| Credential | Type | Where to Find |
|---|---|---|
| Restricted API Key | Required | Stripe Dashboard → Developers → API Keys |
| Webhook Signing Secret | Optional | Stripe Dashboard → Developers → Webhooks |
Log in to the Stripe Dashboard
Go to dashboard.stripe.com and log in with your Stripe credentials.
Make sure you are in the correct Stripe account (check the account switcher in the top-left corner). If you have multiple accounts, select the one you want to connect to Cellix.
Use your live mode dashboard (not test mode) if you want to monitor real transactions. Toggle the mode using the switch in the Stripe sidebar.
Create a Restricted API Key
Navigate to Developers → API Keys in the Stripe Dashboard sidebar.
Click the Create restricted key button. Give it a descriptive name like Cellix - Read Only.
Never share your secret key. Cellix recommends using a restricted key with minimal permissions rather than your account's secret key.
Set Key Permissions
Configure the restricted key with the following permissions. Cellix needs read access to monitor your payment data and write access to disputes for Cellix AI functionality.
| Resource | Permission | Purpose |
|---|---|---|
| Charges | Read | Monitor transaction volume and patterns |
| Disputes | Write | Submit dispute evidence via Cellix AI |
| PaymentIntents | Read | Track payment lifecycle and statuses |
| Refunds | Read | Monitor refund activity and trends |
| Balance | Read | Display balance and payout data |
| Events | Read | Real-time event synchronization |
Leave all other permissions as None. Click Create key when done.
Copy the API Key
After creating the restricted key, Stripe will display it once. Click the Copy button or the reveal icon to copy the key to your clipboard.
The key will start with rk_live_ for live mode or rk_test_ for test mode.
Stripe only shows the full key once. If you lose it, you will need to create a new restricted key.
Create a Webhook Endpoint
Navigate to Developers → Webhooks in the Stripe Dashboard.
Click Add endpoint and enter the following URL:
https://app.cellix.ai/api/webhooks/stripe
This allows Stripe to send real-time event notifications to Cellix, enabling instant transaction syncing and dispute alerts.
Select Webhook Events
Under Events to send, click Select events and choose the following:
charge.succeeded— New successful chargescharge.failed— Failed charge attemptscharge.refunded— Refund eventscharge.dispute.created— New disputes openedcharge.dispute.updated— Dispute status changescharge.dispute.closed— Dispute resolutionspayment_intent.succeeded— Payment completionspayment_intent.payment_failed— Payment failures
Click Add endpoint to save.
Copy the Webhook Signing Secret
After creating the endpoint, click on it to view its details. Under Signing secret, click Reveal to display the secret.
Copy the signing secret. It starts with whsec_.
The webhook signing secret is optional but strongly recommended. It allows Cellix to verify that incoming webhooks are genuinely from Stripe.
Paste in Cellix
Log in to your Cellix account at app.cellix.ai.
Navigate to Settings → Connections and select Stripe from the list of available processors.
Paste your credentials:
- Enter your Restricted API Key (
rk_live_...) - Enter your Webhook Signing Secret (
whsec_...) if you created one
Click Connect. Cellix will validate the key and begin syncing your Stripe data within minutes.
Initial data sync typically takes 2-5 minutes depending on your transaction volume. You will see your dashboard populate automatically once the sync completes.