Referencia · Pedidos

Estado de un pedido por hash de Pagopar

GET/orders/by-payment-hash/{hash}

Pagopar está retirado: este endpoint sigue respondiendo por los pedidos que tienen un hash de Pagopar. Un pedido pagado con tarjeta (Stripe) no tiene hash y se consulta con GET /orders/{token}.

Para la página de retorno de Pagopar, que solo recibe el hash. Si el pedido no figura pagado, Tiendy le consulta a Pagopar y aplica la misma confirmación que el webhook, de modo que un webhook perdido no deja impago un pedido pagado. La landing nunca decide el estado. No se le consulta a Pagopar por un pedido ya pagado o cancelado, y si la consulta falla o se supera el tope de consultas de la tienda se responde el estado guardado. El hash de un intento reemplazado por un nuevo POST /orders/{token}/pay deja de encontrarse. Sigue disponible si la tienda pierde el plan PRO.

Parámetros de ruta

hashtextorequerido

Respuestas

EstadoCódigoQué significa
200—

Pedido, sin publicToken.

401
  • API_KEY_INVALID

Clave ausente, inválida o revocada: API_KEY_INVALID.

403
  • STOREFRONT_API_PLAN_REQUIRED
  • ORIGIN_NOT_ALLOWED
  • SECRET_KEY_IN_BROWSER
  • STORE_INACTIVE
  • ALTCHA_REQUIRED
  • ALTCHA_INVALID
  • ALTCHA_EXPIRED
  • ALTCHA_REPLAY

STOREFRONT_API_PLAN_REQUIRED (la tienda no está en el plan PRO; no aplica a GET /orders/{token} ni a GET /orders/by-payment-hash/{hash}), ORIGIN_NOT_ALLOWED, SECRET_KEY_IN_BROWSER, STORE_INACTIVE (tienda pausada o archivada; solo catálogo, cotización y checkout), o en el checkout ALTCHA_REQUIRED, ALTCHA_INVALID, ALTCHA_EXPIRED, ALTCHA_REPLAY.

404
  • ORDER_NOT_FOUND
  • PRODUCT_NOT_FOUND
  • ALTCHA_NOT_CONFIGURED

No existe o es de otra tienda: la respuesta es la misma en ambos casos. Códigos: ORDER_NOT_FOUND, PRODUCT_NOT_FOUND, ALTCHA_NOT_CONFIGURED.

429
  • RATE_LIMITED

RATE_LIMITED. Respetar Retry-After. Sin datos para servir, también en una lectura de catálogo degradada.

500—

Error del servidor. En el checkout se puede reintentar con la misma Idempotency-Key.

503
  • SERVICE_UNAVAILABLE

SERVICE_UNAVAILABLE: no se pudo verificar la clave o el plan de la tienda, o Stripe no respondió al iniciar un pago. No dice nada de la clave ni del plan: reintentar después de Retry-After.