Billing
Stripe
Read Stripe customers, subscriptions, and invoice events so revenue posture lives next to customer records in Atlas.
What this connector does
- Read Stripe customer, subscription, invoice, and charge metadata.
- Reflect payment status and billing health in Atlas account records.
- Listen for signed event notifications to update account health in near real time.
- Keep only the billing details Atlas needs, never full card numbers or raw payment details.
Before you begin
- You are an owner or administrator of your Atlas workspace.
- You can sign in to your Stripe account and approve access for Atlas.
- Atlas looks after the Stripe app on its side, so there is nothing for you to create or copy.
How to connect
Open Stripe in Integrations
In Atlas, open Integrations and select Stripe.
Press Connect
Atlas sends you to Stripe to sign in. Sign in with the account you want to connect.
Approve access
Review the permissions that Stripe lists and approve them. Atlas returns you to the connector page, which then shows the connection.
Check the connection
Select Test connection on the connector page. A passing result means Atlas can read from Stripe.
Permissions Atlas asks for
read_writeSetup checklist
- Confirm you are an owner or administrator of your Atlas workspace.
- Open Integrations and select the connector.
- Press Connect and sign in to Stripe.
- Review the permissions that Stripe lists and approve them.
- Select Test connection and read the result.
Troubleshooting
StripeAuthenticationError
The restricted key was revoked or rotated. Generate a new key and update Atlas.
Event delivery failed
Check Atlas health page for the connector and confirm the receiver returns a 2xx within 5 seconds.
Connect says Stripe is not available yet
Atlas has not enabled Stripe for this deployment, so there is nothing for you to configure. Check again later.
The sign-in was cancelled
If you close the Stripe screen or choose Cancel, Atlas does not connect. Press Connect again and approve the access.
Atlas asks you to reconnect
Stripe can end a connection when access is revoked or a password changes. Press Reconnect on the connector page and approve the access again.
Event notifications
Atlas checks every event against the signing secret for that notification address.
Events Atlas listens for
- customer.subscription.created
- customer.subscription.updated
- invoice.payment_succeeded
- invoice.payment_failed
- charge.failed
Provider docs: https://stripe.com/docs/webhooks
Disconnect and data deletion
- Click Disconnect on the Atlas Stripe connector page.
- Roll the restricted key in Stripe Developers, API keys.
- Delete the Atlas event notification address in Developers, Webhooks.
When you are ready, open the live connector page and press Connect to finish connecting Stripe.
Open the Stripe connector page