Skip to main content
Connecting Stripe gives Vortex IQ access to your payment transaction data. Vortex Mind uses this to power Payment Performance Intelligence and Decline Recovery Intelligence reports-diagnosing auth rate drops, BIN-level decline patterns, gateway error codes, and recoverable revenue from failed transactions. Nerve Centre surfaces the resulting KPI cards, and Ask Viq can answer payment-specific questions in plain English.

​
What Vortex IQ reads from Stripe

Stripe feeds the following Vortex Mind report types directly: KPI cards populated in Nerve Centre include payment success rate, decline rate by payment method, dispute rate, refund rate, and revenue after fees.

​
How to connect

1

Go to Connected Sources

Navigate to Settings → Connected Sources and click Add Source.
2

Select Stripe

Search for “Stripe” and select it from the catalogue.
3

Enter your Stripe Restricted Key

Vortex IQ uses a Stripe Restricted API Key (not your secret key). In your Stripe Dashboard, go to Developers → API Keys → Create Restricted Key with read permissions on: Charges, Customers, PaymentIntents, Refunds, Disputes, and Balance Transactions.
4

Paste the key into Vortex IQ

Enter the restricted key in the connection form and click Save.
5

Verify

Vortex IQ runs a connection test. A green status indicator confirms the key is valid and data pull has started.
Never paste your Stripe Secret Key into Vortex IQ. Use a Restricted Key scoped to read-only access on the resources listed above.

​
Troubleshooting

Verify the restricted key has read access on Charges and PaymentIntents. Missing permissions on either resource cause the connection test to fail.
Stripe data is pulled on a daily refresh by default. If you just connected, wait until the following day’s refresh cycle or click Refresh Now in Settings → Data Refresh.
Decline reason codes require the Charges read permission. Confirm the restricted key includes this scope.