凭证安全
需遵守的规则:- 在AI生成的代码中,所有凭据都应使用环境变量。如果AI在示例中生成了硬编码密钥,请立即将其替换。
- 在开发和测试过程中使用人工智能时,请使用Stage 凭证。Stage API 密钥风险较低——它们无法转移真实资金。
- 如果您不慎在聊天会话中分享了生产环境 API 密钥,请立即从 Localpayment Business Portal(生产环境为
https://ui.v3.localpayment.com,Stage 环境为https://ui.stage.localpayment.com)轮换该密钥,并审核您近期的交易历史。 - 不要在提示中共享 webhook 密钥、JWT 令牌或任何身份验证材料,即使是看起来很明显的“脱敏”形式也不行。
客户和支付数据
除非您已确认提供商的数据处理条款符合您的合规义务,否则请勿与人工智能工具共享真实的支付数据。 哪些内容应该避免粘贴到人工智能聊天中:- 真实持卡人数据(卡号、CVV码、有效期)
- 真实客户个人身份信息(国民身份证号码、全名及证件数据)
- 包含实际交易金额和账号的真实 webhook 有效负载,来自生产环境
- 与真实客户关联的账号(CVU、CLABE、CCI)
- 经过清理或虚构的 webhook 有效负载(将真实值替换为
XXXX等占位符或示例值) - 缺少上下文的错误代码和状态代码
- 文档中的示例值以及 API 请求结构
先在 Stage 环境测试,再上线生产
在部署到生产环境之前,务必先在 Stage 环境中开发和测试您的 AI 辅助集成。Localpayment MCP 服务器提供文档和 API 规范,但不执行请求。所有实际的 API 调用都在您自己的代码中使用您自己的凭据进行。环境风险完全取决于您在集成中使用的凭据和基本 URL。
审查人工智能生成的代码
AI生成的代码在合并或部署前必须经过审核。在支付集成中,错误可能会造成经济损失。 审核人工智能生成的Localpayment集成代码的清单:- 没有硬编码凭据 — 所有 API 密钥均使用环境变量
- 基本 URL 正确 — 开发使用 Stage URL,部署使用生产 URL
- externalId 唯一 — 代码会为每笔交易生成唯一 ID(例如 UUID)。重复的 externalId 会导致错误
500。 - Webhook 幂等性 — webhook 处理程序在执行操作之前会检查
internalId是否已被处理 - HTTP 200 响应 — webhook 处理程序在处理完成后总是返回 200 OK,即使是对于它忽略的事件也是如此
- 仅使用 HTTPS — 所有 API 调用都使用 HTTPS,绝不使用 HTTP
- 错误处理 — 被拒绝的状态码(5xx、8xx、9xx)会被捕获并处理,而不是被默默忽略
- 敏感数据不写入日志 — API 密钥、卡数据和客户个人身份信息不会被写入日志
Localpayment可以看到哪些数据
当您使用任何 Localpayment AI 工具(MCP 服务器、代理系统提示或本文档)时,务必了解 Localpayment 可以访问哪些内容以及不能访问哪些内容:
Localpayment MCP 服务器是一个只读的公开文档服务器。它无法访问您的 Localpayment 商户账户、交易或您存储在 Localpayment 的任何数据。它只提供与
https://docs.localpayment.com 上公开提供的相同文档。
AI 工具数据政策
了解您的 AI 提供商如何处理您共享的数据是负责任使用的一部分。快速参考
后续步骤
API密钥和环境
管理您的 Stage 和生产凭据,并了解各环境之间的差异。
接收付款通知
为Localpayment事件实现安全、幂等的 webhook 处理。

