Concepts

Paiements et feuille de paiement

Copier la page

Les gens paient pour ce que votre application vend en $LIA, sur Lia's propre feuille de paiement, au prix des enregistrements de Lia. Votre serveur confirme chaque charge, la livre ou la rembourse.

#Comment un paiement fonctionne

Votre page demandeLia.pay("extra-lives") avec l'identifiant d'un de vos produits.
la feuille de paiement de Lia s'ouvre au-dessus de votre applicationIl affiche l'élément et son prix à partir des registres Lia (jamais de votre page), votre application et le nom de l'éditeur, ainsi que le solde de la personne après.
La personne confirmeLe $LIA quitte leur solde. Lia Labs détient votre part pour vous, et la charge est enregistrée pour votre application comme paid.
Votre page l'entendpay() réponses { chargeId, productId }. A charge.paid le webhook est envoyé vers votre serveur également.
Votre serveur livreIl vérifie la charge avec Lia, donne à la personne ce qu'elle a acheté, et marque la charge delivered. Ou, s'il ne peut pas, le rembourse.

Votre page ne gère jamais d'argent, de cartes ou de portefeuilles, et peut'ne pas changer un prix : la feuille n'affiche jamais que ce'dans Lia'ses enregistrements.

#Produits

Ce que votre application vend est configuré par l'équipe Lia (jusqu'à l'arrivée du portail des développeurs). Chaque produit comporte :

Champ	Règles
`id`	1 à 64 caractères : lettres, chiffres, `_`, `.` et `-`, commençant par une lettre ou un chiffre. C'est ce que vous transmettez à `Lia.pay()`.
`name`	Jusqu'à 60 caractères, affichés sur la feuille de paiement et dans la personne'activité.
`price`	Dans $LIA, plus de 0 et jusqu'à 1,000,000, à 6 décimales.
`active`	Supprimer un produit ne fait qu'le cacher : ses anciens paiements restent.

Votre serveur peut les lister avec GET /products.

#Frais

Une charge est un paiement. Elle a un identifiant comme ch_9b1f… et un statut :

Statut	Signification
`paid`	La personne a payé. Votre application n'a pas'ne pas l'avoir encore livré.
`delivered`	Votre serveur a dit qu'il l'avait livré. Relivrer ne change rien.
`refunded`	Le $LIA est retourné à la personne. Une charge remboursée peut'ne pas être livré.

Votre serveur travaille avec des charges via GET /charges/:id, POST /charges/:id/deliver et POST /charges/:id/refund.

Quand un paiement en direct est effectué, le prix complet quitte la personne'votre solde. Votre part (70% sauf accord contraire avec l'équipe Lia) est conservée pour vous par Lia Labs, et le reste reste avec Lia. Un remboursement donne à la personne le prix complet, hors des deux.

Lia Labs verse votre part mensuellement, dans votre propre solde Lia. À partir du mainnet $LIA en Q1 2028, vous pouvez le retirer vers votre portefeuille. Voir Être payé.

#Ne jamais perdre un paiement

Une page peut se recharger, planter ou perdre sa connexion entre la feuille de paiement et votre serveur. Lia conserve chaque charge payée jusqu'à ce que votre serveur la livre, et offre à votre page trois façons de les trouver :

pay() réponses avec { chargeId, productId } dans le cas normal.
Lia.onCharge(fn) entend une charge confirmée pendant qu'il n' pay() attendait, par exemple après que la page ait été rechargée alors que la feuille était ouverte.
Lia.charges() liste ce joueur'ses frais payés, non livrés (du plus ancien au plus récent, jusqu'à 50). Appelez-le lorsque votre application s'ouvre.

Et votre serveur peut compter sur le charge.paid webhook au lieu de la page. Vendre un article rassemble toutes ces choses.

#Quand un paiement ne'ne se produit pas

Lia.pay() échoue avec une erreur dont la code dit pourquoi :

Code	Quand
`cancelled`	La personne a fermé la feuille sans payer. La plus commune : traitez-la comme un normal "non".
`no_product`	Il y a'le non produit actif avec cet identifiant pour votre application.
`busy`	Un autre de Lia'les écrans sont déjà ouverts au-dessus de votre application.
`bad_productId`	L'id n'est pas'texte jusqu'à 64 caractères.

Si la personne ne'ne pas avoir assez $LIA, ou le paiement échoue en cours de route, le formulaire de paiement le leur dit lui-même et reste ouvert afin qu'ils puissent réessayer. Votre page n'entend que cancelled quand ils le ferment.

#Mode test

En mode test, la feuille de paiement le précise, personne'votre solde se déplace, et personne n'a besoin de suffisamment $LIA. Tout le reste (votre serveur'les appels, les webhooks, la livraison et le remboursement) fonctionnent comme en direct. Voir Test et live.

#La feuille de paie dans Lia

La capture d'écran ci-dessous est une capture complète de Lia sur Android, montrant la confirmation de paiement pour Lia Chess. Votre page demande de payer ; la personne confirme dans sa propre feuille Lia.

Confirmation de paiement Lia sur Android

Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais