forumpay / drupal-9-payment-gateway-plugin
论坛支付为Drupal提供的加密货币支付
Requires
- php: >=7.4
- forumpay/payment-gateway-php-client: ^v1.1.3
- psr/log: >=1.1.4
This package is auto-updated.
Last update: 2024-09-28 13:57:28 UTC
README
安装指南
要求
请确保您至少安装了Drupal Commerce 2.2或更高版本。支持Drupal 9和Drupal 10版本。使用composer进行安装。
使用composer进行安装
composer require forumpay/drupal-9-payment-gateway-plugin
从旧版本升级
composer update forumpay/drupal-9-payment-gateway-plugin
配置
插件激活后,转到配置页面。导航到 管理 > 商业 > 配置 > 支付网关。找到按钮 + 添加支付网关
输入支付网关名称:论坛支付。从 插件部分 选择 论坛支付支付,并按以下方式填写其余参数。
配置详情
- 显示名称 当用户被提示选择时显示的支付方式标签。您可以选择默认值或设置为例如 使用加密货币支付。
- 环境 下拉菜单允许您在 '生产' 和 '沙盒' 模式之间切换。使用 '生产' 在实时环境中处理真实交易,使用 '沙盒' 进行安全测试而无需财务影响。
- API用户 这是我们需要访问支付系统的标识符。它可以在您的 个人资料 中找到。 转到个人资料 >
- API密钥 重要:永远不要与任何人分享!将其视为密码。API密钥由两部分组成。在 论坛支付仪表板 中生成时,第一部分将在您的个人资料中显示,而第二部分将通过电子邮件发送给您。您需要在这里输入这两部分(依次输入)。
- POS ID 这将用于识别发送到您的钱包的支付。不允许特殊字符。允许的字符是:
[A-Za-z0-9._-]
(例如my-shop
,my_shop
)。 - 成功订单状态 用户成功完成支付后订单获得的状态。
- 自定义环境URL 可选:API服务器的URL。此值将覆盖默认设置。仅用于调试。
- 接受即时(零)确认 允许立即交易批准,无需等待网络确认,提高速度但风险增加。
设置完成后,不要忘记点击 保存 按钮。
Webhook设置
Webhook 允许我们独立于客户的操作检查订单状态。
例如,如果客户在支付开始后 关闭标签,网店无法确定订单的状态。
如果您不设置Webhook通知,订单可能永远处于 待处理
状态。
Webhook设置
Webhook配置在您的 个人资料 中。您可以通过向下滚动找到Webhook URL。
在Webhook URL字段中插入 URL:YOUR_WEBSHOP/forumpay-api?act=webhook
YOUR_WEBSHOP 是您网店的URL。完整的Webhook URL示例为:https://my.webshop.com/forumpay-api?act=webhook
功能
当客户点击 下单 按钮,他们将被重定向到支付页面,在那里可以选择加密货币。
当选择货币后,将显示加密货币支付的详细信息:金额、汇率、费用、总额、预计时间。
在客户点击 开始支付 按钮后,他们有5分钟的时间通过扫描 二维码 或手动使用二维码下方显示的区块链地址来支付订单。
故障排除
无法选择加密货币,没有下拉菜单:这个问题可能是因为网店的后端无法访问ForumPay。请检查配置中的API密钥是否正确。
插件已成功安装并激活,但不在Drupal支付设置中显示 请确保您已安装最新版本的ForumPay支付网关。