Failed requests
When the system turns a request down, the error message shows a reference, such as Ref 3B81C04E. The system also keeps a short record of that failure. Support uses the reference to find the record and see what went wrong.
This screen decides whether those records are kept, and for how long.
What a record holds
Each record answers who, when and what, and nothing more.
| Field | Example |
|---|---|
| When | 25 Sep 2026, 10:14 |
| Who | Alex, alex@woodgrovebank.example |
| Which operation | Send an SMS |
| Outcome | Rejected (400), refused (401, 403, 409) or failed (5xx) |
| Message shown | “To number must be 10 characters” |
| Reference | 3B81C04E… |
A record never holds what was sent. No amounts, names or account numbers from the request are kept. A successful request leaves no record.
Change the settings
- Go to Settings, then Platform, then Failed Requests.
- Turn Record failed requests on or off.
- Enter how many days to keep records in Keep records for (days).
- Select Save.
The number of days must be between 1 and 3650.
How old records are removed
If records are kept for 30 days, a record from 31 days ago is deleted and a record from yesterday stays.
The deletion runs once a day as the failed-request-retention job. It runs only once someone schedules it on the Scheduled jobs page under System. Until then, records are kept.
When recording is off
If you turn recording off, new failures leave no record. The error message still shows its reference, but support finds nothing when they look it up. Records already kept stay until the daily job removes them.
The reference
The reference follows the W3C Trace Context standard. It is the same id that follows the request through the rest of the system. Every error answer carries it in the field RFC 9457 names for it, beside the platform’s own error code and message. The platform complies with W3C Trace Context and partly complies with RFC 9457, as its standards register records.
What your organisation configures
- Whether failed requests are recorded. It is on unless your organisation turns it off.
- How long records are kept. It is 30 days unless your organisation changes it.
- When the daily deletion runs, on the Scheduled jobs page.
Everything else is built in: what a record holds, and that it never holds what was sent.
From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.