{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"2. 商户如何接入并使用 Infini API"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-商户如何接入并使用-infini-api","__idx":0},"children":["2. 商户如何接入并使用 Infini API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["本章节将引导您完成从注册账号、配置密钥，到 API 对接与 Webhook 设置的完整流程，帮助您快速开始使用 Infini 的数字货币收单能力。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"步骤-1注册-infini-企业账号","__idx":1},"children":["步骤 1：注册 Infini 企业账号"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://business.infini.money/register"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["生产环境注册入口"]},"：https://www.infini.money/auth?auth_account_type=business "]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://business-sandbox.infini.money/register"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["测试环境注册入口"]},"：https://home-sandbox.infini.money/auth?auth_account_type=business"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["生产环境API"]},"："," ","https://openapi.infini.money"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["测试环境API"]},"："," ","https://openapi-sandbox.infini.money"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["注册完成后，您即可登录商户后台进行后续配置。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"步骤-2配置收银台基础信息","__idx":2},"children":["步骤 2：配置收银台基础信息"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["进入后台 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["「收单 > 收银台设置」"]},"，可按业务需求配置以下内容："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["收银台账单名称"]},"：用于在支付页面展示商户或业务线名称，提升用户识别度。初始默认为客户注册时填写的企业名称。"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["若通过 API 创建订单时传入账单名称，则 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["以 API 传参为准"]},"；后台配置作为默认值。"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["订单默认过期时间"]},"：控制订单的有效支付时间窗口；超时未支付订单将自动标记为expired，超时部分金额支付订单将自动标记为partial_paid。初始默认为24小时。"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["若通过 API 创建订单时传入 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["expires_in"]},"，则 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["以 API 传参为准"]},"；后台配置仅作为默认过期时间。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"步骤-3在开发者页面获取密钥并配置安全策略","__idx":3},"children":["步骤 3：在开发者页面获取密钥并配置安全策略"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["进入后台 「开发者」 页面，完成以下操作："]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["生成并保存密钥对"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["创建 API 密钥后，系统将展示：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["商户公钥（Public Key）"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["商户私钥（Private Key）"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["⚠️ 重要提示：私钥仅展示一次"," ","请务必在首次展示时妥善备份；如遗失需重新生成新的密钥对。"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["配置 IP 白名单"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在创建密钥时，可配置允许访问 API 的 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IP 白名单"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["建议仅填写您的生产/测试服务器出口 IP，以增强 API 调用安全性。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"步骤-4进行-api-对接并配置-webhook-通知","__idx":4},"children":["步骤 4：进行 API 对接并配置 Webhook 通知"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["完成 API 对接"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["根据文档要求完成 HMAC 签名流程。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["按业务流程开发以下接口：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["创建订单"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["查询订单"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["建议先在测试环境联调，再切换到生产环境。"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["配置 Webhook 通知地址"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在后台 「开发者」 页面填写：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Webhook 接收 URL"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["订阅事件类型"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["页面将展示 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Infini 的 Webhook 公钥"]},"，用于对回调通知进行 HMAC 验签，以确保通知来源真实可靠。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"步骤-5使用建站平台插件正在开发中","__idx":5},"children":["步骤 5：使用建站平台插件（正在开发中）"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["若您使用主流建站平台搭建网站，可通过官方插件快速接入 Infini："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["进入后台 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["「收单 > 使用引导」"]},"，可查看并下载各类建站平台插件。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["插件提供一键安装方式，可在无需开发的情况下完成支付能力集成。"]}]}]},"headings":[{"value":"2. 商户如何接入并使用 Infini API","id":"2-商户如何接入并使用-infini-api","depth":2},{"value":"步骤 1：注册 Infini 企业账号","id":"步骤-1注册-infini-企业账号","depth":3},{"value":"步骤 2：配置收银台基础信息","id":"步骤-2配置收银台基础信息","depth":3},{"value":"步骤 3：在开发者页面获取密钥并配置安全策略","id":"步骤-3在开发者页面获取密钥并配置安全策略","depth":3},{"value":"步骤 4：进行 API 对接并配置 Webhook 通知","id":"步骤-4进行-api-对接并配置-webhook-通知","depth":3},{"value":"步骤 5：使用建站平台插件（正在开发中）","id":"步骤-5使用建站平台插件正在开发中","depth":3}],"frontmatter":{"seo":{"title":"2. 商户如何接入并使用 Infini API"}},"lastModified":"2026-08-12T06:23:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh/docs/en/2-how-to-get-started","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}