把Fluent Forms连接到Bayarcash
Bayarcash for Fluent Forms把Bayarcash加入你的Fluent Forms Pro付款表单,成为一种付款方式。你的顾客填写表单,在Bayarcash页面付款,然后回到你的网站。
安装之前想先看看插件怎样运作,可以试试在线演示。
插件为每个渠道添加一种付款方式。你可以为每个表单选择想要的付款方式:
| 付款方式 | 你的顾客用什么付款 |
|---|---|
| FPX Online Banking | FPX网上银行 |
| Credit Card | 通过FPX使用信用卡账户 |
| DuitNow Online Banking | DuitNow Online Banking/Wallets |
| DuitNow QR | 任何支持DuitNow QR的银行或电子钱包App |
| SPayLater | Shopee的SPayLater |
| Boost PayFlex | Boost PayFlex |
| Indonesia Online Banking | 印尼网上银行(QRIS) |
| Indonesia e-Wallet | 印尼电子钱包(QRIS) |
| NETS Singapore | NETS(新加坡) |
付款只限一次性付款,而且只接受MYR。不支持订阅和Direct Debit。一个渠道必须同时在你的Bayarcash portal开启,才能使用。请参阅付款渠道。
设置插件之前,你需要准备好这些:
- 一个已获批准的Bayarcash商家账号。
- 你的Personal Access Token (PAT)、API Secret Key和Portal Key。请参阅找到你的API key。
- 已安装并启用的Fluent Forms Pro,付款货币设为马来西亚令吉(MYR)。
这个插件在WordPress.org免费提供,名称是Bayarcash for Fluent Forms。安装步骤:
- 在WordPress里,前往Plugins → Add New。
- 搜索Bayarcash for Fluent Forms,然后点击Install。
- 点击Activate。
输入你的key
Section titled “输入你的key”为所有表单输入一次key就可以:
- 前往Fluent Forms → Bayarcash Settings。页面会打开Global Configuration标签页。
- 要收取真实付款,请让Enable Sandbox Mode保持关闭。
- 把你的token粘贴到Personal Access Token,然后点击Verify Token。token有效时,会显示“Token verified successfully”。
- 在Portal Key选择你的portal。
- 把你的key粘贴到API Secret Key。
- 可选:在Miscellaneous下,更改Payment Title。默认是Bayarcash。
- 保存你的设置。
把Bayarcash加入表单
Section titled “把Bayarcash加入表单”保存key之后,在每个表单开启付款方式:
- 在Fluent Forms打开表单,前往它的付款设置。
- 开启你想要的Bayarcash付款方式,例如FPX Online Banking和DuitNow QR。
- 可选:更改每种付款方式的Method Label。默认是“Pay with”加上付款方式名称。
- 保存表单。
在一个表单使用不同的key
Section titled “在一个表单使用不同的key”一个表单可以使用自己的Bayarcash账号或portal,而不是全局设置:
- 在Fluent Forms → Bayarcash Settings,打开Form Configuration,然后选择表单。
- 开启Customization。
- 为这个表单输入Personal Access Token、Portal Key和API Secret Key。这里的Portal Key是一个文字框,所以请从商家后台(merchant dashboard)复制key并粘贴进去。
- 保存你的设置。
在Bayarcash Gateway Fee标签页,你可以在顾客支付的金额上加一笔手续费。你可以为FPX Online Banking、Credit Card、DuitNow Online Banking和DuitNow QR设置手续费,方式可以是固定金额、百分比或两者都用,并加上一段顾客会看到的说明。其他渠道使用DuitNow QR的手续费。手续费适用于所有表单。
在sandbox测试
Section titled “在sandbox测试”收取真实付款之前,先在Bayarcash sandbox测试:
- 从sandbox商家后台获取token、secret key和portal key。正式key不能在sandbox使用。
- 开启Enable Sandbox Mode。页面会显示“Sandbox mode is enabled. Make sure to use sandbox credentials for testing.”
- 输入sandbox key,验证token,然后保存。
- 在你的表单提交一笔测试付款。
- 测试成功后,关闭Enable Sandbox Mode,输入你的正式key,然后再保存一次。
开启了Customization的表单有自己的Enable Sandbox Mode开关,也请检查它。
付款结果怎样传到你的网站
Section titled “付款结果怎样传到你的网站”你不需要把callback URL粘贴到商家后台。插件会在每笔付款中附上它自己的地址,也就是你网站上的/index.php?fluentform_payment_api_notify=1,Bayarcash会把结果发送到那里。然后插件会把提交记录标为已付款或失败。
如果付款成功后提交记录仍然是pending,请确认你的网站是公开的、使用HTTPS,而且没有防火墙或安全插件拦截那个地址。请参阅Callback和checksum。
两个好习惯,让你更顺利使用Fluent Forms:
- 每个付款表单都要有姓名和电邮栏位。Bayarcash需要顾客的姓名和电邮才能创建付款。
- 做大改动之前,先用Backup and Restore。你可以在Backup and Restore标签页导出你的Bayarcash设置,方便之后恢复。
常见问题
我的表单显示“Error! Currency not supported. The only supported currency is MYR”,怎样解决?
Bayarcash只接受MYR付款。在Fluent Forms的付款设置里,把货币设为马来西亚令吉。改好之前,Bayarcash设置页面会显示一则红色通知,说明货币不兼容。
我的表单显示“Error: Bayarcash does not support subscriptions right now.”
Bayarcash for Fluent Forms只接受一次性付款。请从表单移除订阅项目,或为它使用另一种付款方式。
Portal Key列表是空的,或显示“Please verify Personal Access Token first”。
token验证之后,列表才会出现选项。把你的token粘贴到Personal Access Token,然后点击Verify Token。如果显示“Verification failed”,请检查token是否和Enable Sandbox Mode一致:sandbox用sandbox的token,正式环境用正式环境的token。
我看到“Bayarcash for Fluent Forms requires Fluent Forms Pro to be installed and activated.”
这个插件需要Fluent Forms Pro,只有免费版Fluent Forms是不够的。请安装并启用Fluent Forms Pro,然后重新加载页面。

