跳到主要内容

入金查询

用于查询入金请求

请求地址

  • 接口地址(requestURI): /openapi/v1/deposit/query

请求参数

参数名称类型出现要求描述
trackingIdStringR商户跟踪id。各个商户的每次交易操作应保证唯一

请求示例

{
"trackingId": "20220408123456789"
}

响应参数

参数名称类型出现要求描述
trackingIdString商户跟踪id
statusInteger入金状态。[0:待入金,1:部分入金,2:完全入金,3:撤销入金,4:请求失效],示例值为1
assetNameString资产名称。如:BTC
netProtocolString网络协议
sourceAddressString来源地址
destinationAddressString目标地址
merchantNameString商户名称
amountBigDecimal金额
accumulatedAmountBigDecimal已入金金额
remarkString备注说明
assetTypeInteger资产类型。[0:加密货币,1:法定货币]
webhookUrlString通知回调地址/webhook url
successPageUrlString入金成功跳转页面地址
businessNameString入金业务名称。比如商品名称/业务名称,例如: xxx报名费
bankCodeString银行代码。某些币种的支付类型需要
userIdString用户id
userIpString用户ip地址
stayReasonString停留原因
depositDetailDtoListArrayList入金明细

depositDetailDtoList

参数名称类型出现要求描述
assetNameString资产名称。如:BTC
netProtocolString网络协议
sourceAddressString来源地址
destinationAddressString目标地址
merchantNameString商户名称
txHashStringTxHash
amountBigDecimal金额
statusInteger入金明细状态。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
}
]
}
}