跳转到主要内容
本指南提供详细的分步说明,指导您如何将智能字段集成到支付流程中。完成本指南后,您将能够直接在网站上安全地收集支付信息,而敏感数据将由 Localpayment 处理。

先决条件

请确保您已准备好以下必需物品:

API密钥

您可以从 测试 环境或 生产 环境获取身份验证密钥。

客户端代码

您的唯一商户标识符,可在 Localpayment Business Portal 中找到。

后端设置

服务器 endpoint 已准备好接收支付令牌并处理交易。

集成步骤

  1. 包含 Smart Fields SDK

选择适合集成的环境:
使用此功能可进行开发和测试,并模拟支付过程:
提示
上线前,务必在测试环境中对集成进行彻底测试。

  1. 初始化 SDK

脚本加载完成后,使用您的凭据初始化 SDK:
配置参数:

  1. 创建安全会话

与 Localpayment 服务器建立安全连接:
安全须知该会话为所有支付数据建立加密通信通道。

  1. 设置付款表单

创建支付表单的 HTML 结构:

  1. 创建并挂载支付字段

初始化安全支付字段并将其添加到表单中:
使用 mount() 方法在您指定的容器内渲染安全的 iframe。传递一个 CSS 选择器字符串,用于标识您的目标 DOM 元素(例如 #pan-container)。 字段类型和特征:

  1. 处理字段事件和验证

监听每个字段的事件,以更新用户界面并跟踪其验证状态:

  1. 处理付款提交

获取会话数据和会话 ID:

  1. 合并会话并获取令牌

向 Consolidate endpoint 发送 POST 请求,并附上 sessionId 和持卡人详细信息:
环境:
  • Stage:
  • Production:
预期的合并响应:

  1. 处理付款

创建一个 新的 Payin,并使用令牌参数代替持卡人信息。令牌可以安全地表示支付方式,而不会泄露敏感信息。

资源与后续步骤

利用这些关键资源,最大限度地提高您的集成成功率。

Webhook 集成

设置交易状态更新的实时通知。

报告 Business Portal

获取详细的分析、报告工具和对账功能。

交易监控

学习查询交易状态并实现全面跟踪。

API 参考

提供包含交互式示例的完整 endpoint 文档。

专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。

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

最后修改于 2026年11月10日