> ## 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.

# 嵌入式 iFrame

将白标结账页面无缝集成到您的网站中。嵌入式 iFrame 提供 Localpayment 安全的支付处理能力，同时保留您的品牌形象。

嵌入式 iFrame 选项可让您将 Localpayment 安全的结账体验直接无缝集成到您的网站或应用程序中。该解决方案提供完整的支付处理界面，同时保持您品牌的外观和风格。

## 主要优势

> [card] 灵活且品牌安全的集成
>
> 通过可自定义的 iframe 保持品牌一致性，iframe 可无缝嵌入您的结账流程。避免页面跳转，确保流畅的用户旅程，且不影响用户体验

> [card] 快速实施
>
> 无需构建或维护复杂的前端基础设施，即可部署本地和国际支付方式。我们的 iframe 让您在几分钟内即可上线，加快拓展进度并减少对工程团队的依赖。

> [card] 更低的维护成本
>
> 由于 iframe 由 Localpayment 托管和维护，您可以持续获得更新，且不会对您的部署产生任何影响。

> [card] 简化合规与风险管理
>
> 将敏感支付数据保留在您的服务器之外，缩小您的 PCI 范围。借助 iframe，商户可将安全责任和合规责任转移给 Localpayment。

***

## 用例

嵌入式 iFrame 解决方案几乎适用于任何支付场景。以下是最常见的实施方式：

* **电子商务与零售：** 无需自定义支付表单即可处理线上购买。
* **服务行业：** 收取专业服务和咨询的费用。
* **活动与娱乐：** 音乐会场馆销售活动门票。
* **非营利与社区：** 慈善机构在线收取捐款。

***

## 集成流程

> [accordion] 步骤 1：生成 iframe 密钥
>
> **您需要做的：** 在您的 Localpayment Business Portal 中创建用于验证您的集成的 iframe 密钥。
>
> **重要提示：** 请将您的私钥安全地存储在您的服务器上，切勿在客户端代码中暴露。您的公钥可以安全地用于前端应用程序。
>
> **资源：** 请按照我们详细的 [iframe 密钥教程](https://docs.localpayment.com/zh/docs/dashboard-iframe-keys.md)获取分步说明。

> [accordion] 步骤 2：创建支付会话
>
> **发生了什么：** 通过向我们的 API endpoint 发起服务器端请求，生成安全的会话令牌。
>
> **endpoint：** `POST https://api.stage.localpayment.com/bff/webcheckout/createsession`
>
> **必需参数：**
>
> * `bodyMessage` - 您的支付请求数据（格式与 Payin API 相同）
> * `signature` - 您的消息正文的 RSA 签名
> * `publicKey` - 您的 iframe 公钥
>
> **响应：** 您将收到一个会话令牌，其中包含用于您的 iframe 的 `redirectUrl`。

> [accordion] 步骤 3：嵌入 iframe
>
> **您需要做的：** 使用会话响应中的 `redirectUrl` 设置 iframe 的源 URL。
>
> **实现方式：** 只需将 `redirectUrl` 赋值给 iframe 的 `src` 属性，结账界面即会在您的页面内加载。
>
> **结果：** 用户无需离开您的网站即可完成支付。

***

## 付款方式确认

了解提交付款后会发生什么，有助于您设定合理的用户预期：

> [card] 即时确认
>
> **信用卡和借记卡**
>
> * 即时付款确认
> * 实时交易处理
> * 即时成功/失败通知

> [card] 付款说明
>
> **银行转账**
>
> * 详细的付款说明
> * 提供参考编号
> * 明确付款截止日期

***

## 安全实施

### RSA 签名生成

出于安全考虑，所有请求都必须包含有效的 RSA 签名。生成方法如下：

```csharp theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
public static string Sign(string content, string privateKey)
{
    var contentData = Encoding.ASCII.GetBytes(content);
    var privateKeyData = Convert.FromBase64String(privateKey);

    using var rsa = new RSACryptoServiceProvider();
    using var sha1 = SHA1.Create();

    rsa.ImportRSAPrivateKey(privateKeyData, out _);
    return Convert.ToBase64String(rsa.SignData(contentData, sha1));
}
```

### 最佳实践

* **服务器端处理：** 始终在您的后端创建会话和签名。
* **密钥管理：** 安全存储私钥并定期轮换。
* **仅使用 HTTPS：** 确保所有通信都通过安全连接进行。
* **输入验证：** 在发送到我们的 API 之前验证所有支付数据。

***

## 实施示例

下载我们完整的集成示例，了解各个部分如何协同工作：

> [card] [完整的 iframe 集成示例](https://cdn.localpayment.com/public_docs/Iframe%20Example.txt)

***

> [!NOTE]
>
> **需要帮助吗？**
>
> 如果您遇到任何问题或需要集成方面的帮助，请联系我们的[支持团队](mailto:support@localpayment.com)。


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