Este inicio rápido configura una moneda de tokens de extremo a extremo: una suscripción otorga a los usuarios 1000 tokens al mes, y las acciones de pago en tu app cuestan tokens. Adapty gestiona cada saldo, por lo que tu backend solo necesita leerlos y gastarlos.

1. Sigue la guía Crear moneda virtual para crear una moneda TOKENS. Vincúlala a tu suscripción Pro y establece Credit per cycle en 1000. Para vender paquetes de tokens adicionales, vincula también productos de paquetes de tokens de compra única.

   

2. Llama a List virtual currency balances para leer el saldo del usuario, por ejemplo, antes de iniciar una generación:

   curl https://api.adapty.io/api/v2/server-side-api/vc/balances/ \
     -H "Authorization: Api-Key {your secret key}" \
     -H "adapty-customer-user-id: user-42"

La respuesta lista todas las monedas que tiene el usuario, por ejemplo 1000 TOKENS:

   {
     "data": [
       { "code": "TOKENS", "name": "Tokens", "balance": 1000, "held": 0, "available": 1000 }
     ]
   }

3. Cuando el usuario ejecute una generación, gasta los tokens llamando a Crear transacción de moneda virtual con un amount negativo. En este ejemplo, una generación de imagen cuesta 100 tokens:

   curl -X POST https://api.adapty.io/api/v2/server-side-api/vc/transactions/ \
     -H "Authorization: Api-Key {your secret key}" \
     -H "adapty-customer-user-id: user-42" \
     -H "Content-Type: application/json" \
     -d '{"items": [{"currency_code": "TOKENS", "amount": -100}]}'

La transacción es atómica y devuelve el saldo actualizado. Si el usuario no puede cubrir el coste, la solicitud devuelve insufficient_balance y no se produce ningún cambio. Incluye una cabecera Idempotency-Key para reintentar solicitudes de forma segura. 4. Para lanzar una promo de recuperación, otorga tokens a través del mismo endpoint con un amount positivo. Los créditos otorgados de esta forma nunca expiran. 5. Revisa cada cambio en el perfil del usuario o en el historial de transacciones para auditar la economía en cualquier momento.