FeelConnect▍
ProductsDocsPricingChangelog
Sign inGet API keys

Search documentation

Fuzzy search across every docs page and section

Getting started/Environments and sandbox

Getting started

  • Overview
  • Quickstart
  • Authentication
  • Environments and sandbox
  • Link
  • Going live

API reference

  • Link tokens
  • Institutions
  • Items
  • Accounts
  • Transactions
  • Identity
  • Income
  • Assets
  • Investments
  • Liabilities
  • Recurring
  • Categories
  • AI products

Platform

  • Webhooks
  • Errors
  • Rate limits and quotas
  • SDKs
  • GraphQL
  • MCP and AI agents
  • Changelog
  1. Docs
  2. Getting started
  3. Environments and sandbox
PreviousAuthenticationNextLink

On this page

  • Test credentials
  • Deterministic data engine
  • Sandbox helpers
FeelConnect▍

The developer-first financial data platform.

All systems operational

Products

Universal LinkData APIsAI enrichmentPricing

Developers

DocumentationAPI explorerDashboardGet API keys

Company

HomeChangelogfeels.moneySign in

Legal

PrivacyTermsSecurityData processing
© 2026 FeelConnect. All rights reserved./v1 · FC-Version 2026-07-01

Getting started

Environments and sandbox

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.

TestLive
Key prefixfc_sk_test_fc_sk_live_
Institutions76 sandbox institutionsReal coverage via enabled connectors
DataDeterministic, 24 months per itemReal account data
CostFree on all plansStartup plan and above
Sandbox helpersAvailableRejected

Test credentials

Inside Link, any sandbox institution accepts these credentials:

UsernamePasswordResult
user_goodpass_goodConnects immediately.
user_mfapass_goodPrompts for an MFA code — enter 1234.
user_lockedanyFails with an item error (ITEM.ERROR) — use it to test failure UI.

Non-credential flows

OAuth-style sandbox institutions show a simulated provider consent screen instead of a credential form — approve it to continue. Wallet-type institutions accept any well-formed address; manual accepts CSV/OFX/QFX uploads in both environments.

Deterministic data engine

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:

  • 24 months of transactions: biweekly payroll, rent or mortgage, subscriptions, groceries, dining, transport, and occasional travel bursts drawn from a ~90-merchant pool.
  • Balances consistent with those flows, plus a credit card with a limit and APR.
  • Investment holdings across 12 tickers with a deterministic price walk.
  • Liabilities (card APR, student loan, mortgage), identity records, and income streams.
  • Date-anchored generation — new transactions keep arriving as real time passes, so /transactions/sync always has something new eventually.

Sandbox helpers

Two endpoints exist only in the test environment to script hard-to-reach states:

POST/v1/sandbox/fire_webhook

Fires 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"}'
Response
{
"fired": true
}
POST/v1/sandbox/item/reset_login

Forces 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_…"}'
Response
{
"reset": true
}

Test environment only

Calling sandbox helpers with a live key returns invalid_request. There is no way to fire synthetic webhooks in the live environment.