Skip to main content
Consulta activamente el estado más reciente del método de pago correspondiente al pedido y lo sincroniza con la plataforma. Esta solicitud puede acceder al servicio de pago y cambiar el estado del pedido; úsala solo cuando la devolución de llamada se retrase o se requiera confirmación inmediata.

​
Preparativos

​
Resumen de la API

Una respuesta exitosa devuelve el objeto Order completo actualizado. Utiliza state para determinar el resultado y finished_at como hora de finalización; el modelo actual no tiene el campo paid_at. Los valores de estado incluyen Pending, Paid, Finished, Expired, Failed y Refunded. La fecha límite de pago solo cambiará los pedidos que aún estén en Pending a Expired. Los pedidos Refunded que ya han sido reembolsados permanecen en estado reembolsado después de actualizarse o de recibir una devolución de llamada de pago retrasada.

​
Recomendaciones de reintento

  • Para los pagos normales, prioriza las devoluciones de llamada de la plataforma; realiza un refresh activo solo cuando el estado no se actualice durante mucho tiempo.
  • No realices sondeos frecuentes a intervalos fijos. Se recomienda retroceso exponencial y detenerse al alcanzar un estado terminal claro.
  • 401 indica que el token no es válido; 403 indica que no eres el propietario del pedido; 404 indica que el pedido no existe.
  • Cuando falle la consulta del servicio de pago, conserva el ID del pedido y el ID de trace, y vuelve a intentarlo más tarde; no crees pedidos duplicados como sustituto de la confirmación del estado.

​
APIs relacionadas