文档中心 > API类目 > 天猫好房交易API

qimen.tmall.alihouse.trade.secondhand.house.orderinfo (二手房履约单状态变更通知外部系统)

二手房履约单重要节点消息变更通知外部系统

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bizScenarios String 可选 shh_market 业务场景
houseOrderNo String 必须 234567890987654 统一订单号
tpOrderId Number 可选 34567 淘宝订单号
isTest Number 可选 0 是否是测试单 0-非测试(默认) 1-测试
environment String 可选 online daily-日常 pre-预发 online-线上 默认:online
bizCreateTime Number 可选 23456778 订单的创建时间
bizEndTime Number 可选 3456789876 订单的终态时间
sellerId Number 可选 2457678 卖家id
shopId Number 可选 245678 店铺id
storeId Number 可选 2345644 门店id
itemId Number 可选 2367457 商品id
skuId Number 可选 24562578 skuId
eventInfo EventInfo 可选 事件信息
  • └ eventType
  • String
  • 可选
  • pay_event
  • 事件类型
  • contractOrderInfos
  • ContractOrderInfo []
  • 可选
  • 签约单基本信息列表
  • └ type
  • String
  • 可选
  • FUND_ESCROW
  • 签约类型:FUND_ESCROW-定金合同
  • └ contractOrderNo
  • String
  • 可选
  • 1234
  • 签约单号
  • └ terminateOrderNo
  • String
  • 可选
  • 12345
  • 解约单号
  • └ receiveFinalPaymentDdl
  • Number
  • 可选
  • 1200000
  • 领取尾款确认的截止时间戳:毫秒
  • └ activateFinalPaymentTime
  • Number
  • 可选
  • 1200000
  • 操作激活尾款时间戳:毫秒

响应参数

名称 类型 示例值 描述
status Number 1 成功标志,1-成功,0-失败
qmCode String 200 返回码200成功,非200失败
qmMsg String success 返回信息
data Boolean true 返回信息

请求示例

{"tpOrderId":34567,"bizCreateTime":23456778,"storeId":2345644,"houseOrderNo":"234567890987654","itemId":2367457,"environment":"online","eventInfo":{"terminateOrderNo":"12345","eventType":"pay_event","receiveFinalPaymentDdl":1200000,"contractOrderInfos":[{"type":"FUND_ESCROW","contractOrderNo":"1234"}],"activateFinalPaymentTime":1200000},"sellerId":2457678,"isTest":0,"bizScenarios":"shh_market","shopId":245678,"skuId":24562578,"bizEndTime":0}

响应示例

{
    "status":1,
    "qmCode":"200",
    "qmMsg":"success",
    "data":true
}

验签示例

{"qmCode":"sign-check-failure","qmMsg":"Illegal request","status":"不等于1"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部