把GiveWP连接到Bayarcash
Bayarcash GiveWP插件把Bayarcash加入你的GiveWP捐款表单。捐款人可以通过FPX、DuitNow和其他渠道捐一次,也可以通过Direct Debit每周或每月捐款。
定期捐款需要Recurring Donations for GiveWP附加服务(add-on)。之后,Bayarcash会自动从捐款人的银行账户扣除每一笔捐款,并收取固定手续费。请参阅用Direct Debit定期捐款。
安装之前想先看看插件怎样运作,可以试试在线演示。
每个Bayarcash渠道都是一个独立的GiveWP支付网关。你想开启多少个都可以:
| GiveWP里的支付网关 | 捐款人用什么付款 |
|---|---|
| Online Banking | FPX网上银行。也用来运行Direct Debit定期捐款。 |
| Online Banking (DuitNow) | DuitNow Online Banking/Wallets |
| Credit Card | FPX Line of Credit:通过FPX使用信用卡账户,不是刷卡付款。请参阅FPX Line of Credit |
| DuitNow QR | 任何支持DuitNow QR的银行或电子钱包App |
| Boost PayFlex | Boost PayFlex |
| Indonesia Online Banking | 印尼网上银行(QRIS) |
| Indonesia e-Wallet | 印尼电子钱包(QRIS) |
| NETS | NETS(新加坡) |
| Alipay | Alipay |
| WeChat Pay | WeChat Pay |
| PromptPay | PromptPay(泰国) |
一个渠道必须同时在你的Bayarcash portal开启,才能使用。请参阅付款渠道。
设置插件之前,你需要准备好这些:
- 一个已获批准的Bayarcash商家账号。
- 你的Personal Access Token (PAT)、API Secret Key和Portal Key。请参阅找到你的API key。
- 已安装并启用的GiveWP,货币设为马来西亚令吉(MYR)。
- 如果要收定期捐款,需要GiveWP Recurring Donations附加服务。
这个插件在WordPress.org免费提供,名称是Bayarcash GiveWP。安装步骤:
- 在WordPress里,前往Plugins → Add New。
- 搜索Bayarcash GiveWP,然后点击Install。
- 点击Activate。
输入你的key
Section titled “输入你的key”Bayarcash设置页面为每个渠道提供一个标签页,每个标签页保存自己的key。为每个你想使用的渠道填写它的标签页:
- 前往Donations → Settings → Payment Gateways,然后打开Bayarcash部分。
- 点击渠道的标签页,例如Online Banking。
- 把你的token粘贴到Personal Access Token (PAT),然后点击Verify Token。token有效时,会显示“PAT Token is valid”。
- 在Portal Key选择你的portal。token验证有效后,列表才会出现选项。
- 把你的key粘贴到API Secret Key。
- 可选:把Billing Fields设为Enabled,让捐款人填写账单资料;把Enable Phone field设为Enabled,在一次性捐款时要求填写电话号码。
- 点击Save changes。
开启支付网关
Section titled “开启支付网关”只输入key,Bayarcash还不会出现在你的表单上。你也需要在GiveWP开启每个支付网关:
- 在Donations → Settings → Payment Gateways,打开GiveWP的支付网关列表。
- 勾选每个你设置好的Bayarcash支付网关,例如Online Banking和DuitNow QR。
- 可选:更改捐款人看到的名称,例如改成“Online Banking (FPX)”。
- 保存。
在一个表单使用不同的key
Section titled “在一个表单使用不同的key”每个捐款表单都可以使用自己的Bayarcash账号或portal。如果你想分开查看每个筹款活动的款项报告,这会很有用。在表单编辑器里,打开Bayarcash渠道的标签页,然后选择一个选项:
| 选项 | 什么时候使用 |
|---|---|
| Global Option | 使用Bayarcash设置页面里的key。 |
| Customize | 为这个表单另外输入Personal Access Token (PAT)、Portal Key和API Secret Key。 |
| Disable | 在这个表单上隐藏这个渠道。 |
在sandbox测试
Section titled “在sandbox测试”插件跟随GiveWP的测试模式。测试模式开启时,每一笔Bayarcash付款都会进入Bayarcash sandbox,并使用你输入的key:
- 从sandbox商家后台(merchant dashboard)获取token、secret key和portal key。正式key不能在sandbox使用。
- 开启GiveWP的测试模式。
- 在Bayarcash设置页面输入sandbox key,然后保存。
- 进行一笔测试捐款。
- 测试成功后,关闭测试模式,输入你的正式key,然后再保存一次。
付款结果怎样传到你的网站
Section titled “付款结果怎样传到你的网站”你不需要把callback URL粘贴到商家后台。插件会在每笔捐款中附上它自己的地址,也就是你网站上的/give-api/bayarcash_gateway/,Bayarcash会把结果发送到那里。插件也会每5分钟重新检查一次待处理的捐款。
如果付款成功后捐款仍然是pending,请确认你的网站是公开的、使用HTTPS,而且没有防火墙或安全插件拦截那个地址。请参阅Callback和checksum。
用Direct Debit定期捐款
Section titled “用Direct Debit定期捐款”有了GiveWP Recurring Donations附加服务,捐款人可以通过Direct Debit每周或每月捐款。捐款人只需签一次e-Mandate,Bayarcash就会从他们的银行账户扣除每一笔捐款。
要收取定期捐款:
- 安装并启用GiveWP Recurring Donations。
- 按照上面的步骤设置Online Banking支付网关。
- 把表单设为定期捐款,周期选每周或每月。
在定期捐款表单上,捐款人填写Phone Number、Identification Type和Identification Number,然后在银行批准e-Mandate。他们的银行账户会被扣除一笔小额、不可退还的验证金额,收据上也会注明。请参阅Direct Debit何时扣款和e-Mandate。
两个好习惯,让捐款更顺利:
- 每个筹款活动使用不同的portal。每个表单使用自己的portal,可以在Bayarcash报告里把每个筹款活动的捐款分开。
- 定期捐款表单上的捐款人电邮要短。Direct Debit只接受最多27个字符的电邮,太长的地址会让捐款无法完成。
常见问题
Verify Token显示“Invalid PAT Token”,是什么问题?
token不正确,或者它来自另一个环境。GiveWP的测试模式开启时,请用sandbox商家后台的token。测试模式关闭时,请用正式环境商家后台的token。请参阅找到你的API key。
捐款人看到“Email length reaches a limit of 27 characters.”,这是什么意思?
用Direct Debit定期捐款时,捐款人的电邮最多只能有27个字符。一次性捐款的上限是50个字符。请捐款人使用较短的电邮地址。
捐款人看到“Please tick the create account button if you want to create a subscription donation”。
定期捐款需要捐款人账号。捐款人应在捐款表单上勾选创建账号的选项,然后再试一次。
我的定期捐款表单上只有Online Banking选项,其他渠道去哪里了?
定期捐款通过Direct Debit收取,而Direct Debit是通过Online Banking支付网关运行的。其他Bayarcash渠道在定期捐款表单上会被隐藏,只用于一次性捐款。

