# 把Paymattic连接到Bayarcash

> 安装Bayarcash for Paymattic，输入你的key，并把Bayarcash付款方式加入你的Paymattic Pro表单。
>
> Source: https://docs.bayarcash.com/zh/paymattic/

**Bayarcash for Paymattic**把Bayarcash付款方式加入你的Paymattic Pro表单。你的顾客填写表单，在Bayarcash页面付款，然后回到你表单的确认页面。

安装之前想先看看插件怎样运作，可以试试[在线演示](https://form.bayarcash-demo.com/paymattic/)。

## 支持的付款方式

每个渠道都是一种你可以加入表单的付款方式：

| 付款方式 | 你的顾客用什么付款 |
|---|---|
| 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开启，才能使用。请参阅[付款渠道](/zh/payment-channels/)。

## 开始之前

设置插件之前，你需要准备好这些：

- 一个已获批准的Bayarcash商家账号。
- 你的**Personal Access Token (PAT)**、**API Secret Key**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)。
- 已安装并启用的Paymattic Pro，货币设为马来西亚令吉（MYR）。
- Bayarcash for Paymattic插件的zip文件。它不在WordPress.org上：请从Bayarcash[下载zip文件](https://bayarcash.com/wp-content/uploads/sites/2/2025/02/bayarcash-for-paymattic.zip)。

## 安装插件

把zip文件上传到WordPress：

1. 在WordPress里，前往**Plugins** → **Add New** → **Upload Plugin**。
2. 选择zip文件，然后点击**Install Now**。
3. 点击**Activate Plugin**。

## 输入你的key

为所有表单输入一次key就可以：

1. 前往**Paymattic** → **Bayarcash Settings**。页面会打开**Global Configuration**标签页。
   
2. 要收取真实付款，请让**Enable Sandbox Mode**保持关闭。
3. 把你的token粘贴到**Personal Access Token**，然后点击**Verify Token**。token有效时，会显示“Token verified successfully”。
4. 把你的portal key粘贴到**Portal Key**。
5. 把你的key粘贴到**API Secret Key**。
6. 可选：在**Miscellaneous**下，更改**Payment Title**。默认是**Bayarcash**。
7. 保存你的设置。

## 把Bayarcash加入表单

保存key之后，把付款方式加入每个表单：

1. 在Paymattic打开表单。
2. 如果表单还没有姓名栏位和电邮栏位，请添加它们。Bayarcash两者都需要。
3. 添加你想要的Bayarcash付款方式元素，例如**FPX Online Banking**和**DuitNow QR**。每个表单的每种付款方式只能添加一次。
4. 可选：更改每种付款方式的**Payment Option Label**。默认是“Pay with”加上付款方式名称。
5. 保存表单。

## 在一个表单使用不同的key

一个表单可以使用自己的Bayarcash账号或portal，而不是全局设置：

1. 在**Paymattic** → **Bayarcash Settings**，打开**Form Configuration**，然后选择表单。
2. 开启**Customization**。
3. 为这个表单输入**Personal Access Token**、**Portal Key**和**API Secret Key**。
4. 保存你的设置。

## 添加手续费

在**Bayarcash Gateway Fee**标签页，你可以在顾客支付的金额上加一笔手续费。你可以为**FPX Online Banking**、**Credit Card**、**DuitNow Online Banking**和**DuitNow QR**设置手续费，方式可以是固定金额、百分比或两者都用，并加上一段顾客会看到的说明。其他渠道使用**DuitNow QR**的手续费。

## 在sandbox测试

收取真实付款之前，先在Bayarcash sandbox测试：

1. 从[sandbox商家后台（merchant dashboard）](https://console.bayarcash-sandbox.com)获取token、secret key和portal key。正式key不能在sandbox使用。
2. 开启**Enable Sandbox Mode**。页面会显示“Sandbox mode is enabled. Make sure to use sandbox credentials for testing.”
3. 输入sandbox key，验证token，然后保存。
4. 在你的表单提交一笔测试付款。
5. 测试成功后，关闭**Enable Sandbox Mode**，输入你的正式key，然后再保存一次。

开启了**Customization**的表单有自己的**Enable Sandbox Mode**开关，也请检查它。

## 付款结果怎样传到你的网站

你不需要把callback URL粘贴到商家后台。插件会在每笔付款中附上它自己的地址：Bayarcash会把结果报告到你网站上的`/index.php?wpf_payment_api_notify=1`，而顾客会回到你表单的确认页面。插件会把付款标为已付款或失败。仍是pending的付款会保持pending。

交付任何高价值的东西之前，一定要先在商家后台确认付款。请参阅[交易](/zh/transactions/)。

如果付款成功后付款记录仍然是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 (/zh/api-keys/)。

### 我看到“Bayarcash for Paymattic requires Paymattic to be installed and activated.”

请先安装并启用Paymattic Pro，然后重新加载页面。