入金查询
用于查询入金请求
请求地址
- 接口地址(requestURI): /openapi/v1/deposit/query
请求参数
参数名称 | 类型 | 出现要求 | 描述 |
---|---|---|---|
trackingId | String | R | 商户跟踪id。各个商户的每次交易操作应保证唯一 |
请求示例
{
"trackingId": "20220408123456789"
}
响应参数
参数名称 | 类型 | 出现要求 | 描述 |
---|---|---|---|
trackingId | String | 商户跟踪id | |
status | Integer | 入金状态。[0:待入金,1:部分入金,2:完全入金,3:撤销入金,4:请求失效],示例值为1 | |
assetName | String | 资产名称。如:BTC | |
netProtocol | String | 网络协议 | |
sourceAddress | String | 来源地址 | |
destinationAddress | String | 目标地址 | |
merchantName | String | 商户名称 | |
amount | BigDecimal | 金额 | |
accumulatedAmount | BigDecimal | 已入金金额 | |
remark | String | 备注说明 | |
assetType | Integer | 资产类型。[0:加密货币,1:法定货币] | |
webhookUrl | String | 通知回调地址/webhook url | |
successPageUrl | String | 入金成功跳转页面地址 | |
businessName | String | 入金业务名称。比如商品名称/业务名称,例如: xxx报名费 | |
bankCode | String | 银行代码。某些币种的支付类型需要 | |
userId | String | 用户id | |
userIp | String | 用户ip地址 | |
stayReason | String | 停留原因 | |
depositDetailDtoList | ArrayList | 入金明细 |
depositDetailDtoList
参数名称 | 类型 | 出现要求 | 描述 |
---|---|---|---|
assetName | String | 资产名称。如:BTC | |
netProtocol | String | 网络协议 | |
sourceAddress | String | 来源地址 | |
destinationAddress | String | 目标地址 | |
merchantName | String | 商户名称 | |
txHash | String | TxHash | |
amount | BigDecimal | 金额 | |
status | Integer | 入金明细状态。1未确认,2确认中,3已确认,4已取消,5未支付,6交易成功,7交易失败 |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": {
"trackingId": "20220408123456789",
"status": 1,
"assetName": "BTC",
"netProtocol": "BTC",
"sourceAddress": "sourceAddress",
"destinationAddress": "destinationAddress",
"merchantName": "merchantName",
"amount": 100,
"accumulatedAmount": 0,
"remark": "Deposit",
"assetType": 0,
"webhookUrl": "https://yourdomain.com/webhook",
"successPageUrl": "https://yourdomain.com/success",
"businessName": "Deposit",
"bankCode": "bankCode",
"userId": "123456",
"userIp": "127.0.0.1",
"stayReason": "stayReason",
"depositDetailDtoList": [
{
"assetName": "BTC",
"netProtocol": "BTC",
"sourceAddress": "sourceAddress",
"destinationAddress": "destinationAddress",
"merchantName": "merchantName",
"txHash": "txHash",
"amount": 100,
"status": 1
}
]
}
}