Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt

Use this file to discover all available pages before exploring further.

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:
ReportWhat Stripe data it uses
Payment Performance IntelligenceAuth rates, decline reason codes, payment method mix, BIN-level patterns
Decline Recovery IntelligenceFailed charge amounts, retry eligibility, recoverable revenue estimate
Checkout Conversion FailureCheckout abandonment correlated with payment errors
Daily Revenue LeakageGross vs net revenue, refunds, disputes, fee deductions
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.