Appearance
商户接口
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. 商户货币兑换
商户货币兑换接口，商户可以通过此接口将一种货币兑换成另一种货币。 主要场景：
- 商户子用户划转到商户的余额为KF币，商户提现需要将KF币兑换为USDT币后，才能提现到外部钱包。
- 商户逆划转金额给用户需要使用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 |