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

1. Cree artículos gratuitos de las siguientes formas:
   • a través Cuenta del editor
   • a través de llamadas API
2. Establecer Tienda.
3. Obtener el estado del pedido de un usuario.

Crear mediante Cuenta del editor

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Store en el menú lateral.
3. En el panel Virtual Items, haga clic en Configure.
4. Haga clic en + y seleccione Crear artículo en la lista desplegable.
5. 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
6. En el bloque Price settings, seleccione Free item.
7. 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.
8. Si desea mostrar un artículo en la tienda, cambie el conmutador Show item in store a On.
9. Haga clic en Create item.

Crear mediante llamadas API

1. Para crear artículos gratuitos, utilice las llamadas API de la subsección Admin:
   • Para artículos virtuales — Crear artículo virtual
   • Para paquete de moneda — Crear un paquete de moneda virtual
   • Para lotes — Crear lote
   Al crear o editar un artículo, transmita is_free = true en el cuerpo de la solicitud.
2. 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

{
  "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
  }
}

• 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.
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.
• 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.

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 Crear pedido con todos los artículos de la cesta y Crear pedido con todos los artículos de la cesta actual 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 Crear pedido con cesta gratuita y Crear pedido con una cesta gratuita concreta 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.