# 把Easy Digital Downloads连接到Bayarcash

> 安装Bayarcash for Easy Digital Downloads，输入你的key，并选择买家在结账时看到的Bayarcash付款方式。
>
> Source: https://docs.bayarcash.com/zh/easy-digital-downloads/

**Bayarcash for Easy Digital Downloads**把Bayarcash加入你的EDD结账页面。买家选择付款方式，在Bayarcash页面付款，然后回到你的购买确认页面。

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

## 支持的付款方式

你可以选择买家在结账时看到哪些付款方式。**Payment Methods**里的选项如下：

| 付款方式 | 买家用什么付款 |
|---|---|
| **FPX Online Banking** | FPX网上银行 |
| **FPX Line of Credit** | 通过FPX使用信用卡账户 |
| **DuitNow Online Banking/Wallets** | DuitNow网上银行或电子钱包 |
| **DuitNow QR** | 任何支持DuitNow QR的银行App或电子钱包App |
| **Credit Card** | Visa或Mastercard |
| **Touch n Go** | Touch 'n Go eWallet |
| **Boost Wallet**和**Boost PayFlex** | Boost电子钱包，或Boost的先买后付 |
| **GrabPay**和**Grab PayLater** | GrabPay，或Grab的PayLater |
| **ShopeePay** | ShopeePay |
| **QRIS Online Banking**和**QRIS Wallet** | 印尼网上银行或电子钱包 |
| **NETS** | NETS（新加坡） |
| **Alipay**、**WeChat Pay**和**PromptPay** | Alipay、WeChat Pay或PromptPay（泰国） |

付款都是一次性的。付款方式必须同时在你的Bayarcash portal开启，才能使用。请参阅[付款渠道](/zh/payment-channels/)。

## 开始之前

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

- 已获批准的Bayarcash商家账号。
- 你的**Personal Access Token (PAT)**、**API Secret Key**和**Portal Key**。请参阅[找到你的API key](/zh/api-keys/)。
- 已安装并启用的Easy Digital Downloads，货币设为马币（MYR），并在EDD的页面设置里设好付款成功页面。

## 安装插件

这个插件在WordPress.org免费提供，名称是[Bayarcash For Easy Digital Downloads](https://wordpress.org/plugins/bayarcash-for-easy-digital-downloads/)。安装步骤：

1. 在WordPress，前往**Plugins** → **Add New**。
2. 搜索**Bayarcash for Easy Digital Downloads**，然后点击**Install**。
3. 点击**Activate**。

## 输入你的key

插件里key的名称和商家后台（merchant dashboard）稍有不同：**Token**就是你的Personal Access Token（PAT），**Secret Key**就是你的API Secret Key。

1. 前往**Downloads** → **Settings** → **Payments**，然后打开**Bayarcash**部分。
   
2. 把你的Personal Access Token粘贴到**Token**。插件会检查它，并显示“PAT Token is valid”。你也可以点击**Verify Token**。
3. 把你的API Secret Key粘贴到**Secret Key**。
4. 在**Portal Key**选择你的portal。token有效后，列表才会出现选项。
5. 在**Payment Methods**，勾选买家可以选择的付款方式。
6. 保存。

## 开启支付网关

只填好key，结账时还不会显示Bayarcash。你也要在EDD开启它：

1. 在**Downloads** → **Settings** → **Payments**，打开EDD的支付网关列表。
2. 勾选**Bayarcash**。
3. 保存。

买家在结账时会看到**Pay with Bayarcash**，下面列出你勾选的付款方式。

## 在sandbox测试

插件跟随EDD的测试模式，并换上它自己的测试key：

- **Test mode on**：付款会转到Bayarcash sandbox，使用插件内置的测试key。你输入的key不会被使用。
- **Test mode off**：付款会转到Bayarcash，使用你自己的key。

开启EDD的测试模式，购买一件产品，然后在sandbox页面付款。测试成功后，关闭测试模式，再做一笔小额真实付款，检查你自己的key。

## 付款结果怎样传到你的商店

你不需要把callback URL粘贴到商家后台。买家付款后，会回到你的EDD付款成功页面。插件随后每分钟向Bayarcash查询付款结果并更新订单，每次状态改变都会添加一条订单备注。

这个查询靠WP-Cron运行，所以你的网站必须是公开的，而且WP-Cron必须在运行。请参阅[Callback和checksum](/zh/callbacks-and-checksum/)。

## 小贴士

使用Easy Digital Downloads时，这两个习惯对你有帮助：

- **一定要用你的正式key测试一次**。测试模式使用插件自己的key，所以不能证明你的key是正确的。
- **设置期间开启Debug Mode**。它会把`[Bayarcash]`记录写入EDD日志，清楚显示付款失败的原因。

## 常见问题

### WordPress显示“Bayarcash gateway is active but not fully configured.”，少了什么？

Token、Secret Key或Portal Key其中一个是空的。在EDD付款设置的Bayarcash部分填好这三项，然后保存。请参阅找到你的API key (/zh/api-keys/)。

### 买家在结账时看到“No payment methods available.”，为什么？

Payment Methods里没有勾选任何方框。至少勾选一种付款方式，然后保存。

### 买家看到“Payment error:”，后面跟着Bayarcash的信息，为什么？

Bayarcash拒绝了这个付款request。常见原因是key错误，或付款方式没有为你的portal开启。开启Debug Mode，再试一次，然后查看EDD日志里的[Bayarcash]记录。请参阅为什么我的付款失败？ (/zh/payment-failed/)。

### 买家已经付款，但订单还是待处理，为什么？

插件通过WP-Cron每分钟向Bayarcash查询，以确认付款。如果你的网站流量很少，或WP-Cron已关闭，请设置一个真正的cron job，让查询准时运行。