商户如何使用Bitfinex Pay？ （支付整合）

Bitfinex 支付概述

1. Bitfinex Pay 是由 iFinex Inc.（运营 Bitfinex 和 Tether 的同一实体）开发的面向商户的支付处理解决方案。

2.它使企业能够直接在其网站或销售点系统上接受加密货币付款，而无需客户持有兑换账户。

3. 该服务支持包括BTC、ETH、USDT和UNUS SED LEO在内的主要加密货币，并提供与法定货币的实时转换选项。

4. 集成依赖于 RESTful API 和基于 Webhook 的通知架构来进行订单状态更新和结算对账。

5. 商户必须通过 Bitfinex 的机构入职门户完成 KYC 验证，然后才能访问生产凭证。

技术集成步骤

1. 开发者访问 Bitfinex Pay 开发者门户注册商家应用程序并获取适用于支付发起和 Webhook 签名的 API 密钥。

2. 使用 HMAC-SHA256 以及商家的密钥、嵌入金额、货币、回调 URL 和过期时间戳在服务器端生成预签名发票有效负载。

3. 签名的有效负载通过 POST 请求发送到https://pay.bitfinex.com/api/v1/invoice ，返回唯一的发票 ID 和二维码 SVG 数据。

4. 商家呈现 QR 码或使用提供的 URL 将客户重定向到托管结帐页面。

5. 成功进行链上确认后，Bitfinex Pay 会向注册的 Webhook 端点发送 HTTP POST，其中包含带有状态、交易哈希和结算详细信息的 JSON 对象。

结算与对账

1. 每 6 小时进行批量结算，资金记入商户指定的 Bitfinex 钱包或外部银行账户（如果启用了法币兑换）。

2. 每笔结算都包含一份经过加密签名的收据，其中包含原始发票 ID、区块高度以及网络费用后的净额。

3. 商户可以使用/api/v1/invoices端点以及分页和日期范围过滤器查询历史发票。

4. 失败或过期的发票会自动触发带有错误代码（例如ERR_INVOICE_EXPIRED或ERR_INSUFFICIENT_CONFIRMATIONS ）的 Webhook 通知。

5. 退款仅通过商家仪表板或通过/api/v1/refund端点发起，需要原始发票 ID 和原因代码。

安全协议

1. 所有 Webhook 负载均包含一个X-BFX-Signature标头，其中包含使用商家共享密钥的原始主体的 Base64 编码 HMAC。

2. IP 白名单在账户级别强制执行；只有列入白名单的 IPv4/IPv6 范围才能发起发票创建请求。

3. 回调 URL 必须使用 TLS 1.2+ 以及受信任 CA 颁发的有效 X.509 证书；自签名证书被拒绝。

4. 发票有效负载在生成后 15 分钟内过期，防止重放攻击。

5. 用于签名验证的私钥永远不会通过网络传输，并且必须存储在硬件安全模块 (HSM) 或等效的安全区域中。

常见问题解答

问：Bitfinex Pay 是否支持定期计费或订阅模式？答：不需要。Bitfinex Pay 专为一次性原子发票结算而设计。循环逻辑必须使用计划的发票生成在外部实现。

问：商户结算时可以禁用法币自动兑换吗？答：是的。商家可以通过“结算首选项”下的仪表板或全局配置每张发票的结算货币，并在本地钱包中保留加密货币余额。

问：如果区块链交易确认但由于流动性不足而未能最终结算，会发生什么情况？答：Bitfinex Pay 保证确认后结算。流动性不足由iFinex内部解决；无论市场状况如何，商家都能获得全额价值。

问：是否有用于测试集成流程的沙盒环境？答：是的。开发者门户在https://pay-staging.bitfinex.com上提供了一个暂存端点，其中包含模拟区块链确认和零费用测试交易。