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.
Se han configurado 2 opciones de recepción de webhooks en el lado de Xsolla cuando se compran y devuelven artículos: la información con los datos del pago y de la transacción, y la información sobre los artículos comprados pueden llegar por separado o combinarse en un solo webhook.
Más información sobre las opciones de recepción de webhooks
Recibir información en webhooks combinados:
Si se registró en Cuenta del editor después del 22 de enero de 2025, recibirá toda la información en los webhooks Successful payment for order (order_paid) y Order cancellation (order_canceled). En este caso, no es necesario procesar los webhooks Payment (payment) y Refund (refund).
Recibir información en webhooks por separado:
Si se registró en Cuenta del editor el 22 de enero de 2025 o antes, recibirá los siguientes webhooks:
- Payment (
payment) y Refund (refund) con información sobre los datos de pago y los detalles de la transacción. - Successful payment for order (
order_paid) y Order cancellation (order_canceled) con información sobre los artículos comprados.
Debe procesar todos los webhooks entrantes.
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 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.
- Payment, Successful payment for order; y User validation si recibe webhooks separados
- Successful payment for order; y User validation si recibe webhooks combinados
Establecer webhooks en Cuenta del editor
- Abra su proyecto en Cuenta del editor.
- Haga clic en Project settings del menú lateral y vaya a la pestaña Webhooks.
- En el campo Webhook server, 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. - 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.
- Haga clic en Enable 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,201o204en el caso de una respuesta correcta. - Código HTTP
400con 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
Configurar la información de los artículos en los webhooks
Puede configurar qué datos de los artículos se incluyen en los webhooks Pago del pedido realizado correctamente y Cancelación del pedido a través de la matriz de items.
Activar la inclusión de parámetros adicionales
Active la inclusión de parámetros adicionales que indiquen:
- si el artículo es gratuito (
is_free) - si el artículo es una bonificación (
is_bonus) - si el artículo forma parte de un lote (
is_bundle_content)
Para recibir estos parámetros, debe cambiar sus webhooks a la versión 2 mediante la llamada a la API Actualizar la información sobre la configuración de webhooks. En la versión 1 (predeterminada), estos parámetros no están disponibles.
Ejemplo de matriz de artículos con parámetros adicionales:
- json
1
2"items": [
3 {
4 "sku": "com.xsolla.item_new_1",
5 "type": "bundle",
6 "is_pre_order": false,
7 "is_free": false,
8 "is_bonus": false,
9 "Is_bundle_content": false,
10 "quantity": 1,
11 "amount": "1000",
12 "promotions": []
13 },
14 {
15 "sku": "com.xsolla.gold_1",
16 "type": "virtual_currency",
17 "is_pre_order": false,
18 "is_free": false,
19 "is_bonus": false,
20 "is_bundle_content": true,
21 "quantity": 1500,
22 "amount": "[null]",
23 "promotions": []
24 }
25 ],
Desactivar la inclusión del contenido del lote
Por defecto, los webhooks incluyen todos los artículos del lote como una lista de artículos individuales. Puede configurar el webhook para que solo incluya el lote en sí, sin detallar su contenido.
En este caso, los artículos incluidos en el lote no se incluyen en la matriz de items. En la matriz que se muestra arriba, el artículo con el SKU com.xsolla.gold_1, que forma parte del lote, está excluido.
Ejemplo de matriz de artículos cuando el contenido del lote está desactivado:
- json
1
2"items": [
3 {
4 "sku": "com.xsolla.item_new_1",
5 "type": "bundle",
6 "is_pre_order": false,
7 "is_free": false,
8 "is_bonus": false,
9 "Is_bundle_content": false,
10 "quantity": 1,
11 "amount": "1000",
12 "promotions": []
13 }
14 ],
Para desactivar la inclusión del contenido del lote, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.
Enlaces útiles
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.
