Web Hook

当账单状态发生变化时，roogoo将向app中设置的通知地址发送通知。 收到通知后，需要在5秒内返回一个应答报文。否则，Roogoo认为通知失败，重复发送通知。同一个通知可以发送多次，重复的通知必须正确处理。如果它已被处理，则直接将成功返回给Roogoo。客户端应该返回指定的返回码。如果发送回调URL后没有收到相应的返回码，则Roogoo系统认为推送失败。

响应报文为：

{
"success": true,
"msg":""
}

通知重试次数 5次

通知重试间隔

第一次间隔5秒，后续每次重试间隔时间翻倍，直到最后一次为40s.

通知事件

收款事件

{
  "orderID": "12345",
  "invoiceID": "abcde123",
  "orderStage": "pay",
  "orderStatus": "payable",
  "eventType": "receive",
  "event": {
  "totalSolidReceivedAmount": "100.00",
  "totalPendingReceivedAmount": "50.00",
  "receivedType": "pending",
  "receivedAmount": "25.00"
}
}

订单状态更新事件

{
  "orderID": "12345",
  "invoiceID": "abcde123",
  "orderStage": "close",
  "orderStatus": "complete",
  "eventType": "change",
  "event": {
  "statusChangeCause": "system",
  "oldStatus": "payable",
  "nowStatus": "payment"
}
}

订单阶段更新事件

{
  "orderID": "12345",
  "invoiceID": "abcde123",
  "orderStage": "close",
  "orderStatus": "complete",
  "eventType": "change",
  "event": {
  "stageChangeCause": "system",
  "oldStage": "pay",
  "nowStage": "close"
}
}

签名

每次通知都在请求头中包含一个 signature，该签名 是 roogoo 对 请求体 的sha256 哈希值 的ecdsa签名，验签公钥请与roogoo联系获取