跳到正文

Medusa 2 支付服务商

在 Medusa 中接受加密货币支付

适用于 Medusa 2 的加密货币支付服务商。客户在 ArionPay 页面付款,款项直接进入您自己的钱包。

安装

npm install medusa-payment-arionpay
GitHub 上的源代码
示例

功能介绍

Medusa 版 ArionPay

medusa-payment-arionpay 是用于加密货币的 Medusa 2 支付服务商。您的店面会将客户引导至 ArionPay 页面,资金直接进入您自己的钱包:ArionPay 从不持有资金。
阅读更多ArionPay 确认全额付款后,其签名 Webhook 会让 Medusa 授权支付会话并将购物车转为订单,即使客户再也没有返回。这是一个面向自行运行 Medusa 后端和店面的开发者的软件包。
  • 以 medusa-payment-arionpay 名称发布在 npm 上,除 Medusa 本身外没有任何依赖。
  • 签名的 invoice.paid Webhook 会将购物车转为订单,即使客户再也没有返回。
  • 店面完成购物车结算时,服务商会直接向 ArionPay 查询,因此丢失的 Webhook 也能被发现。
  • 只有当 ArionPay 本身确认了金额、货币和模式都相同的账单时,会话才算已支付。
  • 如果购物车有变动,下一个会话会按新的总额获得一张新账单。
  • 加密货币付款一经完成即不可撤销,因此会立即完成收款(capture)。
  • 除非您将 testMode 设为 false,否则它保持开启,因此遗漏设置绝不会收取真实资金。
示例

要求与许可证

适用于
Medusa 2 · Node 20 或更高版本
测试情况
Medusa 2.22.7,Node 22 和 PostgreSQL 16:通过 Store API 完成 21 项检查,另加 7 个单元测试
费用
插件免费。ArionPay 每笔付款收取 0.5% 手续费,无月费。
源代码
在 GitHub 上开源(MIT)。

设置

5 步完成设置

设置位置:medusa-config.ts 和 .env,然后是 Medusa 后台中的 Settings > Regions
  1. 第 1 步

    安装软件包

    在您的 Medusa 后端中运行 npm install medusa-payment-arionpay。

  2. 第 2 步

    注册服务商

    在 medusa-config.ts 中,将 medusa-payment-arionpay/providers/arionpay 以 id arionpay 添加到支付模块。将您的三个 ArionPay 密钥和后端地址写入 .env。

  3. 第 3 步

    添加到您的区域

    重启 Medusa,在后台打开 Settings > Regions,将 ArionPay (pp_arionpay_arionpay) 添加到每个需要提供加密货币支付的区域。

  4. 第 4 步

    更新店面

    使用 return_url 创建支付会话,将客户引导至 session.data.invoice_url,并在客户返回时完成购物车结算。

  5. 第 5 步

    先测试,再上线

    使用模拟资金的测试模式会一直保持开启,直到您将 ARIONPAY_TEST_MODE 设为 false。请确认您的 ArionPay 店铺设置中“Old ArionPay (v1) integration compatibility”已关闭。

设置完成后

订单状态如何变化

  • ArionPay 确认全额付款后,其签名 Webhook 会让 Medusa 授权支付会话并将购物车转为订单。
  • 加密货币付款一经完成即不可撤销,因此会立即完成收款(capture)。
  • 店面完成购物车结算时,服务商会直接向 ArionPay 查询。已转为订单的购物车会返回该订单。
  • 如果会话创建后购物车有变动,下一个会话会按新的总额获得一张新账单。
  • 金额不准确的付款会进入 Payment Radar。差额在您店铺付款容差(默认 1%)以内的会自动接受;其他情况由您决定。逾期付款仍会完成订单。
  • 会话数据会记录已支付的账单、币种以及 paid_late 或 underpaid_within_tolerance 等备注。

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

关于 Medusa 版 ArionPay 的问题

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

Medusa 2。已在 Medusa 2.22.7、Node 22 和 PostgreSQL 16 上测试。