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

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

### 步骤 1：注册 Infini 企业账号

- [**生产环境注册入口**：https://business.infini.money/register ](https://business.infini.money/register)
- [**测试环境注册入口**：https://business-sandbox.infini.money/register](https://business-sandbox.infini.money/register)
- **生产环境API**：
https://openapi.infini.money
- **测试环境API**：
https://openapi-sandbox.infini.money


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

### 步骤 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：

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