Artículos gratuitos
Cómo funciona
Los artículos gratuitos son un tipo de artículo que el usuario pueden conseguir sin gastar moneda virtual o real. Entre ellos se incluyen:
- Artículos virtuales
- Lotes
- Paquetes de moneda virtual
Los artículos gratuitos solo están disponibles para usuarios autorizados. Los usuarios no autorizados solo pueden ver el catálogo de artículos gratuitos.
Ejemplos de uso:
- Puede regalar artículos gratuitos en fechas importantes para su proyecto (por ejemplo, el día de la fundación del proyecto) para recompensar a los usuarios por su fidelidad.
- Puede regalar paquetes de inicio para el juego en la tienda para atraer a nuevos usuarios al juego.
Puede limitar el obsequio de artículos únicos si el usuario ya los ha recibido.
¿Quién puede utilizarlo?
- Para los socios que ya disponen de In-Game Store y desean crear un nuevo tipo de producto: artículos gratuitos.
- Para los socios que desean fidelizar a los usuarios actuales o atraer a nuevos jugadores.
Flujo de integración
- Cree artículos gratuitos de las siguientes formas:
- Establecer Tienda.
- Obtener el estado del pedido de un usuario.
Crear mediante Cuenta del editor
Para crear un artículo gratuito (basado en el ejemplo de los artículos virtuales):- Abra su proyecto en Cuenta del editor.
- Haga clic en Store en el menú lateral.
- En el panel Virtual Items, haga clic en Configure.
- Haga clic en + y seleccione Crear artículo en la lista desplegable.
- Especifique:
- Imagen
- SKU
- Uno o varios grupos a los que debe pertenecer el artículo
- Nombre
- Descripción
- Propiedad del artículo: artículo consumible, no consumible o de duración limitada
- En el bloque Price settings, seleccione Free item.
- Si desea limitar la disponibilidad de artículos a usuarios específicos, cambie el conmutador Limit number of times one user can buy this item a On y especifique el número.
- Si desea mostrar un artículo en la tienda, cambie el conmutador Show item in store a On.
- Haga clic en Create item.
Crear mediante llamadas API
- Para crear artículos gratuitos, utilice las llamadas API de la subsección Admin:
- Para artículos virtuales — Create virtual item
- Para paquete de moneda — Create virtual currency package
- Para lotes — Create bundle
is_free = true
en el cuerpo de la solicitud. - Si desea limitar la disponibilidad de artículos a usuarios específicos, llame a cualquier método API para crear o modificar un artículo y especifique el valor del parámetro
limits.per_user
.
Establecer Tienda
Compra rápida
Si un usuario utiliza compra rápida (un usuario no usa una cesta), necesita llamar a la API Create order with specified free item para ofrecer la opción de recibir artículos gratuitos. La entrega de los artículos al inventario del usuario se produce inmediatamente después de una solicitud aceptada a este método (sin necesidad de abrir el formulario de pago de Pay Station). Xsolla envía un webhook con el texto Successful payment of the order informando de que el artículo ha sido entregado.Nota
El envío del webhook de Successful payment of the order se produce inmediatamente después de la entrega de los artículos gratuitos. En este caso, no se envía el webhook Pago.
Copy
- http
{
"method": "POST",
"url": "https://mybestgame.com/xsolla/notification",
"body": {
"items": [
{
"sku": "gift_direct_game_reward-supercoin",
"type": "virtual_currency",
"is_pre_order": false,
"quantity": 500,
"amount": "0",
"promotions": [
]
},
{
"sku": "package-500_supercoin",
"type": "bundle",
"is_pre_order": false,
"quantity": 1,
"amount": "0",
"promotions": [
]
},
{
"sku": "xsolla-giveaway_offer_11_14_22",
"type": "bundle",
"is_pre_order": false,
"quantity": 1,
"amount": "0",
"promotions": [
]
}
],
"notification_type": "order_paid",
"order": {
"id": 12345678,
"mode": "default",
"currency_type": "unknown",
"currency": null,
"amount": "0",
"status": "paid",
"platform": "xsolla",
"comment": null,
"invoice_id": null,
"promotions": [
]
},
"user": {
"external_id": "1234567812345678",
"email": null
}
},
"headers": {
"Authorization": "Signature 3b840ccefea111dcdfd111db1fdc6df969a3ec11",
"Accept": "application/json",
"Content-Type": "application/json"
},
"type": "webhook_payment",
"callback_parameters": {
"order_id": 12345678
}
}
Nota
Para los artículos gratuitos, el parámetro order.invoice_id se establece como
null
.- Si su agente de escucha aceptó y procesó correctamente el webhook: código de respuesta HTTP 200 o 204.
- Si ocurre el error esperado: código de respuesta HTTP 4xx.
- Su agente de escucha también puede devolver un código de respuesta HTTP 5xx ante errores temporales en su servidor. En este caso, el servicio de alerta de Xsolla usa un mecanismo de reintento.
Nota
En este caso, los artículos se añaden al inventario del jugador y el pedido se marca como aceptado en el lado de Xsolla.
Compra con cesta
Si un usuario utiliza compra con cesta:
- Si la cesta del usuario contiene artículos de pago y gratuitos, haga una llamada a la API estándar Create order with all items from particular cart y Create order with all items from current cart para crear pedidos. Los usuarios harán el pago del pedido a través del formulario de pago de Pay Station.
- Si la cesta del usuario solo contiene artículos gratuitos, haga una llamada a las API Create order with free cart y Create order with particular free cartr para obtener una cesta gratuita. En este caso, no se utilizará la interfaz de pago.
El ejemplo del webhook es similar al ejemplo para la compra rápida.
¿Te ha resultado útil este artículo?
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.