Frequently Asked Questions
Does OFAuth Sandbox call OnlyFans? No. Sandbox returns mock data and makes no OnlyFans calls, so there is no risk of triggering OnlyFans security checks. Can I use a local redirect URI in Sandbox? Yes. Sandbox and Test accept HTTPS URLs and the loopback addresseshttp://127.0.0.1:<port>/... and http://[::1]:<port>/.... http://localhost is rejected everywhere.
What happens when the Test quota runs out? Access calls return 429 quota_exhausted with recovery.action retry_after_reset. The Retry-After header gives the seconds until the daily UTC reset.
What do I need for Live? An active Developer plan, Live approval of your External Integration, HTTPS redirect URIs with domain hostnames, and an approved integration purpose.
Do linked account ids carry over between environments? No. The same OnlyFans account has different ids in Sandbox, Test, and Live, and a token from one environment cannot reach another.
How do I start in Sandbox?
- Create an External Integration in the dashboard.
- Copy the Sandbox client ID (
ofext_sandbox_...) and secret. - Register a redirect URI, for example
http://127.0.0.1:3000/oauth/ofauth/callback. - Follow the Quickstart for a first profile request, then use the normal authorization flow to test customer consent.
config.ts
JSON.stringify([clientId, appUserId]). Use that key for authorization, callbacks, and API calls. Each key holds one authorization. A Sandbox token cannot reach a Live account. See Store customer tokens.
Can I use Sandbox in CI?
Yes. Sandbox is meant for development, CI, and demos. Sample data is stable for each account, so assertions on Access responses stay stable between runs. Writes such as sending a chat message or renaming a Vault list are kept for 24 hours and show up in later reads; see Environments for the list and limits. Use a fresh Sandbox account when a test needs untouched sample data. Sandbox accounts always have Vault+ on, which lets you test Vault+ routes without enabling anything. Their settings are fixed:PATCH /v3/linked-accounts/{id}/settings returns 409 linked_account_settings_fixed.
You can also point a Sandbox webhook destination at your staging server and send test deliveries from the dashboard. Test deliveries carry "test": true.
What Sandbox cannot do is reproduce real account states. Mock data does not prove that you handle a real expired OnlyFans session. Use Test for that.
How do I validate against real accounts in Test?
Test uses real OnlyFans accounts, but only accounts the integration owner designated as test accounts in the dashboard. Members of your organization authorize with those accounts through the Test client (ofext_test_...).
Test adds a daily operation quota on top of the standard rate limits. Handle it like any other recoverable error:
How do I move to Live?
Live is for your customers. It requires:- An active Developer plan on your organization.
- Live approval of your External Integration, requested from the dashboard once your integration works in Test. The review covers your purpose statement, scopes, redirect URIs, and privacy policy.
- HTTPS redirect URIs with domain hostnames.
- An approved description of how your integration uses account data.
integration_not_approved. Without the plan, they fail with subscription_required.