4. 获取用户账单信息

请求URL

• {domain}/open-api/jt/wallet/bills

请求方式

• POST

请求头

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

请求体参数

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

param 参数

参数名	必选	类型	长度	示例	说明
timestamp	是	long	-	1677495496979	毫秒时间戳
jtUuid	否	string	-	-	极兔用户uuid唯一标识号
startDate	是	string	-	-	账单推送时间-查询开始时间(最大查询周期不能超过31天)
endDate	是	string	-	-	账单推送时间-查询结束时间(最大查询周期不能超过31天)
size	否	int	-	-	每页显示条数(不传默认为15条,单页最大条数10000)
page	否	int	-	-	页数(不传默认为第1页)

请求示例

请求体

{
  "appId": "733b887a4a784708bb369524db5b6ded",
  "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
  "param": "{\"timestamp\":1715595802,\"jtUuid\":\"JT1095595801938341100\",\"startDate\":\"2024-11-24\",\"endDate\":\"2024-11-25\"}"
}

How to construct request body

---

响应参数

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

data参数

参数名	类型	说明
list	List	分页记录信息,按记录的创建时间倒序
total	integer	总条数
size	integer	每页显示条数
current	integer	当前页

list参数

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

响应示例

响应数据体

{
  "code": 10000,
  "message": "Success",
  "data": {
    "total": 2,
    "size": 15,
    "current": 1,
    "list": [
      {
        "jtUuid": "JT1095595801938341100",
        "uuid": "U1095595801938341100",
        "mchOrderId": "JT1929393093020",
        "billAmount": 360000,
        "billAmountUncleared": 160000,
        "billAmountCleared": 200000,
        "billNumber": "TD4948378283893",
        "createTime": "2024-11-23 12:12:12",
        "returnTime": "2024-11-24 12:12:12",
        "status": "PENDING",
        "billType": 1
      },
      {
        "jtUuid": "JT1095595801938341100",
        "uuid": "U1095595801938341100",
        "mchOrderId": "JT1929393093020",
        "billAmount": 360000,
        "billAmountUncleared": 160000,
        "billAmountCleared": 200000,
        "billNumber": "TD4948378283893",
        "createTime": "2024-11-23 12:12:12",
        "returnTime": "2024-11-24 12:12:12",
        "status": "PENDING",
        "billType": 2
      }
    ]
  }
}

Code Collection

失败响应示例

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