NewThe SII in Live, under contract
BeeL
Get startedMulti-NIFVeriFactuSIIRulesStripeAPI referenceChangelog
ErrorsAll codes

PAYMENT_REQUIRED

You have an outstanding payment. Settle it to keep operating in production


Category: Companies

HTTP status402 Payment Required
RetryAfter 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

You have an outstanding payment. Settle it to keep operating in production
Tienes un pago pendiente. Regulariza el pago para seguir operando en producción
Tens un pagament pendent. Regularitza'l per seguir operant en producció

Send the request with Accept-Language: <es|en|ca> to receive the message in your preferred language.

Other errors in this category

Keep exploring