跳到内容

热门搜索

查看页面以Markdown格式查看

向AI询问本页内容

ChatGPTClaudePerplexityGoogle AI ModeMicrosoft CopilotGrokMistral Le Chat

把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。安装步骤:

  1. 在WordPress里,前往Plugins → Add New。
  2. 搜索Bayarcash GiveWP,然后点击Install。
  3. 点击Activate。

Bayarcash设置页面为每个渠道提供一个标签页,每个标签页保存自己的key。为每个你想使用的渠道填写它的标签页:

  1. 前往Donations → Settings → Payment Gateways,然后打开Bayarcash部分。
  2. 点击渠道的标签页,例如Online Banking。
  3. 把你的token粘贴到Personal Access Token (PAT),然后点击Verify Token。token有效时,会显示“PAT Token is valid”。
  4. 在Portal Key选择你的portal。token验证有效后,列表才会出现选项。
  5. 把你的key粘贴到API Secret Key。
  6. 可选:把Billing Fields设为Enabled,让捐款人填写账单资料;把Enable Phone field设为Enabled,在一次性捐款时要求填写电话号码。
  7. 点击Save changes。

只输入key,Bayarcash还不会出现在你的表单上。你也需要在GiveWP开启每个支付网关:

  1. 在Donations → Settings → Payment Gateways,打开GiveWP的支付网关列表。
  2. 勾选每个你设置好的Bayarcash支付网关,例如Online Banking和DuitNow QR。
  3. 可选:更改捐款人看到的名称,例如改成“Online Banking (FPX)”。
  4. 保存。

每个捐款表单都可以使用自己的Bayarcash账号或portal。如果你想分开查看每个筹款活动的款项报告,这会很有用。在表单编辑器里,打开Bayarcash渠道的标签页,然后选择一个选项:

选项 什么时候使用
Global Option 使用Bayarcash设置页面里的key。
Customize 为这个表单另外输入Personal Access Token (PAT)、Portal Key和API Secret Key。
Disable 在这个表单上隐藏这个渠道。

插件跟随GiveWP的测试模式。测试模式开启时,每一笔Bayarcash付款都会进入Bayarcash sandbox,并使用你输入的key:

  1. 从sandbox商家后台(merchant dashboard)获取token、secret key和portal key。正式key不能在sandbox使用。
  2. 开启GiveWP的测试模式。
  3. 在Bayarcash设置页面输入sandbox key,然后保存。
  4. 进行一笔测试捐款。
  5. 测试成功后,关闭测试模式,输入你的正式key,然后再保存一次。

你不需要把callback URL粘贴到商家后台。插件会在每笔捐款中附上它自己的地址,也就是你网站上的/give-api/bayarcash_gateway/,Bayarcash会把结果发送到那里。插件也会每5分钟重新检查一次待处理的捐款。

如果付款成功后捐款仍然是pending,请确认你的网站是公开的、使用HTTPS,而且没有防火墙或安全插件拦截那个地址。请参阅Callback和checksum。

有了GiveWP Recurring Donations附加服务,捐款人可以通过Direct Debit每周或每月捐款。捐款人只需签一次e-Mandate,Bayarcash就会从他们的银行账户扣除每一笔捐款。

要收取定期捐款:

  1. 安装并启用GiveWP Recurring Donations。
  2. 按照上面的步骤设置Online Banking支付网关。
  3. 把表单设为定期捐款,周期选每周或每月。

在定期捐款表单上,捐款人填写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渠道在定期捐款表单上会被隐藏,只用于一次性捐款。

这篇文章对你有帮助吗?

Cookie settings

We use Google Analytics to see which guides help and where readers get stuck. It is on by default, and you can turn it off. This device keeps your choice.