PAYMENT_REQUIRED
You have an outstanding payment. Settle it to keep operating in production
Category: Companies
| HTTP status | 402 Payment Required |
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)