Hacer un seguimiento del estado del pedido
Aviso
El SDK le permite realizar un seguimiento del estado del pedido en el lado cliente de su aplicación. Sin embargo, le recomendamos que establezca un controlador de webhook de Payments para recibir información del pedido en el back-end de su aplicación. Gracias a esto podrá implementar una validación adicional de las compras completadas.
- mostrar el estado del pedido en la interfaz de usuario de la aplicación
- abonar el importe en el saldo de un usuario tras un pago aceptado
- conceder los artículos comprados tras un pago aceptado
La lógica de seguimiento de pedidos se incluye en los siguientes métodos del SDK:
Cart.Purchase
- se usa para comprar una cestaCart.PurchaseFreeCart
- se usa para comprar artículos gratuitos a través de la cestaCatalog.Purchase
- se usa para comprar artículos con un solo clicCatalog.PurchaseForVirtualCurrency
- se usa para comprar artículos con moneda virtualCatalog.PurchaseFreeItem
- se usa para comprar artículos gratuitos con un solo clic
Documentación de referencia del SDK
Obtenga más información sobre los métodos del SDK y sus parámetros.
Para gestionar correctamente una compra, solo necesitas transmitir una función que sea llamada cuando el pedido pase al estado done
en el parámetro onSuccess
.
Los métodos de compra encapsulan varios métodos para el seguimiento del estado del pedido. El mecanismo varía en función de la plataforma para la que se haya compilado la aplicación:
- Para las compilaciones WebGL, el seguimiento se basa en los eventos
postMessage
del widget de interfaz de pago. Si el widget de Pay Station envía un mensaje indicando que el estado del pedido ha cambiado adone
ocancel
, se detiene el seguimiento.
- Para compilaciones para otras plataformas, el seguimiento utiliza peticiones HTTP simples (sondeo corto) y peticiones WebSocket. El seguimiento se realiza de acuerdo con el siguiente algoritmo:
- Se establece una conexión de socket web.
- Si el estado del pedido no cambia a
done
ocancel
en 5 minutos, se cierra la conexión de socket web. Si el estado del pedido cambia adone
ocancel
, el seguimiento se detiene. - El seguimiento del estado del pedido continúa con un sondeo corto. Una simple solicitud HTTP de estado del pedido se envía una vez cada 3 segundos. El seguimiento se detiene si:
- el estado del pedido cambia a
done
ocancel
- el estado del pedido no está
done
ocancel
en el plazo de 10 minutos
- el estado del pedido cambia a
Nota
Si falla una conexión de socket web, el seguimiento del estado del pedido se realiza mediante sondeo corto.
onSuccess
de los métodos de compra.¿Te ha resultado útil este artículo?
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.Enlaces útiles
Última actualización:
22 de Enero de 2024
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.