# 在HostBill接受Bayarcash付款

> 在HostBill安装Bayarcash付款模块，然后添加你的portal key、token和API secret key。
>
> Source: https://docs.bayarcash.com/zh/hostbill/

HostBill的Bayarcash模块让你的客户通过Bayarcash支付发票。它只接受MYR。

## 开始之前

你需要准备好：

- 已获批准的Bayarcash商家账号。
- Bayarcash提供的HostBill模块文件。
- 你的**Portal Key**、**Personal Access Token**和**API Secret Key**。请参阅[找到你的API key](/zh/api-keys/)和[Portal](/zh/portals/)。
- HostBill服务器文件的访问权限，而且服务器上可以使用Composer。

## 安装模块

这部分通常由你的开发者或主机商来做。步骤如下：

1. 把模块文件夹复制到你的HostBill安装文件夹，放在**includes/modules/Payment**文件夹下。
2. 在模块文件夹里运行`composer install`，添加模块需要的库。
3. 在HostBill管理后台，在付款模块中启用**Bayarcash**。

## 添加你的key

打开Bayarcash模块设置，填写这些栏位：

| 栏位 | 填写什么 |
|---|---|
| **Portal Key** | 接收这些付款的portal。 |
| **Token** | 你的Personal Access Token。 |
| **API Secret Key** | 你的secret key。不要告诉别人。 |
| **Use sandbox** | 只在用sandbox key测试时勾选。 |

保存设置。在付款页面，客户可以选择**FPX**、**FPX Line of Credit**或**DuitNow DOBW**。

## 小贴士

- **先在sandbox测试**。用sandbox key支付一张测试发票，然后取消勾选**Use sandbox**，换成正式key。
- **在你自己的HostBill版本检查模块**。Bayarcash没有列出最低的HostBill版本要求，所以正式上线前请先测试一笔付款。

## 常见问题

### 我的客户看到“Payment failed, please contact administrator”，为什么？

检查模块设置里的Portal Key、Token和API Secret Key，并确认你的发票用的是MYR。Bayarcash只接受MYR。

### 付款成功了，但我看到“Payment callback response verification failed”，为什么？

HostBill里的API Secret Key和你商家后台（merchant dashboard）里的不一样。重新复制它，然后保存。