事件优惠下发

一个第三方服务对应一个车场的下发优惠券类型固定,由平台配置

1.1) 请求地址

https://api.4pyun.com/gate/1.0/parking/mcoupon/event/create

1.2) 调用方式

HTTP POST FORM 表单提交

1.3) 特殊说明

1:app_id,app_secret 用户身份id和加密密钥由平台方提供,对接方需提供公司全称然后给到商务提交给研发申请
2:merchant,store_code分别代表停车场商户号和商家商户号,两个参数由停车场物业那边提供
3:coupon_code是具体一种优惠券的券ID,目前物业创建好优惠券充值好券之后截图然后找研发同事复制出来该值
4:返回状态码code:1001代表派发成功,其它状态码直接读取message提示信息
5:特别注意即使http状态非200也要把返回内容读取出来,会返回具体错误原因

1.4) 请求参数

字段名称 类型 必填 字段说明
app_id string true 平台分配的接入应用ID
api_store_code string true 车场对应第三方平台ID
api_type string true 第三方服务类型(该字段由平台分配,固定)
event_id string true 第三方订单号, 需保证在第三方平台唯一
plate string true 车牌号
subject string true 优惠事件描述,如“【粤BD07627】于【2020-09-08 17:15:58 - 2020-09-08 17:45:26】充电 1119.62 KWH 时长 29 分钟”
metadata map false 业务元数据, 该参数key为表示业务类型的某一固定值,由平台提供;EventMetadata参数参考下方;该字段固定优惠规则可不传;
sign string true 签名

EventMetadata

Name Type Required Description
name string true 数据名称,该参数仅用于数据值说明
value int32 true 数据值,调用方的业务变量,该参数结合metadata的key会决定下发优惠方案

1.6) 请求返回结果参数说明

字段名称 类型 必填 字段说明
code string false 返回Code值:
1001 优惠派发成功
1002 车辆未入场
1003 优惠限制
1401 第三方优惠配置不存在
1403 重复派发
1405 车场下发失败
1500 内部错误, 提示message的信息
message string false none
hint string false none
seqno string false none
data_node string false none
time_cost integer(int64) false none
plate string true 车牌号
enter_time string true 车辆入场时间

1.7) 请求返回结果示例:

正常返回
{
 "code": "1001",
 "data_node": "HS1-1",
 "seqno": "86213123",
 "payload": {
 "grant_serial": "xxxxx"
 },
 "time_cost": 100,
 "message": "操作成功"
}
参数错误
{
    "code": "400",
    "message": "请求参数错误",
    "hint": "`merchant` Required!",
    "seqno": "94929a9b0874aa46",
    "data_node": "CN-South/HS3-2",
    "path": "POST /gate/1.0/parking/mcoupon/grant/create"
}
服务器内部错误
{
    "code": "1500",
    "message": "没有匹配到停车记录",
    "seqno": "57804ae2e859f58a",
    "data_node": "CN-South/HS3-1",
    "time_cost": 239,
    "payload": {
        "grant_serial": ""
    }
}
© 2023 Shenzhen ChinaRoad Technology Co., Ltd. © All Rights Reserved            UPDATED 2024/06/14 12:00:57

results matching ""

    No results matching ""