Skip to main content

查询账单

查询账单

Request#

POST

/gateway/query-bill

Parameter#

application/json

FieldTypeDescription
merchantCodestring [5..50] charactersUnique merchant code
queryTypestringEnum: "ORDER_QUERY" "CASH_QUERY"
query type:
ORDER_QUERY: query pay order
CASH_QUERY: query cash order
pageNonumber <int32> Nullablewhich page,default 1
pageSizenumber <int32> Nullablepage size,default 10
beginTimestring <date-time>format yyyyMMddHHmmss
endTimestring <date-time>format yyyyMMddHHmmss
beginSuccessTimestring <date-time>format yyyyMMddHHmmss
endSuccessTimestring <date-time>format yyyyMMddHHmmss
appIdstring NullableApplication ID. Merchants can create their own applications according to the business. This field is optional.
signstring <=512 charactersEncrypted parameters.

Request Example#

{
"merchantCode": "S2020198627344",
"queryType": "ORDER_QUERY",
"pageNo": 1,
"pageSize": 1,
"beginTime": "20190824141522",
"endTime": "20190824141522",
"beginSuccessTime": "20190824141522",
"endSuccessTime": "20190824141522",
"appId": "4023123456",
"sign": "MIGfMA0GCSqGSI...w1ypbiy7VhIoFJbgSYSSHdC"
}

Response#

Success#

200 application/json

FieldTypeDescription
platRespCodestringresult code: "SUCCESS" "FAIL" "UNKNOWN" "NOTEXIST" "ERROR"
platRespMessagestringdescription of resp code
dataobjectdata set for pay order list or cash order list, only payList or loanList inside
platSignstringEncrypted response data

data

FieldTypeDescription
totalMoneynumbertotal money
totalFeenumbertotal fee
pageNonumberwhich page
pageSizenumberpage size
totalCountnumbertotal page size
payListArray
loanListArray

payList or loanList

FieldTypeDescription
mchNamestringmerchant name
platOrderNumstringunique order number in platform wide.
orderNumstringunique order number in merchant wide. Same as orderNum in request body.
inMoneynumber <int64>money transfer to destination account.
chargeMoneynumber <int64>money total deducted from merchant's account.
platTransFeenumber <int64>fee charged by platform
createTimestring <date-time>format yyyyMMddHHmmss
successTimestring <date-time>format yyyyMMddHHmmss
failMsgstringmsg when cash order fail
appIdstring NullableApplication ID. Merchants can create their own applications according to the business. This field is optional.
chargeFeeTypestringEnum: "0" "1"
How to charge the transaction:

0 Deducted from the transfer amount
1 Deducted from the merchant balance
transStatusstringEnum: "0" "1" "2" "4" "5"
cash order status. when queryType is CASH_QUER, the status can be:

0 : newly created order
1 or 5 : platform is processing disbursement
2 : disburse successfully
3 : cancelled
4 : fail

Response Example#

{
"platRespCode": "SUCCESS",
"platRespMessage": "success",
"data": {
"totalMoney": 0,
"totalFee": 0,
"pageNo": 0,
"pageSize": 0,
"totalCount": 0,
"payList": [
{
"mchName": "string",
"platOrderNum": "BCA_1234567890",
"orderNum": "T202007183457183",
"method": "BCA",
"payMoney": 10000,
"inMoney": 10000,
"platTransFee": 3000,
"createTime": "20190824141522",
"successTime": "20190824141522",
"appId": "4023123456",
"payStatus": "NO_PAY"
}
],
"loanList": [
{
"mchName": "string",
"platOrderNum": "BCA_1234567890",
"orderNum": "T202007183457183",
"inMoney": 10000,
"chargeMoney": 10000,
"platTransFee": 3000,
"createTime": "20190824141522",
"successTime": "string",
"failMsg": "string",
"appId": "4023123456",
"chargeFeeType": "0",
"transStatus": "2"
}
]
},
"platSign": "MIGfMA0GCSqGSI...w1ypbiy7VhIoFJbgSYSSHdC"
}