「支付」订单信息变更API

私域支付场景下,用户订单信息发生变化时的通知,主要包括“用户支付成功”、“用户点击领取”两个节点。

前置条件

  1. 需要品牌方提供一个POST请求的接口;
  2. 品牌方提前将需要提供店铺bot id以及webhook推送地址给到Meetbot; 

推送的内容的格式

用户支付完成
{ "param": { "orderNo": "2024050718311083340000016", // 订单号 "userPhone": "8613564696769", // 用户手机号 "customerUserId": "9001", // 客户的用户id "orderPaymentStatus": "SUCCESS_PAYMENT", // 支付状态-支付成功 "payTime": "2024-05-07T18:31:54+08:00", // 支付时间 "skuId": "xxxxxx" // 商品skuId } }
用户确认领取
{ "param": { "orderNo": "2024050718311083340000016", // 订单号 "userPhone": "8613564696769", // 用户手机号 "customerUserId": "9001", // 客户的用户id "orderPaymentStatus": "SUCCESS_PAYMENT", // 支付状态-支付成功 "payTime": "2024-05-07T18:31:54+08:00", // 支付时间 "skuId": "xxxxxx" , // 商品skuId "confirmTime": "2024-05-07T18:33:57+08:00" // 用户确认领取时间 } }

字段含义

字段含义
orderPaymentStatusSUCCESS_PAYMENT支付成功
REFUNDED已退款
PAYMENT_TIME_OUT支付超时
customerUserId数值类型客户系统中的用户id
注意:
1.品牌方接收到消息时,响应状态码为200,Meetbot认为推送成功;2.当Meetbot调用品牌方webhook地址推送失败是,后续会间隔5分钟推送一次,知道推送成功;
2024-05-13
0