Errores - Onflay Docs

Las respuestas no exitosas usan un formato estable:

{
  "error": {
    "type": "invalid_request",
    "code": "price_not_found",
    "message": "No price exists with id price_xxxxx",
    "param": "lineItems[0].priceId",
    "requestId": "req_abc123"
  }
}

Tipos comunes

Tipo	HTTP	Significado
`authentication_error`	401, 403	Key inválida, faltante o sin permisos
`invalid_request`	400, 404, 422	Parámetros inválidos o recurso inexistente
`idempotency_error`	409	Reuso incompatible de una idempotency key
`rate_limit_error`	429	Demasiadas solicitudes
`api_error`	5xx	Error interno o temporal

Request ID

Incluye requestId cuando contactes soporte. Ayuda a rastrear la solicitud en logs.