Skip to main content
Stripe connections are managed from the Accounts page in the Finta dashboard. The connection shows your Stripe account name and the last sync time. To add a Stripe account, follow Connect Stripe.

​
Connection status

Stripe sends Finta webhooks for supported customer, product, price, subscription, invoice, and balance events. Customer, product, price, subscription, and invoice records update automatically after Stripe sends the corresponding event. Charge transactions refresh after Stripe reports an available-balance update, which may occur later than the charge itself. See How Finta syncs your data for details. If your API key is revoked, rotated, or loses permissions, syncs start failing. Fix it by updating the key.

​
Updating your API key

  1. Go to the Accounts page in the Finta dashboard
  2. Click the three-dot menu (⋮) on your Stripe connection
  3. Select Update API Key
  4. In the Stripe Dashboard, create a new restricted key with the permissions listed below
  5. Copy the new key (it starts with rk_live_) and paste it into the dialog
  6. Click Update Key
Syncing picks back up once the new key is validated.

​
Required permissions

Use a restricted key (rk_live_...), not a secret key (sk_live_...). Finta only needs the permissions listed above.

​
Other actions

Click the three-dot menu (⋮) on any connection card to access these options:

​
View syncs

See a history of all syncs for this connection, including timestamps and whether they succeeded or failed. Useful for troubleshooting if data seems out of date.

​
Set sync start date

Control how far back Finta pulls historical data. If you only need recent data, set a more recent start date to keep your destination focused.

​
Remove connection

Permanently disconnect Stripe from Finta. This removes the connection and all associated data.
Removing a connection is permanent. You’ll need to create a new restricted key and go through the setup process again if you want to reconnect.

​
Troubleshooting

“Stripe didn’t recognize this restricted key”: Make sure you copied the full key. Restricted keys start with rk_live_. Rotating a key creates a replacement immediately. During Stripe’s grace period, both keys can work for up to 7 days; the old key stops working when you expire it. “Give Webhook Endpoints Write access, then try again”: Double-check your restricted key in the Stripe Dashboard. Finta names the missing resource in the form. Webhook Endpoints needs Write access so Finta can receive supported updates. Syncs failing after key rotation: The old key Finta was using is gone. Use Update API Key from the three-dot menu to add the new one.

​
Next steps

Bank Connections Overview

See all supported providers

Create a Destination

Set up where your data syncs to