跳到正文

Python 开发库

在您的 Python 应用中接受加密货币支付

在 Flask、Django、FastAPI 或普通脚本中创建加密货币账单,并在客户付款时校验签名 Webhook。资金直接进入您自己的钱包。

安装

pip install arionpay
GitHub 上的源代码
示例

功能介绍

面向 Python 开发者的 ArionPay

arionpay 是 ArionPay 官方的 Python 客户端,适用于 Python 3.8 或更高版本,仅使用标准库编写。它可以创建和读取账单,基于原始请求体校验 Webhook 签名,并能让测试账单经历各种付款场景。
阅读更多账单以 dict 形式返回,字段名与 Webhook 相同,因此一个函数即可同时处理 Webhook 和查询结果。ArionPay 从不持有资金:款项直接进入您自己的钱包。
  • 无任何依赖(仅使用标准库)。Python 3.8 或更高版本。
  • README 中提供 Flask、Django 和 FastAPI 示例。普通脚本同样适用。
  • 每个账单请求都带有幂等键,因此网络错误绝不会创建两张账单。
  • 使用 HMAC-SHA256 和您的 API secret 为每个账单请求签名,密钥本身从不发送。
  • verify_webhook 基于原始请求体校验 ArionPay-Signature 请求头;签名不匹配或超过 5 分钟时,会抛出 SignatureError。
  • simulate_payment 可让测试账单经历 exact、partial_half、overpaid 或 late 等场景。send_test_webhook 会发送一个签名的示例事件。
  • 自带类型提示(py.typed)。

要求与许可证

适用于
Python 3.8 或更高版本 · Flask、Django、FastAPI 或普通脚本 · 仅使用标准库
费用
开发库免费。ArionPay 每笔付款收取 0.5% 手续费,无月费。
源代码
在 GitHub 上开源(MIT)。

设置

5 步完成设置

  1. 第 1 步

    安装软件包

    运行 pip install arionpay。它只使用标准库。

  2. 第 2 步

    复制您的密钥

    在您的 ArionPay 控制台中打开您的店铺,复制 API key(pk_)和 API secret(sk_,复制时需要输入验证器动态码)。Webhook 的 signing secret(whsec_)位于“Webhooks”页面。请将它们保存在您的服务器上,例如放在环境变量中。

  3. 第 3 步

    创建账单

    用金额、货币和您的 order_id 调用 create_invoice,然后将客户引导至 invoice["invoiceUrl"]。

  4. 第 4 步

    校验 Webhook

    在“Webhooks”页面设置您的 Webhook 地址,或用 callback_url 为单张账单设置。将原始请求体和 ArionPay-Signature 请求头传给 verify_webhook,并在收到 invoice.paid 时交付订单。

  5. 第 5 步

    不用真钱进行测试

    用 test=True 和 USDT_TRC20 等资产创建账单,然后调用 simulate_payment(invoice["id"], "exact")。您的 Webhook 会像真实付款一样收到 invoice.paid。

设置完成后

付款如何到达您的代码

  • invoice.pending:已在网络上发现付款,正在等待确认。请暂勿交付。
  • invoice.paid:已全额支付并确认,或由您在控制台中手动接受。只在收到此事件(或 get_invoice 显示 paid)时交付。返回 success_url 并不能证明已付款。
  • 交付前,请将账单与您的订单核对:您的 order_id 或 metadata,以及与订单当前总额相同的金额和货币。
  • invoice.partial、invoice.expired 和 invoice.needs_review 都不代表可以交付。逾期付款仍可能让已过期的账单变为已支付。
  • 如果您的服务器没有返回 2xx,ArionPay 会在大约 3 天内重复发送。每个 event["id"] 只处理一次。

9 个网络上的 16 种币和代币

全部币种
  • BTCBitcoin
  • ETHEthereum
  • USDTEthereum
  • USDCEthereum
  • BNBBNB Smart Chain
  • USDTBNB Smart Chain
  • USDCBNB Smart Chain
  • POLPolygon
  • USDTPolygon
  • USDCPolygon
  • TRXTRON
  • USDTTRON
  • LTCLitecoin
  • DOGEDogecoin
  • BCHBitcoin Cash
  • DASHDash

关于 ArionPay Python 开发库的问题

将它加入代码之前需要了解的简短解答。

支持。为视图加上 @csrf_exempt 和 @require_POST,然后将 request.body 和 ArionPay-Signature 请求头传给 verify_webhook。