主要优势
灵活且品牌安全的集成
通过可自定义的 iframe 保持品牌一致性,iframe 可无缝嵌入您的结账流程。避免页面跳转,确保流畅的用户旅程,且不影响用户体验
快速实施
无需构建或维护复杂的前端基础设施,即可部署本地和国际支付方式。我们的 iframe 让您在几分钟内即可上线,加快拓展进度并减少对工程团队的依赖。
更低的维护成本
由于 iframe 由 Localpayment 托管和维护,您可以持续获得更新,且不会对您的部署产生任何影响。
简化合规与风险管理
将敏感支付数据保留在您的服务器之外,缩小您的 PCI 范围。借助 iframe,商户可将安全责任和合规责任转移给 Localpayment。
用例
嵌入式 iFrame 解决方案几乎适用于任何支付场景。以下是最常见的实施方式:- 电子商务与零售: 无需自定义支付表单即可处理线上购买。
- 服务行业: 收取专业服务和咨询的费用。
- 活动与娱乐: 音乐会场馆销售活动门票。
- 非营利与社区: 慈善机构在线收取捐款。
集成流程
步骤 1:生成 iframe 密钥
步骤 1:生成 iframe 密钥
您需要做的: 在您的 Localpayment Business Portal 中创建用于验证您的集成的 iframe 密钥。重要提示: 请将您的私钥安全地存储在您的服务器上,切勿在客户端代码中暴露。您的公钥可以安全地用于前端应用程序。资源: 请按照我们详细的 iframe 密钥教程获取分步说明。
步骤 2:创建支付会话
步骤 2:创建支付会话
发生了什么: 通过向我们的 API endpoint 发起服务器端请求,生成安全的会话令牌。endpoint:
POST https://api.stage.localpayment.com/bff/webcheckout/createsession必需参数:bodyMessage- 您的支付请求数据(格式与 Payin API 相同)signature- 您的消息正文的 RSA 签名publicKey- 您的 iframe 公钥
redirectUrl。步骤 3:嵌入 iframe
步骤 3:嵌入 iframe
您需要做的: 使用会话响应中的
redirectUrl 设置 iframe 的源 URL。实现方式: 只需将 redirectUrl 赋值给 iframe 的 src 属性,结账界面即会在您的页面内加载。结果: 用户无需离开您的网站即可完成支付。付款方式确认
了解提交付款后会发生什么,有助于您设定合理的用户预期:即时确认
信用卡和借记卡
- 即时付款确认
- 实时交易处理
- 即时成功/失败通知
付款说明
银行转账
- 详细的付款说明
- 提供参考编号
- 明确付款截止日期
安全实施
RSA 签名生成
出于安全考虑,所有请求都必须包含有效的 RSA 签名。生成方法如下:最佳实践
- 服务器端处理: 始终在您的后端创建会话和签名。
- 密钥管理: 安全存储私钥并定期轮换。
- 仅使用 HTTPS: 确保所有通信都通过安全连接进行。
- 输入验证: 在发送到我们的 API 之前验证所有支付数据。
实施示例
下载我们完整的集成示例,了解各个部分如何协同工作:完整的 iframe 集成示例
需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

