Guías · Operar
Errores
Los códigos estables por los que conviene ramificar.
JSON
{ "error": "Texto corto", "message": "Texto para el comprador", "code": "INSUFFICIENT_STOCK" }Se ramifica solo por code, y no por el texto. Los mensajes están en español y son aptos para mostrar; los que vienen del checkout de Tiendy pueden estar en voseo. No todo rechazo trae code todavía: datos del comprador, ciudad, cupón inválido, tope de cupón y líneas inválidas solo traen message, que se muestra tal cual.
| Estado | code | Qué significa |
|---|---|---|
| 400 | INVALID_QUERY | Un parámetro de una lectura está fuera de rango o mal formado. |
| 400 | INVALID_BODY | El cuerpo no es JSON o no respeta los tipos y formatos del contrato. |
| 400 | IDEMPOTENCY_KEY_REQUIRED | Falta el encabezado o está mal formado. |
| 400 | PAYMENT_METHOD_UNAVAILABLE | La tienda no ofrece ese medio de pago, o la combinación enviada no existe. |
| 400 | STRIPE_NOT_AVAILABLE | La tienda no tiene el pago con tarjeta (Stripe) disponible. |
| 400 | STRIPE_CURRENCY_NOT_SUPPORTED | El pago con tarjeta solo existe para tiendas en guaraníes. |
| 400 | STRIPE_AMOUNT_NOT_ALLOWED | El total supera el máximo por venta de stripe.maxTotal. |
| 400 | STRIPE_REJECTED | Stripe no aceptó iniciar el pago. |
| 400 | RETURN_URL_INVALID | returnUrl falta o no es una URL https de un origen autorizado. Ver el paso 4. |
| 400 | FILE_INVALID | Sin archivo, tipo no permitido o contenido que no coincide. |
| 400 | SHIPPING_METHOD_INACTIVE | El método se desactivó: se quita la selección. |
| 400 | SHIPPING_METHOD_REQUIRED | La tienda exige método de envío. |
| 400 | PAGOPAR_NOT_ACTIVE, PAGOPAR_REJECTED | Pagopar está retirado: el primero es lo que responde hoy todo intento de usarlo (paso 7). |
| 401 | API_KEY_INVALID | Clave ausente, inválida o revocada. |
| 403 | STOREFRONT_API_PLAN_REQUIRED | La tienda no está en el plan PRO. No aplica a las consultas de pedidos existentes. |
| 403 | ORIGIN_NOT_ALLOWED, SECRET_KEY_IN_BROWSER | Clave usada desde donde no corresponde. |
| 403 | STORE_INACTIVE | Tienda pausada o archivada. |
| 403 | ALTCHA_REQUIRED, ALTCHA_INVALID, ALTCHA_EXPIRED, ALTCHA_REPLAY | Ver ALTCHA. |
| 404 | ORDER_NOT_FOUND, PRODUCT_NOT_FOUND, ALTCHA_NOT_CONFIGURED | No existe. Lo de otra tienda responde igual. |
| 409 | INSUFFICIENT_STOCK | Ver Stock. |
| 409 | IDEMPOTENCY_KEY_REUSED, IDEMPOTENCY_IN_PROGRESS | Otro cuerpo con la misma clave, o el intento concurrente no terminó a tiempo. |
| 409 | ORDER_NOT_PAYABLE, ORDER_CHANGED | El pedido no admite otro pago, o cambió durante el inicio (reintentar). |
| 409 | PROOF_NOT_ALLOWED, PROOF_ORDER_CANCELLED, PROOF_ALREADY_UPLOADED | Ver Comprobante. |
| 413 | FILE_TOO_LARGE | Más de 10 MB, o sin Content-Length. |
| 422 | SHIPPING_NOT_AVAILABLE_FOR_CITY | El método no cubre esa ciudad: ofrecer otro. |
| 422 | BUNDLE_COUPON_CONFLICT | La oferta aplicada no combina con el cupón. |
| 422 | PROOF_INVALID | La clave no es de un comprobante de esta tienda. |
| 429 | RATE_LIMITED | Respetar Retry-After. |
| 503 | SERVICE_UNAVAILABLE | No se pudo verificar la clave o el plan, o Stripe no respondió al iniciar un pago. No significa que la clave sea inválida: reintentar después de Retry-After. |