# 找到你的Bayarcash API key、PAT和portal key

> 在商家后台找到Personal Access Token（PAT）、API Secret Key和Portal Key，了解每个key的用途和安全保管方法。
>
> Source: https://docs.bayarcash.com/zh/api-keys/

要把网站、网店插件或App连接到Bayarcash，你需要从商家后台（merchant dashboard）取得三样东西：Personal Access Token（PAT）、API Secret Key和Portal Key。

> **Caution**
> 绝对不要分享这些key，也不要把它们放进截图、聊天信息或公开页面。任何人拿到它们，都可以操作你的Bayarcash账号。如果你向别人分享屏幕求助，请先把key遮住。

## 每个key的用途

插件和SDK会按名称要求这些key：

| Key | 用途 | 在哪里找 |
|---|---|---|
| Personal Access Token（PAT） | 向Bayarcash表明你的request来自你 | **Profile** → **Integration** |
| API Secret Key | 为你的request签名，并检查回复（checksum） | **Profile** → **Integration** |
| Portal Key | 指定由哪个portal收款 | **Portals** |

## 取得你的PAT和API Secret Key

先登录[商家后台](/zh/sign-in/)。然后：

1. 在商家后台右上方，点击**Profile**。
2. 点击**Integration**。
3. 复制你的Personal Access Token（PAT）和API Secret Key。

*(Screenshot: Integration页面，已标示Personal Access Token（PAT）和API Secret Key框，数值已隐藏)*

## 取得你的Portal Key

每个portal都有自己的key。复制步骤：

1. 在商家后台左上方，点击**Portals**。
2. 选择你要使用的portal。
3. 复制它的Portal Key。

*(Screenshot: Portal Details窗口，已标示Portal Key那一行，数值已隐藏)*

需要先创建新的portal？请看[创建和使用portal](/zh/portals/)。

## Sandbox和正式环境的key

sandbox商家后台[console.bayarcash-sandbox.com](https://console.bayarcash-sandbox.com)会另外发出专门用来测试的key。sandbox的key只在测试时使用，正式环境（production）的key只用于真实付款。

API详情请看[Bayarcash API参考文档](https://api-reference.bayarcash.com)。

## 常见问题

### 为什么我的插件说token或key无效？

sandbox和正式环境的key不一样。sandbox商家后台的key不能在正式商家后台使用，反过来也一样。三个key都要从你要连接的同一个商家后台复制。

### 哪个key填在哪里？

Personal Access Token（PAT）向Bayarcash表明你的身份。Portal Key指定由哪个portal收款。API Secret Key用于checksum。插件和SDK会按名称要求每一个key。

### 我不小心把key分享出去了，怎么办？

请马上通过页面底部的Need more help?框联系Bayarcash。不要再次发出这个key，即使是为了求助也不要。