2.1 运费账单创建

请求URL

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

请求方式

• 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	-	-	极兔运费账单商户订单号
billAmount	是	long	-	-	运费账单金额 (单位为分 如:500泰铢 示例:50000)
billFinalDate	是	string	-	-	运费账单最迟结算日期（支持：日期和时间 示例："2026-01-01" or "2026-01-01 01:00:00" ）
callbackUrl	是	string	-	-	核销回调通知接口

请求示例

请求体

{
  "appId": "733b887a4a784708bb369524db5b6ded",
  "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
  "param": "{\"timestamp\":1715595802,\"jtUuid\":\"JT1095595801938341100\",\"mchOrderId\":\"1095595801938341100\",\"billAmount\":12000,\"billFinalDate\":\"2024-11-28\",\"callbackUrl\":\"https://www.example.com/wallet\"}"
}

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)
billNumber	string	钱包侧运费账单编号
status	string	运费账单状态 PENDING, PROCESSING, COMPLETED, PENDING_CANCALLATION, CANCELLED

响应示例

响应数据体

{
  "code": 10000,
  "message": "Success",
  "data": {
    "jtUuid": "JT1095595801938341100",
    "uuid": "U1095595801938341100",
    "billAmount": 360000,
    "billNumber": "TD4948378283893",
    "status": "PENDING"
  }
}

Code Collection

失败响应示例

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