Settings: Payment Providers
The Payment Providers tab is where you connect Stripe. It shows one Stripe card with an environment switch, a key field, and three buttons, plus a second card for a provider SSA does not support yet.
Where to find it
Go to Settings → Payment Providers, at admin.php?page=sad-subscription-analytics-settings&tab=providers. The card grid shows Stripe and, beneath it, a Coming Soon card for PayPal.
Stripe fields
| Field | What it does | Default |
|---|---|---|
| Environment | A Test / Live switch that decides which kind of key SSA expects and which Stripe Dashboard (test or live) the plugin links to. On screen: "Use Test to verify with sandbox data before going live." A key whose prefix does not match the selected environment is refused: SSA clears the credentials and reports a mismatch rather than saving a key against the wrong mode. | Test. |
| Secret API Key | Your Stripe secret key or restricted key, entered with a show/hide eye toggle. Once connected the field is replaced by a masked value and a Change key link, and the real key never travels back to the browser. On screen: "Find your keys in the Stripe Dashboard. Only the Secret Key is required." Must be sk_test_, sk_live_, rk_test_ or rk_live_ followed by at least 20 alphanumeric characters, and must match the selected Environment. | Empty. |
If you type a key while a restricted-key prefix contradicts the Environment switch, an inline alert reads: This key does not match the selected environment. Check your key or switch environments.
Test Connection, Connect and Disconnect
Test Connection checks a key without saving it. With the field empty it re-tests whatever key is already stored, so you can confirm a saved key still works. Behind the scenes it lists one record each of Customers, Subscriptions, Charges, Invoices and Products and prices (read); a restricted key missing any of those permissions gets a message naming exactly which ones to grant.
Connect runs the same checks, then encrypts the key and mode (AES-256-GCM) and stores them. It does not start a sync by itself; the status badge switches to Connected (Test) or Connected (Live) and Sync now becomes available on the Data Sync tab.
Disconnect asks you to confirm inline ("Are you sure you want to disconnect this provider? Your synced data will be retained.") before it clears the stored credentials.
What saving does
The sticky Save changes bar at the bottom of the Settings page is visible on this tab too, but it never touches Payment Providers: Test Connection, Connect and Disconnect each act immediately over their own request the moment you press them, whether or not you ever press Save changes.
PayPal and requesting a provider
A second card marked Coming Soon shows PayPal with no controls: PayPal support is planned for a future release. No action required. This provider will appear fully configurable here once available. Below the cards, a callout reads Need a provider not listed here? Let us know which platform you use. with a Submit a request link.