Medusa 2 支付服务商
在 Medusa 中接受加密货币支付
适用于 Medusa 2 的加密货币支付服务商。客户在 ArionPay 页面付款,款项直接进入您自己的钱包。
安装
npm install medusa-payment-arionpay示例
功能介绍
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 步
安装软件包
在您的 Medusa 后端中运行 npm install medusa-payment-arionpay。
第 2 步
注册服务商
在 medusa-config.ts 中,将 medusa-payment-arionpay/providers/arionpay 以 id arionpay 添加到支付模块。将您的三个 ArionPay 密钥和后端地址写入 .env。
第 3 步
添加到您的区域
重启 Medusa,在后台打开 Settings > Regions,将 ArionPay (pp_arionpay_arionpay) 添加到每个需要提供加密货币支付的区域。
第 4 步
更新店面
使用 return_url 创建支付会话,将客户引导至 session.data.invoice_url,并在客户返回时完成购物车结算。
第 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 上测试。
需要。ArionPay 是跳转式支付:使用返回地址创建会话,将客户引导至 ArionPay 页面,并在客户返回时完成购物车结算。README 中的店面示例遵循测试所用的 Store API 调用;它没有在 Next.js 店面中运行过。
订单仍会创建。ArionPay 的签名 invoice.paid Webhook 会让 Medusa 授权付款并将购物车转为订单。
Medusa 的退款按钮会记录退款。您需要从自己的钱包把加密货币退回。
该 Medusa 2 支付服务商免费开源(MIT 许可证)。ArionPay 从预付手续费余额中收取每笔付款的 0.5%,因此全额款项都会到达您的钱包。无月费,无开通费,新账户可获得 $20 手续费额度。