INVOICE_LEDGER_DIVERGED

Cause

Stripe finalized the invoice and the write that records ISSUED plus the Stripe URLs failed. Both ids are named in the message so the money-side reality is recoverable.

How to fix it

Escalate to support immediately with the request_id. A blind retry is safe (the finalized invoice is replayed, not re-created) but the divergence still needs a human.

Example response

{
  "error_code": "INVOICE_LEDGER_DIVERGED",
  "error_type": "api_error",
  "error_message": "The invoice is billed but not recorded.",
  "hint": "Escalate to support immediately with the request_id. A blind retry is safe (the finalized invoice is replayed, not re-created) but the divergence still needs a human.",
  "docs_url": "https://docs.billerapi.com/errors/INVOICE_LEDGER_DIVERGED",
  "request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}

Related

• Error handling — the error envelope shape and how to parse it
• Error code reference — every stable error code