商户接口

1. 获取商户的子用户

获取商户的子用户，这个接口入参外部系统的用户id，可以查询这个用户的基本信息（平台用户id，名字）、余额信息（币种、用户余额）、跳转钱包url（通过此链接可以跳转到快付宝平台）。

1.1 接口信息

• 访问地址: POST /merchant/getMerchantCustomer

1.2 请求参数

参数名称	参数命名	最大长度	类型	必填	备注
时间戳	timestamp	20	Long	Y	UTC零时区时间戳
商户appKey	appKey	20	String	Y	商户appKey
随机字符串	nonceStr	32	String	Y	保证系统内唯一，如短uuid
外部系统的UserId	extUserId	20	String	Y	外部系统的UserId
签名	sign	32	String	Y	签名方式详见安全规范

1.3 响应参数

参数名称	参数命名	最大长度	类型	备注
业务返回码	code	255	Integer	200为成功
返回信息	msg		String	错误原因
数据	data		Object	响应数据
Data参数
平台userId	userId	20	Long	平台userId
外部用户id	extUserId	20	String	外部用户id
用户名字	username	128	String	用户名字
币种	currency	10	String	币种
用户余额	balance		BigDecimal	用户余额
h5访问链接	url	1024	String	h5访问链接
钱包账号	address	1024	String	钱包账号地址
波场钱包地址	tronAddress	1024	String	波场钱包地址
签名	sign	32	String	签名

---

2. 查询商户余额

查询商户用户的余额信息。

2.1 接口信息

• 访问地址: POST /merchant/getMerchantBalance

2.2 请求参数

参数名称	参数命名	最大长度	类型	必填	备注
商户appKey	appKey	20	String	Y	商户appKey
签名	sign	32	String	Y	签名
时间戳	timestamp	20	Long	Y	UTC零时区时间戳
随机字符串	nonceStr	32	String	Y	随机字符串

2.3 响应参数

参数名称	参数命名	最大长度	类型	备注
业务返回码	code	255	Integer	200为成功
返回信息	msg		String	错误原因
数据	data	128	Object	响应数据
Data参数
商户ID	merchantId		Long	商户ID
商户usdt余额	usdtBalance		BigDecimal	商户usdt余额
商户kfb余额	kfbBalance		BigDecimal	商户kfb余额
签名	sign	32	String	签名

---

3. 商户货币兑换

商户货币兑换接口，商户可以通过此接口将一种货币兑换成另一种货币。 主要场景：

1. 商户子用户划转到商户的余额为KF币，商户提现需要将KF币兑换为USDT币后，才能提现到外部钱包。
2. 商户逆划转金额给用户需要使用KF币，故商户充值USDT进来后，需要兑换为KF币，才能进行逆划转。

3.1 接口信息

• 访问地址: POST /merchant/exchange

3.2 请求参数

参数名称	参数命名	最大长度	类型	必填	备注
商户appKey	appKey	20	String	Y
时间戳	timestamp	20	Long	Y	UTC零时区时间戳
随机字符串	nonceStr	32	String	Y
兑换金额	amount	20	String	Y	保留2位小数，范围[0.01,100000000]
兑出货币单位	sendCurrency	20	String	Y	USDT、KFB
兑入货币单位	receiveCurrency	20	String	Y	USDT、KFB
签名	sign	32	String	Y

3.3 响应参数

参数名称	参数命名	最大长度	类型	备注
业务返回码	code	255	Integer	200为成功
数据	data	128	Object
Data参数
兑出货币单位	sendCurrency	20	String
兑入货币单位	receiveCurrency	20	String
兑换金额	amount		String
兑换到账金额	amountArrival		String
兑换汇率	rate		BigDecimal
交易id	transactionId		Long
签名	sign	20	String

---

4. 商户获取提现手续费

提前获取提现的手续费。

4.1 接口信息

• 访问地址: POST /merchant/getWithdrawFee

4.2 请求参数

参数名称	参数命名	最大长度	类型	必填	备注
商户appKey	appKey	20	String	Y
时间戳	timestamp	20	Long	Y
随机字符串	nonceStr	32	String	Y
金额	amount	15	String	Y	订单金额（2位小数）
币种	currency	15	String	Y	USDT
签名	sign	32	String	Y

4.3 响应参数

参数名称	参数命名	最大长度	类型	备注
业务返回码	code	255	Integer	200为成功
数据	data	128	Object
Data参数
金额	amount		BigDecimal	提现金额
到账数量	amountArrival		BigDecimal	到账金额
手续费	fee		BigDecimal	手续费
费率	rate		BigDecimal	费率
验签	sign		String

---

5. 创建商户支付订单(预下单)

创建商户支付订单，返回支付链接。

5.1 接口信息

• 访问地址: POST /merchant/pay/create

5.2 请求参数

参数名称	参数命名	最大长度	类型	必填	备注
商户appKey	appKey	20	String	Y	商户appKey
时间戳	timestamp	20	Long	Y	UTC零时区时间戳
随机字符串	nonceStr	32	String	Y	随机字符串
商户订单号	mcOrderId	64	String	Y	商户订单号
金额	amount	20	String	Y	订单金额
币种	currency	10	String	Y	币种 (如 USDT)
商品名称	productName	128	String	N	商品名称
异步通知地址	notifyUrl	255	String	N	异步通知地址
签名	sign	32	String	Y	签名

5.3 响应参数

参数名称	参数命名	最大长度	类型	备注
业务返回码	code	255	Integer	200为成功
数据	data	128	Object
Data参数
支付链接	payUrl		String	支付链接 (Telegram Deep Link)
系统交易单号	id		Long	系统交易单号
创建时间	createTime		Long	创建时间戳
过期时间	expireTime		Long	过期时间戳
签名	sign	32	String	签名