Search documentation
Fuzzy search across every docs page and section
Getting startedEnvironments and sandbox
Fuzzy search across every docs page and section
Getting startedEnvironments and sandbox
Getting started
Test vs live environments, sandbox test credentials (user_good, user_mfa, user_locked, MFA 1234), deterministic data, and sandbox-only helpers.
FeelConnect has two data planes. Test is a complete simulation — institutions, auth flows, and 24 months of realistic data — available on every plan. Live talks to real connectors and requires the Startup plan or above.
| Test | Live | |
|---|---|---|
| Key prefix | fc_sk_test_ | fc_sk_live_ |
| Institutions | 76 sandbox institutions | Real coverage via enabled connectors |
| Data | Deterministic, 24 months per item | Real account data |
| Cost | Free on all plans | Startup plan and above |
| Sandbox helpers | Available | Rejected |
Inside Link, any sandbox institution accepts these credentials:
| Username | Password | Result |
|---|---|---|
user_good | pass_good | Connects immediately. |
user_mfa | pass_good | Prompts for an MFA code — enter 1234. |
user_locked | any | Fails with an item error (ITEM.ERROR) — use it to test failure UI. |
Every sandbox item is seeded by its item_id, so the data is random-looking but stable across calls — ideal for tests and demos. Each item gets:
/transactions/sync always has something new eventually.Two endpoints exist only in the test environment to script hard-to-reach states:
/v1/sandbox/fire_webhookFires any webhook event type at your registered endpoints for the item.
curl https://api.feelconnect.dev/v1/sandbox/fire_webhook \-H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \-H "Content-Type: application/json" \-d '{"access_token":"fc_at_…","type":"transactions.sync_updates_available"}'
{"fired": true}
/v1/sandbox/item/reset_loginForces the item into login_required, emitting an item.error webhook — exactly what happens when a real institution invalidates credentials. Use it to test update mode.
curl https://api.feelconnect.dev/v1/sandbox/item/reset_login \-H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \-H "Content-Type: application/json" \-d '{"access_token":"fc_at_…"}'
{"reset": true}