ChatGPT
Claude
Perplexity
Google AI Mode
Microsoft Copilot
Grok
Mistral Le Chat在WHMCS接受Bayarcash付款
WHMCS的Bayarcash模块让你的客户通过Bayarcash支付发票。它只接受MYR发票。这份指南介绍支付网关、cron job，以及可选的手续费add-on。
你需要准备好：
- 已获批准的Bayarcash商家账号，并已开启你要用的付款渠道。
- 你的Personal Access Token (PAT)、Portal Key和API Secret Key。请参阅找到你的API key和Portal。
- WHMCS的管理员权限，以及服务器文件或cron设置的访问权限。
从WHMCS Marketplace下载模块。然后：
- 解压文件。确认里面有modules文件夹，文件夹里有addons和gateways。
- 把modules文件夹上传到你的WHMCS安装文件夹，让文件和原有的文件合并。
- 在WHMCS管理后台，前往System Settings → Payment Gateways。
- 打开All Payment Gateways标签页，找到Bayarcash并启用它。
添加key并选择渠道
Section titled “添加key并选择渠道”在Bayarcash设置里，填写这些栏位：
| 栏位 | 填写什么 |
|---|---|
| Personal Access Token (PAT) | 你的Bayarcash token。 |
| Portal Key | 接收这些付款的portal。 |
| API Secret Key | 你的secret key。不要告诉别人。 |
| Sandbox Mode | 只在测试时开启，并使用sandbox key。 |
| Payment Information | 显示在发票页面的文字。 |
| Successful Payment和Unsuccessful Payment | 客户付款成功或失败后去到的页面：Specific Invoice、List Invoice或Client Area。 |
| Payment Channels | 要提供的渠道号码，用逗号分开。 |
完成后点击Save Changes。渠道号码如下：
| 号码 | 渠道 |
|---|---|
| 1 | FPX Online Banking |
| 4 | FPX Line of Credit (Credit Card Account) |
| 5 | DuitNow Online Banking/Wallets |
| 6 | DuitNow QR |
| 7 | SPayLater |
| 8 | Boost PayFlex |
| 9 | QRIS Indonesia Online Banking |
| 10 | QRIS Indonesia eWallet |
| 11 | NETS Singapore |
渠道必须先在你的Bayarcash账号开启，客户才能使用。请参阅付款渠道。
设置cron job
Section titled “设置cron job”Bayarcash需要一个每分钟检查待处理付款的cron job。请你的主机商添加以下cron job，并把whmcsdomain换成你的WHMCS域名：
* * * * * wget -q -O /dev/null 'https://whmcsdomain/modules/gateways/bayarcash/bayarcash_cron.php?job=requery'把手续费加到发票上（可选）
Section titled “把手续费加到发票上（可选）”如果你想让客户承担付款手续费，可以使用Bayarcash Gateway Fees add-on。它会按客户选择的渠道，在发票上添加一行手续费。设置步骤：
- 前往System Settings → Addon Modules。
- 找到Bayarcash Gateway Fees，点击Activate，然后点击Configure。
- 在Access Control下，勾选Full Administrator，然后保存。
- 打开Addons → Bayarcash Gateway Fees。
- 为每个渠道设置Flat Price (RM)和Percentage Fee (%)，然后点击Save All Settings。
这个add-on一开始用的是示例数值，所以保存之前，请对照你和Bayarcash的协议检查金额。
- 先用Sandbox Mode测试。使用sandbox key，支付一张测试发票，然后换成正式key，并关闭Sandbox Mode。
- 让cron job一直运行。如果它停了，客户可能已经付款，但他们的发票会一直显示未付款，直到你去检查。
常见问题
我的客户看到信息说Bayarcash只接受MYR付款，为什么？
这张发票用的是其他货币。Bayarcash只接受MYR，所以请用马币开发票。
客户已经付款，但发票还是未付款，为什么？
检查requery cron job是否每分钟运行，以及你的Personal Access Token、Portal Key和API Secret Key是否正确。待处理的付款由这个cron job更新。
客户选择渠道后看到“An error occurred. Please try again later.”，为什么？
检查Bayarcash支付网关设置里的key。只有在使用sandbox key时，才开启Sandbox Mode。