Establecer seguimiento del estado del pedido

Para conceder artículos al usuario, debe asegurarse de que el pago haya sido aceptado.

Para hacer un seguimiento del estado de los pedidos creados y validarlos, deberá configurar el procesamiento de webhooks en el lado del servidor de su aplicación.

Para cambiar a la nueva opción con recepción de webhooks combinados, contacte con sus gestores del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.

Para que la tienda en el juego y el sistema de gestión de pagos funcionen a pleno rendimiento, es necesario implementar el procesamiento de los principales webhooks:

• Si recibe webhooks combinados
• Si recibe webhooks por separado

Nombre del webhook	Descripción
Validación del usuario > Validación del usuario (user_validation)	Se envían en distintas fases del proceso de pago para garantizar que el usuario esté registrado en el juego.
Servicios del juego > Webhooks combinados > Successful payment for order (order_paid)	Contiene datos de pago, detalles de la transacción e información sobre los artículos comprados. Emplee los datos del webhook para agregar artículos al usuario.
Servicios del juego > Webhooks combinados > Cancelación del pedido (order_canceled)	Contiene datos del pago cancelado, detalles de la transacción e información sobre los artículos comprados. Emplee los datos del webhook para eliminar los artículos comprados.

El siguiente esquema muestra el proceso de compra y devolución de artículos utilizando webhooks de la lista.

Nombre del webhook	Descripción
Validación del usuario > Validación del usuario (user_validation)	Se envían en distintas fases del proceso de pago para garantizar que el usuario esté registrado en el juego.
Pagos > Pago (payment)	Contiene datos de pago y detalles de la transacción.
Servicios del juego > Webhooks por separado > Successful payment for order (order_paid)	Contiene información sobre los artículos comprados y los detalles de la transacción. Emplee los datos del webhook para agregar artículos al usuario.
Pagos > Reembolso (refund)	Contiene datos de pago y detalles de la transacción.
Servicios del juego > Webhooks por separado > Cancelación del pedido (order_canceled)	Contiene información sobre los artículos comprados y el ID de la transacción cancelada. Emplee los datos del webhook para eliminar los artículos comprados.

El siguiente esquema muestra el proceso de compra y devolución de artículos utilizando webhooks combinados de la lista.

Si la personalización del catálogo de artículos está implementada en el lado de su aplicación, establezca el procesamiento de Personalización del catálogo en el lado del socio.

Para obtener la lista completa de webhooks e información general sobre cómo operar con ellos, consulte la documentación de webhooks.

SDK PHP

Emplee clases listas para procesar webhooks.

Establecer el envío de webhooks

Para configurar webhooks en el lado de Xsolla:

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Project settings en el menú lateral y vaya a la sección Webhooks.
3. En el campo Webhook URL, especifique la URL a la cual Xsolla enviará los webhooks.

4. Haga clic en Enable webhooks.

Agregar un agente de escucha de webhooks

El agente de escucha de webhooks es un código de programa que permite recibir webhooks entrantes en una dirección URL especificada, generar una firma, y enviar una respuesta al servidor de webhooks de Xsolla.

Generación de firma

Cuando reciba un webhook, se debe garantizar la seguridad de la transmisión de datos. Para conseguirlo, se debe generar una firma a partir de los datos del webhook y verificar que coincide con la firma enviada en el encabezado de la solicitud HTTP.

Para generar una firma:

1. Concatene el JSON del cuerpo de la solicitud y la clave secreta del proyecto.
2. Aplique la función hash criptográfica SHA-1 a la cadena obtenida en el primer paso.

Enviar respuestas al webhook

Para confirmar la recepción del webhook, su servidor debe devolver:

• código HTTP 200, 201 o 204 en el caso de una respuesta correcta.
• Código HTTP 400 con descripción del problema si no se ha encontrado el usuario especificado o se ha transmitido una firma no válida.

Su controlador de webhook también puede devolver un código 5xx en caso de problemas temporales en su servidor.

Si el servidor de Xsolla no recibe una respuesta para los webhooks Successful payment for order y Order cancellation o si recibe una respuesta con un código 5xx, los webhooks se reenvían con arreglo al siguiente esquema temporal:

• 2 intentos con un intervalo de 5 minutos
• 7 intentos con un intervalo de 15 minutos y
• 10 intentos con un intervalo de 60 minutos

Se realizan un máximo de 20 intentos de envío de webhooks en un plazo de 12 horas desde el primer intento.

Si el servidor de Xsolla no recibe una respuesta para los webhooks Pago o Reembolso o si recibe una respuesta con un código 5xx, los webhooks también se reenvían con un intervalo mayor. Se realiza un máximo de 12 intentos en 12 horas.

Si el servidor de Xsolla no recibe una respuesta para los webhooks Validación del usuario o si recibe una respuesta con un código 400 o 5xx, el webhook Validación del usuario no se reenvía.

En este caso, se muestra un error al usuario y no se envían los webhooks Payment y Successful payment of the order.