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

  1. Go to Settings, then Platform, then Failed Requests.
  2. Turn Record failed requests on or off.
  3. Enter how many days to keep records in Keep records for (days).
  4. 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

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.