Conceptos
Pagos y la hoja de pago
Copiar página
Las personas pagan por lo que tu aplicación vende en $LIA, en la hoja de pago propia de Lia, al precio en los registros de Lia. Tu servidor confirma cada cargo, lo entrega o lo reembolsa.
#Cómo funciona un pago
- Tu página pregunta
Lia.pay("extra-lives")con el id de uno de tus productos. - la hoja de pago de Lia se abre sobre tu aplicaciónMuestra el artículo y su precio de los registros de Lia (nunca los de su página), su aplicación y nombre del desarrollador, y el saldo de la persona después.
- La persona confirmaEl $LIA deja su balance. Lia Labs guarda tu parte por ti, y el cargo se registra para tu aplicación como
paid. - Tu página lo escucha
pay()respuestas{ chargeId, productId }. Acharge.paidel webhook también va a tu servidor. - Tu servidor entregaVerifica la carga con Lia, da a la persona lo que compró, y marca la carga
delivered. O, si no puede, lo reembolsa.
Tu página nunca maneja dinero, tarjetas o billeteras, y puede't cambiar un precio: la hoja solo muestra lo que's en Lia'los registros.
#Productos
Lo que su aplicación vende está configurado por el equipo de Lia (hasta que llegue el portal para desarrolladores). Cada producto tiene:
| Campo | Reglas |
|---|---|
id | 1 a 64 caracteres: letras, dígitos, _, . y -, que comience con una letra o dígito. Esta es la que pasa a Lia.pay(). |
name | Hasta 60 caracteres, mostrados en la hoja de pago y en la persona's actividad. |
price | En $LIA, más de 0 y como máximo 1,000,000, a 6 decimales. |
active | Eliminar un producto solo lo oculta: sus cargos anteriores permanecen. |
Tu servidor puede listarlos con GET /products.
#Cargos
Un cargo es un pago. Tiene un id como ch_9b1f… y un estado:
| Estado | Significado |
|---|---|
paid | La persona pagó. Tu aplicación no'aún no lo ha entregado. |
delivered | Tu servidor dijo que lo entregó. Entregarlo de nuevo no cambia nada. |
refunded | El $LIA volvió a la persona. Un cargo reembolsado puede't ser entregado. |
Su servidor funciona con cargos a través de GET /charges/:id, POST /charges/:id/deliver y POST /charges/:id/refund.
#Su participación
Cuando se paga una carga en vivo, el precio completo sale de la persona's saldo. Su parte (70% a menos que se acuerde lo contrario con el equipo Lia) se mantiene para usted por Lia Labs, y el resto se queda con Lia. Un reembolso le devuelve al usuario el precio completo, de ambos.
Lia Labs paga su parte mensual, en su propio Lia balance. Desde la mainnet $LIA en Q1 2028, puede retirarlo a su billetera. Ver Recibir pago.
#Nunca pierdas un pago
Una página puede recargarse, colapsar o perder su conexión entre la hoja de pago y su servidor. Lia conserva cada cargo pagado hasta que su servidor lo entregue, y le da a su página tres formas de encontrarlos:
pay()respuestas con{ chargeId, productId }en el caso normal.Lia.onCharge(fn)escucha una carga que fue confirmada mientras nopay()estaba esperando, por ejemplo después de que la página se recargara mientras la hoja estaba abierta.Lia.charges()lista a este jugador'sus cargos pagados, no entregados (el más antiguo primero, hasta 50). Llámelo cuando se abra su aplicación.
Y tu servidor puede confiar en el charge.paid webhook en lugar de la página. Vender un artículo une todos estos elementos.
#Cuando un pago no'ocurrir
Lia.pay() falla con un error cuyo code dice por qué:
| Código | Cuándo |
|---|---|
cancelled | La persona cerró la hoja sin pagar. La más común: trátala como una normal "no". |
no_product | Allí'tu no tiene un producto activo con ese id para tu aplicación. |
busy | Otro de Lia'las pantallas ya están abiertas sobre tu aplicación. |
bad_productId | El id no'no texto de hasta 64 caracteres. |
Si la persona no'tener suficiente $LIA, o el pago falla en el camino, la hoja de pago se lo dice a ellos misma y se queda abierta para que puedan intentarlo de nuevo. Su página solo escucha cancelled cuando lo cierran.
#Modo de prueba
En modo de prueba, la hoja de pago lo dice, nadie's saldo se mueve, y nadie necesita suficiente $LIA. Todo lo demás (su servidor's llamadas, webhooks, entrega y reembolsos) funciona como en vivo. Vea Prueba y producción.
#La hoja de pago en Lia
La captura de pantalla a continuación es una captura completa de Lia en Android, mostrando la confirmación de pago para Lia Ajedrez. Su página le pide que pague; la persona confirma en la propia hoja de Lia.

Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés