2.4 运费账单回调

请求URL

• {domain}/xxxxxxx 由商户提供

请求方式

• POST

请求头

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

请求体参数

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

param 参数

参数名	是否必填	类型	说明
eventName	是	string	事件名称（ delivery.clear.success ）
jtUuid	是	string	极兔用户uuid
uuid	是	string	钱包用户uuid
mchOrderId	是	string	运费账单商户订单号
billNumber	是	string	钱包运费账单编号
clearAmount	是	long	运费账单核销金额 (单位为分 如:500泰铢 示例:50000)
clearType	是	string	运费账单核销类型 COD_BALANCE 指COD余额(余额中极兔COD回款部分);BASE_BALANCE 指基础余额(余额中用户自主充值部分);J&T(ONLINE) 指用户通过线上QR付款; J&T(OFFLINE)指用户通过线下付款
clearStatus	是	string	核销状态 COMPLETED, FAILED
createTime	是	string	交易创建时间
returnTime	是	string	交易完成时间
clearReferenceNumber	是	string	钱包运费账单核销流水号
walletTransactionId	否	string	钱包交易编号
relatedTransactionId	是	string	网关代扣的交易编号(COD_BALANCE,BASE_BALANCE), J&T的传递交易字段(J&T)

请求示例

请求体

{
  "appId": "733b887a4a784708bb369524db5b6ded",
  "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
  "param": "{\"eventName\":\"delivery.clear.success\",\"jtUuid\":\"JT1095595801938341100\",\"uuid\":\"U1095595801938341100\",\"mchOrderId\":\"1095595801938341100\",\"billNumber\":\"1095595801938341100\",\"clearAmount\":20000,\"clearType\":\"COD_BALANCE\",\"clearStatus\":\"COMPLETED\",\"createTime\":\"2024-11-24 00:00:00\",\"returnTime\":\"2024-11-24 00:00:00\",\"walletTransactionId\":\"C948938838282844\",\"relatedTransactionId\":\"JT948938838282844\"}"
}

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

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

How to construct request body

响应参数

参数名	类型	说明
code	integer	响应码，固定为 10000
message	string	响应消息，固定为 Success

返回示例

{
  "code": 10000,
  "message": "Success"
}