Dinero error

What it means

The action succeeded, but the bookkeeping entry in Dinero did not.

Example detail messages returned with this error:

• Refund sent but the credit note failed: {detail} — raise it by hand, do NOT retry.

What to do

Do not retry the request. This status means the money side already completed and only the accounting record failed. Retrying would repeat the money movement — a second refund — while trying to fix a bookkeeping entry.

Raise the credit note by hand in Dinero, against the invoice named in the response. The refund itself is recorded against the invoice and is visible in the operator console; the ledger is the only thing out of step.

This is deliberately a 502 and not a 500: the failure is in an upstream system, and the distinction is what tells you the request was not atomic.

Response shape

All fremforge API errors are RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/dinero-error",
  "title": "Bad Gateway",
  "status": 502,
  "detail": "..."
}

Branch on type, not on title or detail - those are human-readable and may be reworded.