2.2 运费账单查询

请求URL

• {domain}/open-api/jt/wallet/delivery/bill/query

请求方式

• POST

请求头

参数名	必选	类型	说明
Content-Type	是	string	application/json

请求体参数

参数名	必选	类型	说明
appId	是	string	Application APPID
param	是	string	Parameter body
sign	是	string	Signature

param 参数

参数名	必选	类型	长度	示例	说明
timestamp	是	long	-	1677495496979	毫秒时间戳
jtUuid	是	string	-	-	极兔用户uuid唯一标识号
mchOrderId	否	string	-	-	极兔运费账单商户订单号
billNumber	否	string	-	-	钱包运费账单流水号

请求示例

请求体

{
  "appId": "733b887a4a784708bb369524db5b6ded",
  "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
  "param": "{\"timestamp\":1715595802,\"jtUuid\":\"JT1095595801938341100\",\"mchOrderId\":\"1095595801938341100\",\"billNumber\":\"C3838449939\"}"
}

How to construct request body

---

响应参数

参数名	类型	说明
code	integer	response code
message	string	response message
data	Object	data

data参数

参数名	类型	说明
jtUuid	string	极兔用户uuid
uuid	string	钱包用户uuid
billAmount	long	账单金额 (单位为分 如:500泰铢 示例:50000)
billAmountUncleared	long	账单待消帐金额 (单位为分 如:500泰铢 示例:50000)
billAmountCleared	long	账单已核销金额 (单位为分 如:500泰铢 示例:50000)
mchOrderId	string	极兔运费账单商户订单号
billNumber	string	钱包侧运费账单流水号
createTime	string	"2024-11-22 00:00:00"
returnTime	string	"2024-11-22 00:00:00"
status	string	运费账单状态 PENDING, PROCESSING, COMPLETED, PENDING_CANCALLATION, CANCELLED
billClearHistory	list	运费账单-核销列表

billClearHistory参数

参数名	类型	说明
mchOrderId	string	极兔运费账单商户订单号
clearAmount	long	运费账单核销金额
clearType	string	运费账单核销类型 COD_BALANCE 指COD余额(余额中极兔COD回款部分);BASE_BALANCE 指基础余额(余额中用户自主充值部分);J&T(ONLINE) 指用户通过线上QR付款; J&T(OFFLINE)指用户通过线下付款
createTime	string	"2024-11-22 00:00:00"
returnTime	string	"2024-11-22 00:00:00"
clearStatus	string	COMPLETED, FAILED
clearReferenceNumber	string	账单核销流水号
walletTransactionId	string	钱包交易编号
relatedTransactionId	string	网关代扣的交易编号(COD_BALANCE,BASE_BALANCE), J&T的传递交易字段(J&T)

响应示例

响应数据体

{
  "code": 10000,
  "message": "Success",
  "data": {
    "jtUuid": "JT1095595801938341100",
    "uuid": "U1095595801938341100",
    "billAmount": 360000,
    "billAmountUncleared": 0,
    "billAmountCleared": 360000,
    "billNumber": "TD4948378283893",
    "status": "PENDING",
    "createTime": "2024-11-23 12:12:12",
    "returnTime": "2024-11-24 12:12:12",
    "billClearHistory": [
      {
        "mchOrderId": "JT1929393093020",
        "clearReferenceNumber": "TD4948378283893",
        "clearAmount": 160000,
        "createTime": "2024-11-23 12:12:12",
        "returnTime": "2024-11-24 12:12:12",
        "walletTransactionId": "C4948378283893",
        "clearType": "COD_BALANCE",
        "clearStatus": "COMPLETED",
        "relatedTransactionId": "JT2838349949"
      },
      {
        "mchOrderId": "JT1929393093020",
        "clearReferenceNumber": "TD4948378283893",
        "clearAmount": 200000,
        "createTime": "2024-11-23 12:12:12",
        "returnTime": "2024-11-24 12:12:12",
        "walletTransactionId": "C4948378283893",
        "clearType": "COD_BALANCE",
        "clearStatus": "COMPLETED",
        "relatedTransactionId": "JT2838349949"
      }
    ]
  }
}

Code Collection

失败响应示例

{
  "code": 1002,
  "message": "merchant white ip forbidden"
}