2.3 运费账单J&T核销推送

请求URL

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

请求方式

• 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	-	-	极兔运费账单商户订单号
clearAmount	是	long	-	-	运费账单核销金额 (单位为分 如:500泰铢 示例:50000)
relatedTransactionId	是	string	-	-	核销关联流水号（J&T侧支付单号）
clearSource	是	string	-	-	核销来源 ONLINE,OFFLINE

请求示例

请求体

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

How to construct request body

---

响应参数

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

data参数

参数名	类型	说明
jtUuid	string	极兔用户uuid
uuid	string	钱包用户uuid
clearAmount	long	运费账单核销金额(单位为分 如:500泰铢 示例:50000)
clearReferenceNumber	string	钱包运费账单流水号
clearStatus	string	账单核销状态 COMPLETED, FAILED

响应示例

响应数据体

{
  "code": 10000,
  "message": "Success",
  "data": {
    "jtUuid": "JT1095595801938341100",
    "uuid": "U1095595801938341100",
    "clearAmount": 360000,
    "clearReferenceNumber": "TD4948378283893",
    "clearStatus": "COMPLETED"
  }
}

注（运费账号核销失败处理方案）:

1. 核销失败大多数原因是因为并发处理，均由极兔记录异常数据，暂时统一走线下处理逻辑

Code Collection

失败响应示例

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