Skip to content
Last updated

2. 商户如何接入并使用 Infini API

本章节将引导您完成从注册账号、配置密钥,到 API 对接与 Webhook 设置的完整流程,帮助您快速开始使用 Infini 的数字货币收单能力。

步骤 1:注册 Infini 企业账号

注册完成后,您即可登录商户后台进行后续配置。

步骤 2:配置收银台基础信息

进入后台 「收单 > 收银台设置」,可按业务需求配置以下内容:

  • 收银台账单名称:用于在支付页面展示商户或业务线名称,提升用户识别度。初始默认为客户注册时填写的企业名称。

若通过 API 创建订单时传入账单名称,则 以 API 传参为准;后台配置作为默认值。

  • 订单默认过期时间:控制订单的有效支付时间窗口;超时未支付订单将自动标记为expired,超时部分金额支付订单将自动标记为partial_paid。初始默认为24小时。

若通过 API 创建订单时传入 expires_in,则 以 API 传参为准;后台配置仅作为默认过期时间。

步骤 3:在开发者页面获取密钥并配置安全策略

进入后台 「开发者」 页面,完成以下操作:

  1. 生成并保存密钥对
  • 创建 API 密钥后,系统将展示:
    • 商户公钥(Public Key)
    • 商户私钥(Private Key)
  • ⚠️ 重要提示:私钥仅展示一次 请务必在首次展示时妥善备份;如遗失需重新生成新的密钥对。
  1. 配置 IP 白名单
  • 在创建密钥时,可配置允许访问 API 的 IP 白名单
  • 建议仅填写您的生产/测试服务器出口 IP,以增强 API 调用安全性。

步骤 4:进行 API 对接并配置 Webhook 通知

  1. 完成 API 对接
  • 根据文档要求完成 HMAC 签名流程。
  • 按业务流程开发以下接口:
    • 创建订单
    • 查询订单
  • 建议先在测试环境联调,再切换到生产环境。
  1. 配置 Webhook 通知地址
  • 在后台 「开发者」 页面填写:
    • Webhook 接收 URL
    • 订阅事件类型
  • 页面将展示 Infini 的 Webhook 公钥,用于对回调通知进行 HMAC 验签,以确保通知来源真实可靠。

步骤 5:使用建站平台插件(正在开发中)

若您使用主流建站平台搭建网站,可通过官方插件快速接入 Infini:

  • 进入后台 「收单 > 使用引导」,可查看并下载各类建站平台插件。
  • 插件提供一键安装方式,可在无需开发的情况下完成支付能力集成。