# 2.6 运费账单取消确认

# 请求URL

{domain}/open-api/jt/wallet/cancel/delivery/bill/update

# 请求方式

POST

# 请求头

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

# 请求体参数

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

# param 参数

参数名	必选	类型	长度	示例	说明
timestamp	是	long	-	1677495496979	毫秒时间戳
mchOrderId	否	string	-	-	极兔运费账单取消订单号(cancelOrderId为空时必填)
cancelOrderId	否	string	-	-	钱包侧取消订单编号（mchOrderId为空时必填）
cancelStatus	是	string	-	-	取消确认: `SUCCESS`(完成),`RESERVED`(撤回)

# 请求示例

# 请求体

{
  "appId": "733b887a4a784708bb369524db5b6ded",
  "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
  "param": "{\"timestamp\":1715595802,\"mchOrderId\":\"cancelBill001\",\"cancelStatus\":\"SUCCESS\"}"
}

How to construct request body

# 响应参数

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

# data参数

参数名	类型	说明
mchOrderId	string	极兔侧的运费账单取消订单号
cancelOrderId	string	钱包侧取消订单编号
cancelStatus	string	取消订单状态: `PENDING`(处理中),`SUCCESS`(完成),`RESERVED`(撤回)
createTime	string	创建时间
returnTime	string	完成时间
billList	list	待取消的运费账单列表

# billList参数

参数名	类型	说明
billOrderId	string	极兔侧的运费账单编号
billNumber	string	钱包侧的运费账单编号
billStatus	string	钱包侧的运费账单状态 `PENDING`, `PROCESSING`, `COMPLETED`, `PENDING_CANCALLATION`, `CANCELLED`

# 响应示例

# 响应数据体

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "cancelBill001",
    "cancelOrderId": "CB12321320250331001",
    "cancelStatus": "SUCCESS",
    "createTime": "2024-11-23 12:12:12",
    "returnTime": "2024-11-24 12:12:12",
    "billList": [
      {
        "billOrderId": "VIP890150014520250401022158001",
        "billNumber": "BN1906423274452160512",
        "billStatus": "CANCELLED"
      },
      {
        "billOrderId": "VIP890150014520250401022158002",
        "billNumber": "BN1906421297928343552",
        "billStatus": "CANCELLED"
      }
    ]
  }
}

Code Collection

# 失败响应示例

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

← 2.5 运费账单取消 2.7 运费账单取消状态查询 →