到位H5渠道订单同步接口

订单同步接口

到位平台可通过该接口，将合作方带来的订单实时同步给合作方，以便合作方自行统计数据或将订单数据合并到自有订单系统中。到位平台通过POST方式向合作方推送订单信息。

  • method：POST，
  • ContentType：application/x-www-form-urlencoded

字段说明

appkey 和channel相同 字符串
sign 签名 字符串
oncestr 随机字符 字符串
data 数据 URL编码后的json格式的字符串

data字段说明（需要URL解码）： 

{
    "orderId": "180723165731541",//订单ID
    "userId": "2554e93f75bc4c1c9c29877a103c67f9",//用户id
    "userPhone": "15321985855",//用户手机号
    "orderPrice": 100,//订单价格（元） double
    "orderName": "测试商品",
    "timestamp": 1532675735,//操作时间
    "status": "COMPLETED",//订单状态
    "note": "",//备注
    "appointTime": 1526617800,//预约时间
    "orderProducts": [
      {
        "productId": "2521432",//商品id
        "productNum": 1,//商品数量
        "productPrice": 100//商品价格
      }
    ]
     "appendOrder": {//补差价信息
            "id": "000b0e9bef9a4c83bba98632247b9b17",
            "bill": 60,
            "createtime": 1480753878000,
            "note": null
        },
        "partReturn": {//部分退款信息
            "id": "00005b27a7b8403f9a6a3a9e7f78c188",
            "bill": 100,
            "createtime": 1475217898000
        }
  }

参数说明：
status为订单状态，每次状态改变都会推送

  • PENDING_CONFIRM：订单已提交;
  • CONFIRMED：商家已接单;
  • COMPLETED_BY_SELLER：商家确认完成;
  • PENDING_REFUND：用户申请退款;
  • PENDING_MEDIATION：退款待仲裁;
  • COMPLETED：用户确认完成;
  • COMPLETED_BY_SYSTEM：系统确认完成;
  • COMMENTED_BY_BUYER：用户已评价;
  • CANCELED_BY_BUYER：用户已取消;
  • REJECTED_BY_SELLER：商家已取消;
  • CANCELED_CAUSE_NOT_PAY：未支付取消;
  • CANCELED_BY_SYSTEM_TRUE：系统取消;
  • COMMENTED_BY_SYSTEM：系统自动五星评价;

数据签名方法

生成 sign 字符串的方法,商家标识 appkey，密钥 secret 由到位提供。

  1. 拼接加密字符串（按照字段名的 ASCII 码从小到大排序）其中DATA为未URL解码的的字符串，appkey=shijizhiguang&data=DATA&oncestr=8fa6b61dc33d4a848f79531037a0b9e2&secret=3c3ed7574654433bbdb14b39947d3ef9;
  2. 进行 md5 运算后转换为大写,得到sign的值
    • 例如，String sign = md5(加密字符串).toUpperCase();sign = "67CE6E661DB75A14206A4BD7FC5DC45E";
  3. 比较sign

订单查询接口

接口说明

参数说明

  • appkey:appkey
  • oncestr:oncestr //随机字符串
  • orderId:orderId //订单id
  • sign:AFCE8E8C794403735A204FCF408C40BC //签名