概述
@elata-biosciences/app-payments 让您的应用打开 Elata 的结帐并检查用户拥有什么。 Elata 运行结账,在 USDC中付款,并记录所有权。您的应用程序永远不会接触钱包或付款详细信息。
创建您的目录
打开 我的应用程序→您的应用程序→编辑→商业→产品。所有者和授权团队成员可以自行创建和管理目录。
保存产品,然后将其分配的
contentId 复制到您的集成中。标识符是稳定的且无法编辑。可以编辑或停用产品,但不能删除产品。停用会停止新的销售;继续应用现有所有者的权益,包括当该项目不再出现在活动目录中时。
仪表板接受普通金额,例如 1.00。产品 API 和目录响应使用整数 USDC 基本单位: "1000000" 表示 1 USDC。创建目录条目不会在您的应用程序中实现其优势。
部署必须配置结账功能。此处描述的应用程序结帐通过拆分器在 Base 上支付 USDC 。在测试付款之前,请参阅 当前状态 。
正确的流程
首先确定您的用户界面的所有权,然后购买,然后应用权益。requestPurchase 记录用户已拥有商品;您的应用负责决定拥有商品后解锁什么权益。
要知道的事情
根据状态分支,从不在 txHash 上分支
根据状态分支,从不在 txHash 上分支
如果用户已经拥有该物品,Elata 会跳过付款并返回
{ status: "success", txHash: "" }。检查 if (result.txHash) 的代码会对此进行错误处理。两种价格格式
两种价格格式
CatalogItem.priceUsdc 采用 USDC 基本单位 (6 位小数): "50000" 为 0.05 美元。 RequestPurchaseInput.priceUsdc 是 Elata 忽略的自由格式显示提示。 Elata 始终按目录价格收费。物品是一次性解锁的
物品是一次性解锁的
每件商品购买一次。物品不支持消耗品(每次使用支出余额)和定期计费。对于经常性收入,请使用 订阅计划。
超时
超时
requestPurchase 等待用户最多 5 分钟完成结账。 getCatalog、 getOwnedItems和 hasItem 默认为 10 秒。在 Elata 之外,使用模拟主机进行本地测试。将所有权查询失败视为未知所有权:提供重试或登录操作,并且永远不要仅仅因为查询超时而授予付费权益。错误
只有调用被拒绝时才会抛出AppPaymentsError,其中包含 code:
常规的
cancelled 或 error 购买结果通过 Promise 正常返回,不会导致 Promise 被拒绝。
安全模型
- Elata的购买记录是在服务器端支付验证后创建的。您的 UI 应使用主机所有权查询作为其事实来源。
- 您的应用 永远不会看到 付款详细信息、钱包密钥或会话令牌。
- 使用相同的
requestId重放记录请求是幂等的。这并不意味着发送第二次链上支付是安全的。 - 拆分器扣除配置的平台费用并将创建者的份额发送到收款钱包。请参阅 收入与收款。
尝试一下
examples/iap-demo:一个带有内置模拟商店的独立 HTML 文件,因此您可以在本地运行完整流程。- npm 上的软件包自述文件
付款和 UI 状态
分别处理成功、取消和错误。防止重复购买尝试。成功付款和记录权利是分开的步骤;仅在 Elata 报告成功后解锁。 如果付款已结算但记录失败,请保留交易详细信息并将用户引导至 计费帮助。不要自动发送另一笔付款。结账流程会针对暂时的索引延迟进行重试,但不能保证从每次记录失败中恢复。 所有权查询可能需要身份验证。在not_authenticated上,要求用户登录;查找失败时,显示重试状态。不要默默地将未知的所有权视为已确认的非所有者。
该应用程序本身不连接钱包。 Elata checkout 管理钱包连接和付款确认,包括使用时的嵌入式钱包界面。按量计费功能的使用额度不能替代购买这些商品所需的付款余额。
测试您的集成
- 重新打开应用程序并恢复主机所有权中已拥有的权益。
- 已购买的商品显示 使用 或 已拥有;可购买但尚未拥有的商品显示 购买。
- 使用空事务哈希处理成功的已拥有响应。
- 处理注销、取消、资金不足、无法结帐和查找错误状态。
- 停用某个项目并验证现有所有者是否仍然可以使用其权益。