Common · shared

Internal Error 500

An unexpected error occurred on the Swepay side.

type https://errors.swepay.com.br/common/internal-error

What this means

Something went wrong inside the service while processing an otherwise valid request. This is never the integrator's fault. Every occurrence carries a referenceId extension member that correlates the failure to our internal logs.

No sensitive detail about the failure is exposed in the response body by design.

Common causes

A transient fault in a downstream dependency.
An unhandled condition in the service.
A temporary outage or deploy in progress.

How to resolve

Retry the request with exponential backoff and jitter — most 500s are transient. If the error persists, contact Swepay support and quote the referenceId from the response so we can trace the exact request. Do not treat the operation as either succeeded or failed until you have a definitive follow-up response.

Example response

HTTP 500 · application/problem+json

{
  "type": "https://errors.swepay.com.br/common/internal-error",
  "title": "Internal Error",
  "status": 500,
  "detail": "An unexpected error occurred. Quote the reference ID when contacting support.",
  "instance": "/v1/certificates",
  "referenceId": "ref_3f9c2a7b"
}

References

Machine-readable: /common/internal-error.json