Transferir compras al usuario

Implemente la concesión de compras al usuario en su aplicación empleando la información recibida en los webhooks de Xsolla sobre los detalles de la transacción y los artículos adquiridos.

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.

Establecer webhooks en Cuenta del editor

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Configuración del proyecto del menú lateral y vaya a la pestaña Webhooks.
3. En el campo Servidor de webhooks, especifique la URL de su servidor donde desea recibir los webhooks en el formato https://example.com. También puede especificar la URL que encuentre en una herramienta para probar webhooks.
4. Por defecto, se genera una clave secreta para firmar los webhooks del proyecto. Si desea generar una nueva clave secreta, pulse en el icono de actualización.
5. Haga clic en Habilitar webhooks.

Probar los webhooks en Cuenta del editor

Si los webhooks están establecidos correctamente, se muestra un bloque de prueba de webhooks debajo del bloque de configuración de webhooks.

La sección de pruebas de la Cuenta del editor varía en función de la opción de recepción de webhooks.

En ausencia de valores reales, puede introducir valores arbitrarios.

También puede probar los webhooks al realizar compras en el modo Aislador de proceso (sandbox) o en el modo real. La prueba de Refund solo está disponible en modo real.

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.

Próximos pasos

1. Implementar la obtención de información de suscripción.
2. Establecer la autenticación de usuarios.

Enlaces útiles

Flujo de integración