Para vender créditos de moneda virtual, define una moneda virtual una sola vez y luego vincúlala a tus productos.

Esto se hace en dos pasos, ambos descritos en este artículo. Una vez que vinculas un producto, cada compra o renovación otorga créditos automáticamente.

Crear una moneda virtual

En el Adapty Dashboard, abre Products > Virtual currency.

Para crear una moneda virtual:

1. Haz clic en New virtual currency. El panel se abre en el paso General.
2. Rellena los detalles de la moneda:
   • Code: El identificador único y permanente de la moneda dentro de tu aplicación, por ejemplo, COINS. Identifica la moneda en la API del lado del servidor y realiza un seguimiento del saldo de cada usuario.

Utiliza letras latinas, dígitos y guiones bajos, hasta 32 caracteres. Las letras minúsculas se convierten automáticamente a mayúsculas.

• Name: El nombre visible, como Gold. Puedes cambiarlo más adelante.
• Description: Una nota opcional sobre la moneda.

3. Haz clic en Continue para pasar al paso Link Products.

Cuando introduces una nueva moneda, el saldo inicial de cada perfil de usuario es 0.

Vincular productos

Vincula un producto a una moneda virtual para que una compra o renovación otorgue créditos en esa moneda. Puedes vincular un producto a varias monedas y una moneda a varios productos. Puedes vincular productos ahora, durante el paso Link Products, o añadirlos más tarde al editar la moneda.

Durante el paso Link Products, la sección Associated products muestra los productos que otorgan esta moneda. Para añadir uno, haz clic en Add associated products y selecciona un producto.

Cada concesión se suma al saldo del usuario en lugar de reemplazarlo, por lo que los créditos de distintos productos se acumulan. La configuración de créditos depende del tipo de producto:

• Los productos de suscripción tienen tres configuraciones de créditos:
  • Credit per cycle (obligatorio): Los créditos que se otorgan en cada renovación, incluida la que convierte una prueba gratuita en pago.
  • Credit on trial start (opcional): Una cantidad única y separada que se otorga cuando comienza una prueba gratuita.
  • Credits expire at the end of each billing cycle (interruptor): Cuando está activado, Adapty restablece los créditos no utilizados a 0 en cada renovación, antes de conceder los créditos del nuevo ciclo. Cuando está desactivado, los créditos se acumulan entre ciclos y nunca caducan.
• Productos de compra única: Define el Credit amount, es decir, el número de créditos que se otorgan por cada compra. Los créditos de compras únicas nunca caducan.

Haz clic en Save para crear la moneda con sus vínculos de producto.

Los vínculos de producto solo se aplican a partir de ese momento. Un producto recién vinculado otorga créditos desde su próxima compra o renovación. Adapty no concede automáticamente la moneda a los suscriptores actuales — primero tienen que renovar la suscripción. Al eliminar un vínculo, los futuros otorgamientos se detienen, pero los créditos ya concedidos se mantienen.

Cuando el interruptor de expiración está activado, los créditos con fecha de caducidad siguen el ciclo de vida de la suscripción:

• Durante el reintento de cobro o el período de gracia, Adapty no otorga nuevos créditos.
• Tras una cancelación, los créditos se mantienen hasta el final del período pagado.
• Cuando la suscripción expira, Adapty restablece los créditos restantes a 0.

Pasos siguientes

Una vez que hayas creado una moneda virtual y vinculado productos, las compras otorgarán créditos automáticamente. A partir de aquí:

• Consulta el saldo de cada usuario en la página Virtual currency balance.
• Otorga, gasta y lee saldos en tiempo de ejecución a través de la API del servidor: Create virtual currency transaction y List virtual currency balances. Para un ejemplo práctico, sigue la Virtual currency quickstart.