跳到正文

Drupal Commerce 模块

在 Drupal Commerce 中接受加密货币支付

一款添加 ArionPay 支付网关的 Drupal Commerce 模块。客户在 ArionPay 页面付款,资金直接进入您自己的钱包。

示例

功能介绍

Drupal Commerce 版 ArionPay

Commerce ArionPay 是适用于 Drupal Commerce 的站外支付网关。在“Review”步骤中,客户点击“Pay and complete purchase”后前往 ArionPay 页面,订单则保持为锁定的草稿。
阅读更多ArionPay 确认全额付款后,模块会记录一笔已完成的付款,其 remote id 为 ArionPay 账单 ID,随后 Commerce 提交订单。订单绝不会在未付款时被提交。
  • 站外网关:客户在 ArionPay 页面付款
  • 记录一笔已完成的付款,以 ArionPay 账单 ID 作为 remote id
  • 客户返回时直接向 ArionPay 查询,即使 Webhook 丢失也能更新
  • 订单绝不会在未付款时被提交
  • 密钥可以写在 settings.php 中,避免出现在导出的配置里
  • “Test”和“Live”两种模式:测试账单绝不会在 Live 模式下被记录,真实账单也不会在 Test 模式下被记录
  • zip 包自带一份 ArionPay PHP 开发库
示例

要求与许可证

适用于
Drupal 10.3 和 11,搭配 Commerce 2.40+ 或 3.x · PHP 8.1 或更高版本
测试情况
Drupal 11,Commerce 3.3.14,PHP 8.3
费用
插件免费。ArionPay 每笔付款收取 0.5% 手续费,无月费。
源代码
在 GitHub 上开源(GPL v2 或更高版本),版本 1.0.0。

设置

4 步完成设置

设置位置:Commerce > Configuration > Payment gateways > Add payment gateway > ArionPay (crypto)
  1. 第 1 步

    添加模块

    将 commerce_arionpay-1.0.0.zip 解压到 web/modules/contrib/,然后在“Extend”中启用“Commerce ArionPay”。

  2. 第 2 步

    添加网关

    进入 Commerce > Configuration > Payment gateways > Add payment gateway,选择“ArionPay (crypto)”。

  3. 第 3 步

    粘贴您的密钥

    填入 API key(pk_)、API secret(sk_)和 Webhook signing secret(whsec_)。密钥保存后不会再次显示;字段留空即可保留原值。

  4. 第 4 步

    先测试,再上线

    将“Mode”设为“Test”,即可用模拟资金创建测试账单;收取真实付款时再切换为“Live”。在您的 ArionPay 店铺设置中,“Old ArionPay (v1) integration compatibility”必须处于关闭状态。

设置完成后

订单状态如何变化

  • 在“Review”步骤中,客户点击“Pay and complete purchase”后前往 ArionPay 页面。订单在付清前保持为锁定的草稿。
  • ArionPay 确认全额付款后,模块会记录一笔已完成的付款,随后 Commerce 提交订单。
  • 如果客户返回时账单尚未支付,客户会被带回 ArionPay 页面,该页面会显示付款进度。
  • 金额不准确的付款会进入 Payment Radar。差额在您店铺付款容差(默认 1%)以内的会自动接受;其他情况由您决定。
  • 逾期付款仍会被记录。
  • 已支付的订单若又有第二张账单被支付,这笔付款仍会被记录,并在日志中留下警告:请从您的钱包退款。

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

关于 Drupal Commerce 版 ArionPay 的问题

安装前需要了解的简短解答。

Drupal 10.3 和 11,搭配 Commerce 2.40 或更高版本或 Commerce 3.x,需要 PHP 8.1 或更高版本。已在 Drupal 11、Commerce 3.3.14 和 PHP 8.3 上测试。