Connect Stripe to Cell Payments
Follow these steps to connect your Stripe account. Cell Payments 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 Cell Payments.
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 Cell Payments - Read Only.
Never share your secret key. Cell Payments 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. Cell Payments needs read access to monitor your payment data and write access to disputes for Cell Defender functionality.
| Resource | Permission | Purpose |
|---|---|---|
| Charges | Read | Monitor transaction volume and patterns |
| Disputes | Write | Submit dispute evidence via Cell Defender |
| 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.cell-payments.com/api/webhooks/stripe
This allows Stripe to send real-time event notifications to Cell Payments, 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 Cell Payments to verify that incoming webhooks are genuinely from Stripe.
Paste in Cell Payments
Log in to your Cell Payments account at app.cell-payments.com.
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. Cell Payments 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.