获取渠道核销订单接口 - YHOUSE-SH/yhouse-thirdpart GitHub Wiki

  1. 接口说明:

    • 使用场景: 获取渠道核销订单接口（默认返回前一天的数据）
    • 授权说明: 悦会提供授权商户号和密钥
    • 接口请求方式: POST
    • 数据格式: JSON
    • 访问限制:
      • YHOUSE授权商户（特定渠道）
        • 授权商户号 (YHOUSE提供)
        • 授权商户密钥 (YHOUSE提供)

  2. 接口地址

  3. 请求头信息:

    • Accept:application/json;charset=UTF-8
    • Content-Type:application/json

  4. 请求参数信息:

    参数名 类型 必填 说明 示例
    timestamp Long Y 当前unix时间戳(包含毫秒) 1560851373957
    partnerNo String Y 悦会提供的商户号 PN0001
    startDate String Y 查询开始时间 2019-09-01
    endDate String Y 查询结束时间 2019-09-23
    sign String Y 参数签名 B59C67BF196A4758191E42F76670CEBA

  1. 请求返回

正常返回示例:

{
  "code": "0",
  "data": [
    {
      "quantity": 3,//数量
      "cardName": "会员普卡",//卡包名称
      "city": "上海",//核销城市
      "ecId":"A25145492-E25745473",//权益类目ID
      "payTime": "2019-09-10 17:45:54",//核销时间
      "mobile": "17302154397",//手机号
      "cardPackageId": 464540594,//卡包ID
      "uid": "100103165",//三方UID
      "payAmount": 0.03,//实际支付金额
      "price": 35,//权益原价
      "vipPrice": 0.01,//权益会员价
      "goodsName": "星巴克中杯兑换券",//SKU名称
      "classifyName": "大牌咖啡",//权益类目名称
      "skuId": "L362"//三方SkuId
    },
    {
      "quantity": 4,
      "cardName": "会员all",
      "city": "上海",
      "ecId":"A25145492-E25745475"
      "payTime": "2019-09-10 17:45:54",
      "mobile": "17302154397",
      "cardPackageId": 464540697,
      "uid": "100103165",
      "payAmount": 0.04,
      "price": 20,
      "vipPrice": 0.01,
      "goodsName": "追剧",
      "classifyName": "影音娱乐",
      "skuId": "L727"
    }
  ],
  "detail": "",
  "message": "success"
}

异常返回示例

    {
	"code": "P10000",
	"message": "success",
	"detail": "参数uid为空",
	"data": null
    }
⚠️ **GitHub.com Fallback** ⚠️