Bad Gateway (502)
Only the sandbox simulators return it, all seven of them under
/sandbox/simulate/: the simulated provider notice did not reach Roster's
webhook receiver in time. The detail reads
webhook edge unreachable — retry later. This is a failure on our side, not
a problem with your request.
A 502 does not prove that nothing happened: the notice can reach Roster after
the simulator stopped waiting for it.
What to do
-
Wait a moment, then read the state before you send the simulation again:
GET /v1/enrollments/{id}for a payroll or identity simulation, andGET /v1/financial_eventsfor a deposit, a returned transfer or an account closure. -
A deposit (
/sandbox/simulate/deposit): the simulated bank may already hold the credit. Retry later with the sameIdempotency-Keyand body: the retry resends the same notice and never credits twice. -
A payroll or identity simulation whose notice did arrive can refuse the
retry: once the enrollment moved on, or the identity outcome is recorded, the
retry answers
400naming what it found. Treat that as done. - If it keeps failing, contact support with the
request_id.