LiaDesarrolladores

Conceptos

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

  1. Tu página preguntaLia.pay("extra-lives") con el id de uno de tus productos.
  2. 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.
  3. 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.
  4. Tu página lo escuchapay() respuestas { chargeId, productId }. A charge.paid el webhook también va a tu servidor.
  5. 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:

CampoReglas
id1 a 64 caracteres: letras, dígitos, _, . y -, que comience con una letra o dígito. Esta es la que pasa a Lia.pay().
nameHasta 60 caracteres, mostrados en la hoja de pago y en la persona's actividad.
priceEn $LIA, más de 0 y como máximo 1,000,000, a 6 decimales.
activeEliminar 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:

EstadoSignificado
paidLa persona pagó. Tu aplicación no'aún no lo ha entregado.
deliveredTu servidor dijo que lo entregó. Entregarlo de nuevo no cambia nada.
refundedEl $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 no pay() 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ódigoCuándo
cancelledLa persona cerró la hoja sin pagar. La más común: trátala como una normal "no".
no_productAllí'tu no tiene un producto activo con ese id para tu aplicación.
busyOtro de Lia'las pantallas ya están abiertas sobre tu aplicación.
bad_productIdEl 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.

Confirmación de pago en Lia en Android

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

Escribe para buscar en cada página, método y punto final.