Skip to content

Ironfang Finance API problem type

payment_action_required

Payment action required. HTTP 402.

What it means

The free allowance is used up and a payment needs the account holder's confirmation before paid usage can continue. Nothing was accepted or charged.

What to do

Complete the payment in Billing.

What the response carries

type
https://ironfang.com/problems/payment_action_required, this page.
status
Always 402 for this code.
code
payment_action_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.