Lia开发者

概念

人们在$LIA上为您的应用销售的产品付款,在Lia自己的支付表上,价格以Lia的记录为准。您的服务器确认每笔费用,交付它,或退款。

#支付如何运作

  1. 您的页面询问Lia.pay("extra-lives") 与你其中一个产品的ID。
  2. Lia的支付表在你的应用上打开它显示Lia的记录中的物品及其价格(绝不是您页面的),您的应用和开发者名称,以及该人的余额之后。
  3. 这个人确认的 $LIA 离开了他们的余额。Lia Labs 为你持有你的份额,费用作为你的应用记录为 paid.
  4. 您的页面会听到它pay() 答案 { chargeId, productId }. A charge.paid 网络钩子也会发送到你的服务器。
  5. 您的服务器分发它与Lia核对费用,给那个人他们购买的东西,并标记该费用 delivered。或者,如果不能,就退款。

您的页面不处理金钱、卡片或钱包,并且可以't 更改价格:表格只显示'在Lia'的记录。

#产品

你的应用销售的内容由 Lia 团队设置(直到开发者门户上线)。每个产品都有:

字段规则
id1到64个字符:字母、数字, _, . 和 -,以字母或数字开头。这就是你要传递给 Lia.pay().
name最多60 个字符,显示在支付表单和该人's 活动。
price在$LIA中,大于0且最多为1,000,000,,保留6位小数。
active移除产品只会隐藏它:其过去的费用仍然保留。

您的服务器可以使用 GET /products.

#费用

一个付款。它有一个像 ch_9b1f… 和一个状态:

状态意义
paid这个人支付了。你的应用没有't 还没有交付它。
delivered您的服务器说它已交付。再次交付不会有任何变化。
refunded的 $LIA 退回给那个人。退款可以't 会被送达。

您的服务器通过 GET /charges/:id, POST /charges/:id/deliver 和 POST /charges/:id/refund.

#您的份额

当支付一笔实时费用时,全额价格将从付款人账户中扣除'的余额。您的份额(70%,除非与Lia团队另有约定)由Lia Labs代为保管,其余部分留在Lia。退款会从两者中全额返还给该人。

Lia Labs 每月向您的个人Lia 余额支付您的份额。从$LIA 主网在 Q1 2028, 您可以将其提现到您自己的钱包。参见 获得报酬.

#永远不要丢失付款

在支付表单和您的服务器之间,页面可能会重新加载、崩溃或失去连接。Lia 会保留每笔已支付的费用,直到您的服务器交付它,并为您的页面提供三种查找方式:

  • pay() 答案 与 { chargeId, productId } 在正常情况下。
  • Lia.onCharge(fn) 听到一个在没有 pay() 正在等待,例如在页面重新加载时,而表单处于打开状态。
  • Lia.charges() 列出这个玩家'的付费,未送达的费用(按旧到新排序,最多50个)。在你的应用打开时调用它。

并且您的服务器可以依赖 charge.paid 网络钩子 而不是页面。 出售物品 将所有这些组合在一起。

#当支付未发生时'不要发生

Lia.pay() 失败时会返回一个错误,其 code 说明原因:

代码何时
cancelled这个人关闭了表单但没有支付。最常见的:将其视为正常 "否".
no_product那里'的没有与你的应用中该ID相关的活跃产品。
busyLia 的另一个'的屏幕已经在您的应用上打开。
bad_productIdID 不是'最多输入64个字符。

如果这个人没有'不要有足够的$LIA,或者付款在途中失败,付款表会自己告诉他们并保持打开,让他们可以再试一次。你的页面只会听到 cancelled 当他们关闭它时。

#测试模式

在测试模式下,支付表会说明这一点,没有人'的余额变动,而且没有人需要足够的$LIA。其他一切(您的服务器'的调用、网络钩子、交付和退款)与实时模式下相同。参见 测试和上线.

#在Lia中的付款表

下图是从Lia在Android上的完整截图,显示Lia国际象棋的付款确认。您的页面要求付款;该人在Lia自己的表格中确认。

Lia 在 Android 上的支付确认

自动翻译。英语是真实来源。 阅读英文

输入以搜索每一页、方法和端点。