YHOUSE平台会员核销推送接口 - YHOUSE-SH/yhouse-thirdpart GitHub Wiki

  1. 接口说明:

    • 使用场景: 合作商户平台用户（YHOUSE会员）购买YHOUSE权益核销推送
    • 授权说明: 悦会提供授权商户号和密钥
    • 接口请求方式: POST
    • 数据格式: JSON
    • 访问限制:
      • YHOUSE授权商户
        • 授权商户号 (YHOUSE提供)
        • 授权商户密钥 (YHOUSE提供)
        • 售卖商品映射 (双方合作提供)

  2. 接口流程 接口流程

  3. 接口地址
    该地址由商户平台提供

  4. 请求头信息:

    • Content-Type:application/x-www-form-urlencoded; charset=utf-8

  5. 请求参数信息:

    参数名 类型 必填 说明 示例
    uid String Y 商户平台用户ID 3213452
    mobile Long N YHOUSE平台用户手机号(需加入混淆值 mobile+12345678912) 30697602894
    cardPackageId String Y 使用会员档位卡包ID 43907355
    cardPackageId String Y 卡包ID 43907355
    cardName String Y 卡包名 W802
    city String N 核销城市名 南京
    orderNumber String Y 订单号 7880355938260418560
    goodsName String Y YHOUSE权益名称 嘉定喜来登酒店
    classifyName String Y YHOUSE权益类别名 星级酒店
    ecId String Y 对应权益ID A25145450-E25345447
    price Double Y 原价 398.00
    vipPrice Double Y 会员价 298.00
    payAmount Double Y 支付价格 298.00
    payTime Date Y 支付时间 2019-11-06 17:44:59
    quantity Integer Y 数量 2019-11-06 17:44:59
    sign String Y 参数签名 B59C67BF196A4758191E42F76670CEBA

示例: 
 {
 	"orderNumber": "7880355938260418560",
 	"quantity": "1",
 	"cardName": "酒店次卡（1次）",
 	"city": "南京",
 	"payTime": "2019-11-06 17:44:59",
 	"mobile": "30697602894",
 	"cardPackageId": "43907355",
 	"uid": "3213452",
 	"payAmount": "298.00",
 	"ecId": "A25145450-E25345447",
 	"price": "398.00",
 	"vipPrice": "298.00",
 	"goodsName": "嘉定喜来登酒店",
 	"classifyName": "星级酒店",
 	"skuId": "W802"
 }
6. 请求返回
正常返回示例: 
    {
	"code": 0,
	"message": "success",
	"detail": "",
	"data": {
	    "msgId":"2134284474747"
	}
    }
异常返回示例 
    {
	"code": "xxx",//xxx为非0
	"message": "xxxx",//xxxx错误信息
	"detail": "xxxxx", //xxxxx错误信息详情
	"data": null
    }
⚠️ **GitHub.com Fallback** ⚠️