INVOICE_STRIPE_LINK_PERSIST_FAILED

500api_error

The Stripe draft could not be linked.

Cause

The stripe_invoice_id must be durable BEFORE the invoice becomes billable; otherwise a later resume cannot tell it apart from 'nothing happened' and could mint a second invoice.

How to fix it

Contact support. The orphan draft is visible in the Stripe dashboard, is not finalized, and charges nobody.

Example response

500 INVOICE_STRIPE_LINK_PERSIST_FAILED

JSON

{
  "error_code": "INVOICE_STRIPE_LINK_PERSIST_FAILED",
  "error_type": "api_error",
  "error_message": "The Stripe draft could not be linked.",
  "hint": "Contact support. The orphan draft is visible in the Stripe dashboard, is not finalized, and charges nobody.",
  "docs_url": "https://docs.billerapi.com/errors/INVOICE_STRIPE_LINK_PERSIST_FAILED",
  "request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}

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

Canonical docs URL: https://docs.billerapi.com/errors/INVOICE_STRIPE_LINK_PERSIST_FAILED

Was this page helpful?

INVOICE_STRIPE_LINK_PERSIST_FAILED

Cause

How to fix it

Example response

500 INVOICE_STRIPE_LINK_PERSIST_FAILED

Related