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.

EstadocodeQué significa
400INVALID_QUERYUn parámetro de una lectura está fuera de rango o mal formado.
400INVALID_BODYEl cuerpo no es JSON o no respeta los tipos y formatos del contrato.
400IDEMPOTENCY_KEY_REQUIREDFalta el encabezado o está mal formado.
400PAYMENT_METHOD_UNAVAILABLELa tienda no ofrece ese medio de pago, o la combinación enviada no existe.
400STRIPE_NOT_AVAILABLELa tienda no tiene el pago con tarjeta (Stripe) disponible.
400STRIPE_CURRENCY_NOT_SUPPORTEDEl pago con tarjeta solo existe para tiendas en guaraníes.
400STRIPE_AMOUNT_NOT_ALLOWEDEl total supera el máximo por venta de stripe.maxTotal.
400STRIPE_REJECTEDStripe no aceptó iniciar el pago.
400RETURN_URL_INVALIDreturnUrl falta o no es una URL https de un origen autorizado. Ver el paso 4.
400FILE_INVALIDSin archivo, tipo no permitido o contenido que no coincide.
400SHIPPING_METHOD_INACTIVEEl método se desactivó: se quita la selección.
400SHIPPING_METHOD_REQUIREDLa tienda exige método de envío.
400PAGOPAR_NOT_ACTIVE, PAGOPAR_REJECTEDPagopar está retirado: el primero es lo que responde hoy todo intento de usarlo (paso 7).
401API_KEY_INVALIDClave ausente, inválida o revocada.
403STOREFRONT_API_PLAN_REQUIREDLa tienda no está en el plan PRO. No aplica a las consultas de pedidos existentes.
403ORIGIN_NOT_ALLOWED, SECRET_KEY_IN_BROWSERClave usada desde donde no corresponde.
403STORE_INACTIVETienda pausada o archivada.
403ALTCHA_REQUIRED, ALTCHA_INVALID, ALTCHA_EXPIRED, ALTCHA_REPLAYVer ALTCHA.
404ORDER_NOT_FOUND, PRODUCT_NOT_FOUND, ALTCHA_NOT_CONFIGUREDNo existe. Lo de otra tienda responde igual.
409INSUFFICIENT_STOCKVer Stock.
409IDEMPOTENCY_KEY_REUSED, IDEMPOTENCY_IN_PROGRESSOtro cuerpo con la misma clave, o el intento concurrente no terminó a tiempo.
409ORDER_NOT_PAYABLE, ORDER_CHANGEDEl pedido no admite otro pago, o cambió durante el inicio (reintentar).
409PROOF_NOT_ALLOWED, PROOF_ORDER_CANCELLED, PROOF_ALREADY_UPLOADEDVer Comprobante.
413FILE_TOO_LARGEMás de 10 MB, o sin Content-Length.
422SHIPPING_NOT_AVAILABLE_FOR_CITYEl método no cubre esa ciudad: ofrecer otro.
422BUNDLE_COUPON_CONFLICTLa oferta aplicada no combina con el cupón.
422PROOF_INVALIDLa clave no es de un comprobante de esta tienda.
429RATE_LIMITEDRespetar Retry-After.
503SERVICE_UNAVAILABLENo 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.