跳到正文

PHP 开发库

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

从任何 PHP 网站创建加密货币账单,将客户引导至支付页面,并在客户付款时校验签名 Webhook。资金直接进入您自己的钱包。

安装

composer require arionpay/arionpay-php
GitHub 上的源代码
示例

功能介绍

面向 PHP 开发者的 ArionPay

arionpay/arionpay-php 是 ArionPay 官方的 PHP 客户端,适用于 PHP 7.4 及更高版本。它没有任何依赖:已安装 cURL 时使用 cURL,否则使用 PHP 流(streams)。
阅读更多您可以用 Composer 安装,也可以上传文件夹并 require 其中的 autoload.php,因此同样适用于共享主机。ArionPay 从不持有资金:每笔付款都直接进入您自己的钱包。
  • PHP 7.4 或更高版本。无任何依赖。
  • 已安装 cURL 时使用 cURL,否则使用 PHP 流。从不跟随重定向。
  • 可配合 Composer 使用,也可以不用:复制文件夹并 require autoload.php 即可。
  • 相同的 idempotencyKey 总是返回同一张账单,因此刷新页面不会创建第二张。若不提供您自己的键,会使用一个随机键来保护重试。
  • 使用 HMAC-SHA256 和您的 API secret 为每个账单请求签名,密钥本身从不发送。
  • Webhook::fromGlobals 读取原始请求体和 ArionPay-Signature 请求头;签名错误或超过 5 分钟时,会抛出 SignatureException。
  • 借助 simulatePayment 和 sendTestWebhook,您可以不用真钱试用整个流程。

要求与许可证

适用于
PHP 7.4 或更高版本 · 可用或不用 Composer,包括共享主机 · cURL 或 PHP 流
费用
开发库免费。ArionPay 每笔付款收取 0.5% 手续费,无月费。
源代码
在 GitHub 上开源(MIT)。

设置

5 步完成设置

  1. 第 1 步

    安装开发库

    运行 composer require arionpay/arionpay-php。不用 Composer 时,将文件夹上传到您的网站旁边,然后 require __DIR__ . '/arionpay-php/autoload.php'。

  2. 第 2 步

    复制您的密钥

    在您的 ArionPay 控制台中打开您的店铺,复制 API key(pk_)和 API secret(sk_,复制时需要输入验证器动态码)。Webhook 的 signing secret(whsec_)位于“Webhooks”页面。请将它们保存在环境变量中,或网站根目录之外的配置文件里。

  3. 第 3 步

    创建账单

    用金额、货币、orderId 和 idempotencyKey 调用 createInvoice,然后将客户重定向到 $invoice['invoiceUrl']。

  4. 第 4 步

    校验 Webhook

    在“Webhooks”页面设置一个使用 443 或 8443 端口的公网 https:// 地址,或用 callbackUrl 为单张账单设置。在该脚本中调用 Webhook::fromGlobals($secret),并在收到 invoice.paid 时交付订单。

  5. 第 5 步

    不用真钱进行测试

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

设置完成后

付款如何到达您的代码

  • invoice.pending:已在网络上发现付款,正在等待确认。请暂勿交付。
  • invoice.paid: fully paid and confirmed, or accepted by you by hand in the dashboard. Deliver only on this event (or when getInvoice() says paid). Coming back to successUrl does not prove payment.
  • 交付前,请将账单与您的订单核对:您的 orderId 或 metadata,以及与订单当前总额相同的金额和货币。
  • invoice.partial、invoice.expired 和 invoice.needs_review 都不代表可以交付。逾期付款仍可能让已过期的账单变为已支付。
  • 如果您的服务器没有返回 2xx,ArionPay 会在大约 3 天内重复发送。每个事件 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 PHP 开发库的问题

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

可以。将 arionpay-php 文件夹上传到您的网站旁边,并 require 其中的 autoload.php。这在共享主机上同样可行。