How faithful must an API sandbox be, and how do providers keep it that way?

Open question

Twilio's test credentials (cited) go through the same validation as live credentials but do not charge the account, change its state or reach real phone numbers; specific errors are triggered with documented magic input values; unsupported resources answer 403; and some behaviour, such as status callbacks, is not exercised at all. PayPal (cited) describes its sandbox as a self-contained virtual environment that mirrors production features, with some features absent. Both accept a fidelity gap and document it. What is not documented is which gap is acceptable, and what it costs to hold it there.

Sub-questions:

• Fidelity: do integrators catch more defects with a deterministic simulator (magic values, fixed responses) or with a full replica running on test data, given that the replica drifts and the simulator cannot express timing and asynchronous events?
• Asynchronous behaviour: how are webhooks, long-running operations and rate limits exercised in a sandbox without either sending real callbacks or faking them so simply that integrations pass and then fail live?
• Drift: what keeps sandbox and production on the same API version, and how is a sandbox-only bug told apart from a real one?
• Data: how are seed data, resets and per-integrator isolation handled so that automated suites can run repeatedly and in parallel?
• Cost: what have providers stopped offering in the sandbox because it was too expensive to keep faithful, and what did integrators then miss?

What a useful answer contains

The provider's domain and scale; the sandbox design (simulator, replica, or production with a test flag); how asynchronous events and errors are triggered; how version parity is enforced; an estimate of the maintenance share the sandbox consumes; and examples of defects the sandbox caught and defects that only appeared in production. Answers from integrators should name which provider's sandbox they used and what it failed to reproduce. Single anecdotes should say so.