PAYMENT_REQUIRED
You have an outstanding payment. Settle it to keep operating in production
Category: Companies
| HTTP status | 402 Payment Required |
| Retry | After fixing the cause |
When it happens
The account's billing is unpaid: a charge failed and its payment retries are exhausted. A charge that failed but is still being retried does not answer this. Nothing was created or switched on, and no new checkout is opened.
How to fix it
Settle the outstanding invoice, then send the request again.
Retry
Not as is: the same request fails the same way. Fix the cause described above, then send the request again, under a new Idempotency-Key if the body changed.
Returned by
The operations where this code is most likely. The list is not exhaustive.
Example response
When this error occurs, the API answers 402 Payment Required with a JSON body of this shape:
{
"type": "https://docs.beel.es/errors/PAYMENT_REQUIRED",
"title": "PAYMENT_REQUIRED",
"detail": "You have an outstanding payment. Settle it to keep operating in production",
"instance": "/v1/<resource>",
"errors": [],
"success": false,
"error": {
"code": "PAYMENT_REQUIRED",
"message": "You have an outstanding payment. Settle it to keep operating in production",
"details": {}
},
"meta": {
"timestamp": "2026-05-21T10:00:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}The type URI is stable and always resolves to this page.
Message
Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.
Other errors in this category
ACCOUNT_HAS_NO_HOLDER
The target account has no registered holder yet, so a NIF cannot be created on its behalf
CANNOT_DELETE_PRIMARY
The account's primary company cannot be deleted.
CHECKOUT_REQUIRED
A payment method is required to create a production company
COMPANY_ACTIVE_IN_PRODUCTION
This company is active in Live and cannot be deleted. Deactivate it in Live first: the deactivation is scheduled, the current cycle is charged and served in full, and from its effective date you will be able to delete the company
COMPANY_HAS_INVOICES
This company has invoices in Live and cannot be deleted. Delete its drafts and proformas first; if it has already issued invoices, the way out is to deactivate it in Live, not to delete it
Keep exploring
PAYMENT_DETAILS_REQUIRE_METHOD
payment_iban, payment_swift and payment_term_days are only accepted together with a payment_method that is present, not null and not NONE. Send the method together with the details, or neither.
PAYMENT_RETURN_URL_INVALID
return_url must be an absolute https:// URL with a host (for example https://your-portal.com/return)