把Paymattic连接到Bayarcash
Bayarcash for Paymattic把Bayarcash付款方式加入你的Paymattic Pro表单。你的顾客填写表单,在Bayarcash页面付款,然后回到你表单的确认页面。
安装之前想先看看插件怎样运作,可以试试在线演示。
支持的付款方式
Section titled “支持的付款方式”每个渠道都是一种你可以加入表单的付款方式:
| 付款方式 | 你的顾客用什么付款 |
|---|---|
| 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。
- 已安装并启用的Paymattic Pro,货币设为马来西亚令吉(MYR)。
- Bayarcash for Paymattic插件的zip文件。它不在WordPress.org上:请从Bayarcash下载zip文件。
把zip文件上传到WordPress:
- 在WordPress里,前往Plugins → Add New → Upload Plugin。
- 选择zip文件,然后点击Install Now。
- 点击Activate Plugin。
输入你的key
Section titled “输入你的key”为所有表单输入一次key就可以:
- 前往Paymattic → Bayarcash Settings。页面会打开Global Configuration标签页。
- 要收取真实付款,请让Enable Sandbox Mode保持关闭。
- 把你的token粘贴到Personal Access Token,然后点击Verify Token。token有效时,会显示“Token verified successfully”。
- 把你的portal key粘贴到Portal Key。
- 把你的key粘贴到API Secret Key。
- 可选:在Miscellaneous下,更改Payment Title。默认是Bayarcash。
- 保存你的设置。
把Bayarcash加入表单
Section titled “把Bayarcash加入表单”保存key之后,把付款方式加入每个表单:
- 在Paymattic打开表单。
- 如果表单还没有姓名栏位和电邮栏位,请添加它们。Bayarcash两者都需要。
- 添加你想要的Bayarcash付款方式元素,例如FPX Online Banking和DuitNow QR。每个表单的每种付款方式只能添加一次。
- 可选:更改每种付款方式的Payment Option Label。默认是“Pay with”加上付款方式名称。
- 保存表单。
在一个表单使用不同的key
Section titled “在一个表单使用不同的key”一个表单可以使用自己的Bayarcash账号或portal,而不是全局设置:
- 在Paymattic → Bayarcash Settings,打开Form Configuration,然后选择表单。
- 开启Customization。
- 为这个表单输入Personal Access Token、Portal Key和API Secret Key。
- 保存你的设置。
在Bayarcash Gateway Fee标签页,你可以在顾客支付的金额上加一笔手续费。你可以为FPX Online Banking、Credit Card、DuitNow Online Banking和DuitNow QR设置手续费,方式可以是固定金额、百分比或两者都用,并加上一段顾客会看到的说明。其他渠道使用DuitNow QR的手续费。
在sandbox测试
Section titled “在sandbox测试”收取真实付款之前,先在Bayarcash sandbox测试:
- 从sandbox商家后台(merchant dashboard)获取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粘贴到商家后台。插件会在每笔付款中附上它自己的地址:Bayarcash会把结果报告到你网站上的/index.php?wpf_payment_api_notify=1,而顾客会回到你表单的确认页面。插件会把付款标为已付款或失败。仍是pending的付款会保持pending。
交付任何高价值的东西之前,一定要先在商家后台确认付款。请参阅交易。
如果付款成功后付款记录仍然是pending,请确认你的网站是公开的、使用HTTPS,而且没有防火墙或安全插件拦截那个地址。
两个好习惯,让你更顺利使用Paymattic:
- 做大改动之前,先用Backup and Restore。你可以在Backup and Restore标签页导出你的Bayarcash设置,方便之后恢复。
- 需要独立报告的表单,各自使用不同的portal。每个表单使用自己的portal,可以在Bayarcash报告里把这些付款分开。
常见问题
我的表单显示“Currency not supported. Only MYR is supported.”,怎样解决?
Bayarcash只接受MYR付款。在Paymattic的付款设置里,把货币设为马来西亚令吉。改好之前,Bayarcash设置页面会显示一则红色通知,说明货币不兼容。
我的表单显示“Bayarcash doesn't support subscriptions at this time”。
Bayarcash for Paymattic只接受一次性付款。请从表单移除订阅项目,或为它使用另一种付款方式。
Verify Token显示“Verification failed”或“Invalid token or API response”。
token不正确,或者它来自另一个环境。Enable Sandbox Mode开启时,请用sandbox商家后台的token。关闭时,请用正式环境商家后台的token。请参阅找到你的API key。
我看到“Bayarcash for Paymattic requires Paymattic to be installed and activated.”
请先安装并启用Paymattic Pro,然后重新加载页面。

