环境

环境 URL

环境	Base URL	说明
生产环境	https://defi.hashnut.io	商户对接使用的正式环境

TIP

建议按 准备工作 的顺序验证：先用小额真实订单跑通下单、支付、归集、 提现和通知回调，确认无误后再放开正常金额的流量。

生产网络

链代码	网络名称
ETH	Ethereum Mainnet
BSC	BNB Smart Chain
POLYGON	Polygon (Matic)
TRON	Tron Mainnet

SDK 配置示例

Go - 生产环境

import hashnut "github.com/nuttybounty/hashnut-sdk-go/v4"

// 第二个参数固定传 false，即使用生产环境
client := hashnut.NewClient("your-secret-key", false)
// Base URL: https://defi.hashnut.io/api/v4.0.0

Go - 自定义地址

import hashnut "github.com/nuttybounty/hashnut-sdk-go/v4"

// WithBaseURL 覆盖默认地址
client := hashnut.NewClient(
	"your-secret-key",
	false,
	hashnut.WithBaseURL("https://your-custom-endpoint.com/api/v4.0.0"),
)

Java - 生产环境

import io.hashnut.client.HashNutClientImpl;
import io.hashnut.service.HashNutServiceImpl;

// 第二个参数固定传 false，即使用生产环境
var client = new HashNutClientImpl("your-secret-key", false);
var service = new HashNutServiceImpl(client);

Java - 自定义地址

import io.hashnut.client.HashNutClientImpl;
import io.hashnut.service.HashNutServiceImpl;

// 传字符串则直接作为 base URL
var client = new HashNutClientImpl("your-secret-key", "https://your-custom-endpoint.com/api/v4.0.0");
var service = new HashNutServiceImpl(client);

NOTE

SDK 只需要 secretKey。accessKeyId 是逐笔请求的参数（CreateOrderRequest.accessKeyId）， 不在客户端构造时传入。

WARNING

WithBaseURL / 字符串形式的 base URL 必须带上 /api/v4.0.0，因为 SDK 内部拼接的是相对路径 （如 /api/orders/create）。漏掉版本段会 404。

REST API 基础路径

所有 API 接口均以版本路径为前缀：

{BASE_URL}/api/v4.0.0/...

例如创建订单接口的完整 URL：

https://defi.hashnut.io/api/v4.0.0/api/orders/create

演示商店

参考实现可在以下地址访问：

组件	URL
演示商店（前端）	https://demo.hashnut.io

演示商店展示了完整的支付流程，包括订单创建、支付页面、Webhook 处理和订单状态展示。