预付款

虽然 Pi 前端 JavaScript SDK 支持创建 U2A(用户到应用)支付,但您的应用可能还需要具备 A2U(应用到用户)支付功能。本文档将向您展示如何进行 A2U 支付。

请注意,A2U支付功能目前仅在测试网上可用。

Pi 后端 SDK

以下是可用于 A2U 支付流程的每种语言(或运行时)的 Pi 后端 SDK 列表。

语言关联地位
Rubypi-ruby由 Pi 核心团队官方支持
Node.jspi-nodejs即将推出! - 由 Pi 核心团队官方支持
Python待定社区维护
PHP待定社区维护

我们非常欢迎其他编程语言的社区维护者,如果您有兴趣维护 Pi SDK,请在PiOS 存储库中提交 PR。

支持的功能

本节列出了各个后端 SDK 支持的功能,这些功能可用于将树莓派集成到应用程序中。有关如何使用每个功能的具体信息,请参阅您在项目中使用的库的特定文档(参见上一节中的表格)。

应用内用户支付

目前A2U支付的设计涉及与Pi区块链和Pi后端的交互。Pi区块链显然是Pi交易的唯一权威来源。Pi后端用于改善终端用户体验(例如,为用户提供易于理解的钱包备注,并提供指向您应用程序的链接,同时通过不在区块链上公开这些信息来保护用户和开发者的隐私),并帮助开发者避免支付错误(例如,由于服务器故障导致的重复支付)。

好处:

更好的用户隐私:只要用户同意与您的应用程序共享钱包地址,此 API 即可安全地访问用户的钱包地址,并且鼓励开发者仅在真正打算向用户发送 π 时才访问用户的钱包,从而实现更好的隐私和用户安全。

用户钱包准确性:如果需要更改钱包,API 会返回当前用户钱包,以避免应用程序将 Pi 发送到已弃用、无法访问的用户钱包地址。

为用户和应用开发者提供更佳体验:一旦交易在区块链上发生,便无法撤销。在进行交易前通知 Pi 后端服务器您的付款信息,完成交易后再次通知后端服务器,即可在因技术问题导致交易记录未保存到数据库时,恢复相关的元数据和区块链交易信息。这样,作为第三方,Pi 后端可以帮助您避免重复付款或其他可能导致应用钱包意外清空的错误。当然,很多环节都可能出错,作为应用开发者,您是唯一负责管理应用钱包和资产的一方。此处提供的 API 按原样提供,不作任何保证。

与 Pi 生态系统更好地集成:使用 A2U API 可以让用户钱包中的付款显示为来自您的应用,而不是显示为来自未知地址的随机交易。这在未来可以带来更佳的用户体验,例如在用户钱包中提供直接链接返回您的应用,或者在用户钱包中直接显示已购买或已退货商品的缩略图图标。

打赏 Pi 打赏 微信打赏