跳转到主要内容
将白标结账页面无缝集成到您的网站中。嵌入式 iFrame 提供 Localpayment 安全的支付处理能力,同时保留您的品牌形象。 嵌入式 iFrame 选项可让您将 Localpayment 安全的结账体验直接无缝集成到您的网站或应用程序中。该解决方案提供完整的支付处理界面,同时保持您品牌的外观和风格。

主要优势

灵活且品牌安全的集成

通过可自定义的 iframe 保持品牌一致性,iframe 可无缝嵌入您的结账流程。避免页面跳转,确保流畅的用户旅程,且不影响用户体验

快速实施

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

更低的维护成本

由于 iframe 由 Localpayment 托管和维护,您可以持续获得更新,且不会对您的部署产生任何影响。

简化合规与风险管理

将敏感支付数据保留在您的服务器之外,缩小您的 PCI 范围。借助 iframe,商户可将安全责任和合规责任转移给 Localpayment。

用例

嵌入式 iFrame 解决方案几乎适用于任何支付场景。以下是最常见的实施方式:
  • 电子商务与零售: 无需自定义支付表单即可处理线上购买。
  • 服务行业: 收取专业服务和咨询的费用。
  • 活动与娱乐: 音乐会场馆销售活动门票。
  • 非营利与社区: 慈善机构在线收取捐款。

集成流程

您需要做的: 在您的 Localpayment Business Portal 中创建用于验证您的集成的 iframe 密钥。重要提示: 请将您的私钥安全地存储在您的服务器上,切勿在客户端代码中暴露。您的公钥可以安全地用于前端应用程序。资源: 请按照我们详细的 iframe 密钥教程获取分步说明。
发生了什么: 通过向我们的 API endpoint 发起服务器端请求,生成安全的会话令牌。endpoint: POST https://api.stage.localpayment.com/bff/webcheckout/createsession必需参数:
  • bodyMessage - 您的支付请求数据(格式与 Payin API 相同)
  • signature - 您的消息正文的 RSA 签名
  • publicKey - 您的 iframe 公钥
响应: 您将收到一个会话令牌,其中包含用于您的 iframe 的 redirectUrl。
您需要做的: 使用会话响应中的 redirectUrl 设置 iframe 的源 URL。实现方式: 只需将 redirectUrl 赋值给 iframe 的 src 属性,结账界面即会在您的页面内加载。结果: 用户无需离开您的网站即可完成支付。

付款方式确认

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

即时确认

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

付款说明

银行转账
  • 详细的付款说明
  • 提供参考编号
  • 明确付款截止日期

安全实施

RSA 签名生成

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

最佳实践

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

实施示例

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

完整的 iframe 集成示例


需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

最后修改于 2026年11月10日