# 在OpenCart接受Bayarcash付款

> 在OpenCart 3或4安装Bayarcash模块，添加你的key，选择付款渠道，正式上线前先测试。
>
> Source: https://docs.bayarcash.com/zh/opencart/

Bayarcash模块让你的OpenCart商店通过Bayarcash收款。模块有两个zip文件，一个给OpenCart 3，另一个给OpenCart 4。请使用和你的商店版本相符的那一个。

想在安装前先看看模块怎样运作，可以试试[在线演示](https://opencart.bayarcash-demo.com/)。

## 开始之前

你需要准备好：

- 已获批准的Bayarcash商家账号，并已开启你的付款渠道。
- 你的**Personal Access Token**、**API Secret**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)和[Portal](/zh/portals/)。
- 在你的商店设好马币（MYR）货币。

## 安装模块

从[Bayarcash插件页面](https://plugin.bayarcash.com/)下载模块的zip文件。然后：

1. 在OpenCart管理后台，前往**Extensions** → **Installer**，然后上传zip文件。
2. 前往**Extensions** → **Extensions**，然后选择**Payments**类型。
3. 在列表里找到**Bayarcash**。点击**Install**，然后点击**Edit**。

## 添加你的key

设置会在**API details**标签页打开。填写步骤：

1. 保留或更改**Payment Name**。这是顾客在结账时看到的名称。
2. 粘贴你的**Personal Access Token**、**API Secret**和**Portal Key**。
3. 收真实付款时，让**Sandbox Mode**保持关闭。只有使用sandbox key时才开启它。
4. 保存。保存时，OpenCart会检查你的token。

## 选择渠道并开启模块

接着，打开**General**标签页：

1. 在**Payment Channels**下，选择要提供的渠道。按住Ctrl或Cmd可以选多个。
2. 把**Status**设为开启。
3. 保存。

之后顾客在结账时会看到每个渠道，名称按你的**Payment Name**显示，例如“Bayarcash - Credit Card”。

## 其他设置

这些标签页是可选的：

| 标签页 | 作用 |
|---|---|
| **Order status** | 设置**Canceled Order Status**、**Failed Order Status**和**Paid Order Status**的状态。 |
| **Customize checkout** | **Instruction**在顾客付款前显示你自己的文字。 |
| **Troubleshoot** | **Debug logging**把详细资料写入OpenCart错误日志。 |

## 小贴士

- **正式上线前先测试**。用sandbox key开启**Sandbox Mode**，下一个订单，然后关闭它，改用你的正式key。
- **正式付款失败时，先检查Sandbox Mode**。收真实付款时，它必须关闭。

## 常见问题

### 结账页面显示“Bayarcash requires MYR currency to be set-up.”，为什么？

在你的商店添加马币（MYR）作为货币。Bayarcash只处理MYR。只有开启Convert To Processing，其他货币才能使用。

### 有栏位没填，所以无法保存设置，要填哪些？

Personal Access Token、API Secret、Portal Key和Payment Name都是必填。如果你开启了Instruction，Bayarcash Instructions也是必填。

### 保存设置时显示error_invalid_token或error_pat_required，这是什么？

这些是还没完成的错误信息，意思是Personal Access Token是空的，或Bayarcash不接受它。从你的商家后台（merchant dashboard）重新复制token，然后保存。

### 顾客在结账时看到“Invalid redirect.”或“Payment method is incorrect!”，怎么办？

请顾客回到结账页面，再选一次Bayarcash付款方式。如果问题一直出现，在Troubleshoot标签页开启Debug logging，并把OpenCart错误日志发给支持团队。