先决条件
请确保您已准备好以下必需物品:API密钥
您可以从 测试 环境或 生产 环境获取身份验证密钥。
客户端代码
您的唯一商户标识符,可在 Localpayment Business Portal 中找到。
后端设置
服务器 endpoint 已准备好接收支付令牌并处理交易。
集成步骤
- 包含 Smart Fields SDK
选择适合集成的环境:
- Stage(测试)
- Production(线上)
使用此功能可进行开发和测试,并模拟支付过程:
提示
上线前,务必在测试环境中对集成进行彻底测试。
上线前,务必在测试环境中对集成进行彻底测试。
- 初始化 SDK
脚本加载完成后,使用您的凭据初始化 SDK:
- 创建安全会话
与 Localpayment 服务器建立安全连接:
安全须知该会话为所有支付数据建立加密通信通道。
- 设置付款表单
创建支付表单的 HTML 结构:
- 创建并挂载支付字段
初始化安全支付字段并将其添加到表单中:
mount() 方法在您指定的容器内渲染安全的 iframe。传递一个 CSS 选择器字符串,用于标识您的目标 DOM 元素(例如 #pan-container)。
字段类型和特征:
- 处理字段事件和验证
监听每个字段的事件,以更新用户界面并跟踪其验证状态:
- 处理付款提交
获取会话数据和会话 ID:
- 合并会话并获取令牌
向 Consolidate endpoint 发送 POST 请求,并附上 sessionId 和持卡人详细信息:
环境:
- Stage:
- Production:
- 处理付款
创建一个 新的 Payin,并使用令牌参数代替持卡人信息。令牌可以安全地表示支付方式,而不会泄露敏感信息。
资源与后续步骤
利用这些关键资源,最大限度地提高您的集成成功率。Webhook 集成
设置交易状态更新的实时通知。
报告 Business Portal
获取详细的分析、报告工具和对账功能。
交易监控
学习查询交易状态并实现全面跟踪。
API 参考
提供包含交互式示例的完整 endpoint 文档。
专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。
需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

