> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 智能字段 API 密钥

在 Localpayment Business Portal 中生成和管理智能字段 API 密钥的分步指南。

智能字段提供了一种安全的方式，可直接在您的网站上收集敏感的支付信息。要[集成它们](https://docs.localpayment.com/zh/docs/smart-fields-overview.md)，您首先需要生成一个唯一的 API 密钥。此密钥用于验证您的请求，并将令牌化的支付数据与您的账户关联。

## 先决条件

开始之前，请确保您已准备好：

**访问要求**

* [Localpayment Business Portal](https://ui.v3.localpayment.com/login)的有效凭证
* 具有[安全设置权限](https://docs.localpayment.com/zh/docs/user-roles-and-permissions.md)的用户帐户

***

## 导航路径

```
Side Menu → PayIn → Checkout → Smart Fields Api Keys
```

***

## 分步指南

1. 从侧边菜单导航至 **支付** 模块。
2. 选择 **结账** 部分。
3. 然后，选择 **智能字段 API 密钥** 部分。
4. 点击 **添加 API 密钥** 按钮。
5. 请填写所需的详细信息：
   * **标题**：为此密钥输入一个描述性名称（例如，“生产环境网站”“John 的测试商店”）。这有助于您日后识别它。
   * **域名**：输入将使用此 API 密钥的域名（例如 myshop.com）。出于安全考虑，该密钥仅在指定域名上有效。
6. 点击“接受”按钮以生成 API 密钥。
7. 您的新 API 密钥现在将显示在 **智能字段 API 密钥** 列表中。它是一长串随机字符。请复制此密钥，并将其安全地存储在应用程序的环境变量或配置文件中。

> [!NOTE]
>
> 现在您已经拥有密钥，可以开始使用 SmartFields 进行构建了。有关实施详情，请参阅[嵌入式 Iframe](https://docs.localpayment.com/zh/docs/smart-fields-overview.md)

从商业门户侧边菜单导航至 **支付** 模块。

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/00afb1a4fbd538c77f4b363db438059b7dd1702b75a7e58cb97bf8131c841f05-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=0847efb5a1e70a0c23cf740e8136ef53)

选择 **结账** 部分。

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/a832f4ccd3d8b7f7cf939ca3d20130214bf175740377c630acf2077294aa6259-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=60e54c501b2ff5428350990f49f0b8d7)

然后，选择 **智能字段 API 密钥** 部分。

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/36a0e229de597e3223ea3388d54266901e85cb7e23e47fed440150ae805760e8-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=9382760cc80a69378cf5e1e57dfbf49f)

点击 **添加 API 密钥** 按钮。

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/a4f33d8e3bb6a072cda9387043a74208961210c3781bff3dc51a2b41a5524bd4-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=00ab8eb87e7bd54cc0748598f686172f)

请填写所需的详细信息。

![](https://mintcdn.com/localpayment-1fee3d41/x0nXcqwNUmbD9R8W/images/docs/532aa0a8f8c408a49013e947535c0b8610e60ffd6b1e0923e1b499e33b827451-image.png?fit=max\&auto=format\&n=x0nXcqwNUmbD9R8W\&q=85\&s=f0c1160222d01793e51a9666cb332c69)

点击 **接受** 按钮以生成 API 密钥。

![](https://mintcdn.com/localpayment-1fee3d41/thasGykLOKju8tM0/images/docs/2f8ea403b5c222d949a3732372ecd9f1c6a2ac382d8043318ee7deaace9495af-image.png?fit=max\&auto=format\&n=thasGykLOKju8tM0\&q=85\&s=b90c7fe513f43b6e26b566dd5373bba3)

您的新 API 密钥现在将显示在 **智能字段 API 密钥** 列表中。它是一长串随机字符。

![](https://mintcdn.com/localpayment-1fee3d41/R2R5JIQRe6pRQ97b/images/docs/b97f37539ec67974923e28616447964ac94335d2fbc2337a89d7f10d6e17ad5a-image.png?fit=max\&auto=format\&n=R2R5JIQRe6pRQ97b\&q=85\&s=1cacf0fc44942f76cab1ae84b773ae31)

***

## 管理您的 Iframe 密钥

### 查看现有密钥

导航至 Iframe 密钥部分，查看您已创建的所有密钥的完整列表，其中包括：

* 密钥标题和创建日期
* 关联域名
* 状态（活跃/非活跃）
* 公钥

### 移除 Iframe 密钥

1. 在密钥列表中找到要删除的密钥。
2. 点击密钥旁边的 **删除** 图标。
3. 请仔细阅读确认信息；此操作无法撤销。
4. 点击 **确定** 永久删除该密钥。

> [!WARNING]
>
> **警告**
>
> 删除密钥将立即禁用所有使用该密钥的集成。请确保在删除之前已更新您的实现。

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/fb08e020da5d8ad4f8b4ebe4f76bc29a80d78078eb94a1ac5d79cc37d65ad7fe-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=101896150c331f99d388a47f247e045a)

### 停用/启用 Iframe 密钥

1. 在密钥列表中找到您要停用或启用的密钥。
2. 点击密钥旁边的 **停用/启用** 切换图标。
3. 请仔细阅读确认信息。
4. 点击 **确定** 更改密钥状态。

> [!NOTE]
>
> **提示**
>
> 停用密钥会暂时禁用它而不会将其删除，适用于维护或故障排除。

![](https://mintcdn.com/localpayment-1fee3d41/oFZuSE0fcOk5ECyA/images/docs/dd62748a02547be548eb3e6ed3a3ffa67cf92ab2a7c5f35bcddd64db31dc592c-image.png?fit=max\&auto=format\&n=oFZuSE0fcOk5ECyA\&q=85\&s=1375fb60c8209082012ed38bdabb2d5d)

***

> **需要帮助？** 如果您对本流程或其他任何功能有任何疑问，我们的[支持团队](mailto:support@localpayment.com)随时为您提供帮助。我们可以协助您进行故障排除、集成规划和优化。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.