Skip to content

Ironfang Finance API problem type

payment_required

Payment required. HTTP 402.

What it means

The free allowance is used up and paid usage needs a working payment method: none is set, or the last payment failed. Nothing was accepted or charged.

What to do

Update the payment method in Billing.

What the response carries

type
https://ironfang.com/problems/payment_required, this page.
status
Always 402 for this code.
code
payment_required. Stable: branch on this, not on the wording of title or detail.
detail
What happened this time, safe to show to a person. It never carries invoice content.
request_id
The same value as the X-Ironfang-Request-ID header. Quote it to support.
retry_after_seconds
Never present for this code.
outcome
Absent. This code is not a statement about any document.

Problems follow RFC 9457 and are served as application/problem+json. A validation finding is never a Problem: an invalid invoice is a successful response that lists its findings. See every problem type, the Finance guide and the OpenAPI contract.