接口调用

主要业务流程系统交互时序图

服务商系统配置信息注册(查询)

场景：为最终实现用户在停车缴费平台完成绑车牌、缴费等服务，服务商需要结合自身系统进行停车业务的环境配置，配置服务商缴费查询页面的地址链接，只有自助完成配置停车业务各环节的环境信息后，才能进行正常的业务调用，请仔细填写系统配置信息。

调用接口时序图

注意：alipay.eco.mycar.parking.config.set（停车ISV系统配置接口）每次调用都会覆盖掉原有的系统配置信息，为确保配置的正确性，可先调用 alipay.eco.mycar.parking.config.query（ISV系统配置查询接口）查询已配置的接口信息并确认后，再进行配置接口的调用。**
**

示例代码

"interface_info_list": {
  "merchant_name": "服务商名称",
  "merchant_service_phone": "021-25413215",
  "account_no": "1234567@126.com",
  "interface_info_list": [
    {
      "interface_type": "interface_page",
      "interface_url": "https%3A%2F%2Fwww.parking.com%2Fuser%2Fquery.do",
      "interface_name": "alipay.eco.mycar.parking.userpage.query"
    },
    {
      "interface_name": "alipay.eco.mycar.parking.isv.homepage",
      "interface_type": "interface_page",
      "interface_url": "2018000000000000|pages/queryFee/queryFeeInfo"
    }
  ],
  "merchant_logo": ""
}

入参说明

interface_info_list：接口信息列表，停车业务需要配置的接口列表，该值为 JSON 数据格式的 LIST 对象，现阶段只需要配置一个页面接口即可。

interface_name：

H5 传入参数固定值为 alipay.eco.mycar.parking.userpage.query 。

小程序传入参数固定值为 alipay.eco.mycar.parking.isv.homepage。

interface_type：传入参数固定值为 interface_page。

interface_url：

H5 SPI 接口的调用地址 URL，协议必须为 https，对整个 URL 字符串必须进行 UrlEncode 编码。编码为UTF-8 。

小程序 SPI 接口的调用地址 URL 格式：小程序 + 分隔符 + 小程序缴费页面地址。**
**

停车业务配置信息

服务商通过调用 alipay.eco.mycar.parking.config.set（停车ISV系统配置接口）配置车主平台各业务所需要的系统配置信息。如果接口配置存在则覆盖原有的接口信息。通过该接口设置的配置信息是立刻生效的，在调用该接口修改配置信息时请先评估对线上业务的影响，并做好处理方案。

示例代码

//实例化客户端
 AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY);
 //实例化具体API对应的request类,类名称和接口名称对应, 
 AlipayEcoMycarParkingConfigSetRequest request = new AlipayEcoMycarParkingConfigSetRequest();
 //SDK已经封装掉了公共参数，这里只需要传入业务参数
 //此次只是参数展示，未进行字符串转义，实际情况下请转义
 request.setBizContent("{" +
 "\"merchant_name\":\"杭州立方\"," +
 "\"merchant_service_phone\":\"021-25413215\"," +
 "\"account_no\":\"1234567@126.com\"," +
 "\"merchant_logo\":\"iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAABGdBTUEAALGPC/xhBQAAAHhJREFUSA1jZCASCPS/rmf4/68BrJyRqeFDoWgjMVqZiFFEiZpRCwiG3mgQjYAgYgTnUIIeBSr4z2DPwPDPEaKUaT8DI8NBYrQxCvS9/E+MQnLV0DyZsjAACy6iXEduEBFlOFDRaGlKbEiRrI7mqWjUAoJxMvSDCAABChtBImPMwgAAAABJRU5ErkJggg==\"," +
 "\"interface_info_list\":[{" +
 "\"interface_name\":\"alipay.eco.mycar.parking.userpage.query\"," +
 "\"interface_type\":\"interface_page\"," +
 "\"interface_url\":\"https%3A%2F%2Fwww.parking24.cn%2Frf_carlife_alipay%2FCarLifeAction%21alipayAuth.action\"" +
 " }]" +
 " }");//业务数据
 try {
 AlipayEcoMycarParkingConfigSetResponse response = client.execute(request);
 //判断调用是否成功
 if(response.isSuccess()){
 //获取相应数据
 Map<String,String> responseParams = response.getParams();
 //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
 }else{
 //调用失败处理逻辑
 }
 } catch (AlipayApiException e) {
 // TODO Auto-generated catch block
 //调用异常逻辑处理
 e.printStackTrace();
 }

**注意：**将图片转为 merchant_logo 字段所需的 base64 格式的字符串，可查看以下示例代码。

//将图片文件转化为字节数组字符串，并对其进行Base64编码处理  
 public   static  String  getImageStr ()   {
         //待处理的本地图片 
        String imgFile =  "D://logo.png" ;
        InputStream in =  null ;
         byte [] data =  null ;
         //读取图片字节数组 
         try  {
            in =  new  FileInputStream(imgFile);
            data =  new   byte [in.available()];
            in.read(data);
            in.close();
        }  catch  (IOException e) {
            e.printStackTrace();
        }
         //对字节数组Base64编码 
        BASE64Encoder encoder =  new  BASE64Encoder();
         //返回Base64编码过的字节数组字符串 
         return  encoder.encode(data);
}

停车业务配置信息查询

服务商可调用 alipay.eco.mycar.parking.config.query（ISV系统配置查询接口）查询服务商已注册到车主平台停车业务系统配置信息。

示例代码

//实例化客户端
AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY);
 //实例化具体API对应的request类,类名称和接口名称对应, 
 AlipayEcoMycarParkingConfigQueryRequest request = new AlipayEcoMycarParkingConfigQueryRequest();
 //SDK已经封装掉了公共参数，这里只需要传入业务参数
 //此次只是参数展示，未进行字符串转义，实际情况下请转义
 request.setBizContent("{" +
 "\"interface_name\":\"alipay.eco.mycar.parking.userpage.query\"," +
 "\"interface_type\":\"interface_page\"" +
 " }");//业务数据
 try {
 AlipayEcoMycarParkingConfigQueryResponse response = client.execute(request);
 //判断调用是否成功
 if(response.isSuccess()){
 //获取相应数据
 Map<String,String> responseParams = response.getParams();
 //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
 }else{
 //调用失败处理逻辑
 }
 } catch (AlipayApiException e) {
 // TODO Auto-generated catch block
 //调用异常逻辑处理
 e.printStackTrace();
 }

入参说明

参数名称	必填	参数说明
interface_name	否	传入参数固定。值：alipay.eco.mycar.parking.userpage.query
interface_type	否	传入参数固定值：interface_page。

服务商停车场信息注册或者修改

场景：服务商与支付宝合作，并开通了支付宝停车缴费服务产品后，服务商在停车平台上注册停车场信息或更新停车场信息。在整个业务链路中是停车场与支付宝停车平台对接的第一步，停车场信息用于在停车服务页面上展现，因此要确保信息的准确性。

调用接口时序图

**注意：**返回的支付宝停车场唯一标识服务商需进行保存以便之后的业务接口使用。**
**

录入停车场信息

服务商通过 alipay.eco.mycar.parking.parkinglotinfo.create（录入停车场信息接口）录入停车场信息到支付宝，支付宝生成停车场 ID 反馈给开发者。

示例代码

//实例化客户端
 AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY);
        //实例化具体API对应的request类,类名称和接口名称对应, 
        AlipayEcoMycarParkingParkinglotinfoCreateRequest request = new AlipayEcoMycarParkingParkinglotinfoCreateRequest();
        //SDK已经封装掉了公共参数，这里只需要传入业务参数
        //此次只是参数展示，未进行字符串转义，实际情况下请转义
        request.setBizContent("{" +"\"parking_poiid\":\"B0FFH97V0Y\"," +
                "\"out_parking_id\":\"558238757\"," +
                "\"parking_name\":\"实例停车场\"," +
                "\"parking_address\":\"实例停车场地址\"," +
                "\"parking_lot_type\":\"1\"," +
                "\"pay_type\":\"2\"," +
                "\"shopingmall_id\":\"100001008\"," +
                "\"parking_fee_description\":\"小车一小时10元\"," +
                "\"parking_mobile\":\"01055886666\"," +
                "\"time_out\":\"15\"" +
"\"agent_id\":\"20881576956341212\"" +
"\"mchnt_id\":\"20881576956684554\"" +
                "}");//业务数据
        try {
            AlipayEcoMycarParkingParkinglotinfoCreateResponse response = client.execute(request);
            //判断调用是否成功
            if(response.isSuccess()){
                //获取相应数据
                Map<String,String> responseParams = response.getParams();
                //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
            }else{
                //调用失败处理逻辑
            }
        } catch (AlipayApiException e) {
            // TODO Auto-generated catch block  
            //调用异常逻辑处理
            e.printStackTrace();
        }

停车场信息修改

服务商注册停车场后还可以调用 alipay.eco.mycar.parking.parkinglotinfo.update（修改停车场信息接口）对应停车场标识进行停车场信息的修改。

**注意：**调用本接口 AppID 需与创建停车场 AppID 相同，否则会提示 无权修改服务商停车场。

示例代码

//实例化客户端
 AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY);
        //实例化具体API对应的request类,类名称和接口名称对应, alipay.eco.mycar.parking.parkinglotinfo.update
        AlipayEcoMycarParkingParkinglotinfoUpdateRequest request = new AlipayEcoMycarParkingParkinglotinfoUpdateRequest();
        //SDK已经封装掉了公共参数，这里只需要传入业务参数
        //此次只是参数展示，未进行字符串转义，实际情况下请转义
        request.setBizContent("{" +
                "\"parking_id\":\"PI15394503453489\"," +
                "\"parking_poiid\":\"B0FFH97V0Y\"," +
                "\"parking_name\":\"实例停车场\"," +
                "\"parking_address\":\"实例停车场地址\"," +
                "\"parking_lot_type\":\"1\"," +
                "\"pay_type\":\"1\"," +
                "\"shopingmall_id\":\"100001008\"," +
                "\"parking_fee_description\":\"小车一小时10元\"," +
                "\"parking_mobile\":\"01055886666\"," +
                "\"time_out\":\"15\"" +
"\"agent_id\":\"20881576956341212\"" +
"\"mchnt_id\":\"20881576956684554\"" +
                "}");//业务数据
        try {
            AlipayEcoMycarParkingParkinglotinfoUpdateResponse response = client.execute(request);
            //判断调用是否成功
            if(response.isSuccess()){
                //获取相应数据
                Map<String,String> responseParams = response.getParams();
                //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
            }else{
                //调用失败处理逻辑
            }
        } catch (AlipayApiException e) {
            // TODO Auto-generated catch block  
            //调用异常逻辑处理
            e.printStackTrace();
        }

用户车辆驶入(车辆驶出)停车场车辆信息同步

调用接口时序图

车辆驶入信息同步

在用户驾车进入停车场的场景下，服务商需要调用 alipay.eco.mycar.parking.enterinfo.sync（车辆驶入接口）将用户车辆的入场信息同步到支付宝，一方面用于停车平台向用户推送入场消息通知，另一方便保证用户可通过支付宝停车小程序查询停车记录并判别应该跳转的服务商停车费展示页面的链接。若通过接口上送的入场时间延迟过度（超过15分钟），系统会临时取消本次单条的消息推送。

示例代码

//实例化客户端
 AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY);
 //实例化具体API对应的request类,类名称和接口名称对应, AlipayEcoMycarParkingEnterinfoSyncRequest request = new AlipayEcoMycarParkingEnterinfoSyncRequest ();
 //SDK已经封装掉了公共参数，这里只需要传入业务参数
 //此次只是参数展示，未进行字符串转义，实际情况下请转义
 request.setBizContent("{" +
 "\"parking_id\":\"2015042321001004720200028594\"," +
 "\"car_number\":\"浙Axxxxx\"," +
 "\"in_time\":\"2016-07-24 03:07:50\"" +
 "}");//业务数据 
 try {
 AlipayEcoMycarParkingEnterinfoSyncResponse response = client.execute(request);
 //判断调用是否成功
 if(response.isSuccess()){
 //获取相应数据
 Map<String,String> responseParams = response.getParams();
 //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
 }else{
 //调用失败处理逻辑
 }
 } catch (AlipayApiException e) {
 // TODO Auto-generated catch block 
 //调用异常逻辑处理
 e.printStackTrace();
 }

入参说明

参数名称	必填	参数说明
parking_id	是	支付宝停车场 ID ，系统唯一。
car_number	是	车牌号。
in_time	是	车辆入场的时间，格式"YYYYMM-DD HH:mm:ss"，24 小时制。

车辆离场信息同步

在用户驾车离开停车场的场景下，服务商需要调用 alipay.eco.mycar.parking.exitinfo.sync（车辆驶出接口）将用户的车辆离场信息同步到支付宝，完成标识该车辆是否离场的状态，以便用户可以在停车平台查询到车辆历史停车信息。

示例代码

//实例化客户端
 AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY);
 //实例化具体API对应的request类,类名称和接口名称对应, alipay.eco.mycar.parking.exitinfo.sync
 AlipayEcoMycarParkingExitinfoSyncRequest request = new AlipayEcoMycarParkingExitinfoSyncRequest();
 //SDK已经封装掉了公共参数，这里只需要传入业务参数
 //此次只是参数展示，未进行字符串转义，实际情况下请转义
 request.setBizContent("{" +
 "\"parking_id\":\"2015042321001004720200028594\"," +
 "\"car_number\":\"浙Axxxxx\"," +
 "\"out_time\":\"2016-07-24 03:07:50\"" +
 "}");//业务数据
 try {
 AlipayEcoMycarParkingExitinfoSyncResponse response = client.execute(request);
 //判断调用是否成功
 if(response.isSuccess()){
 //获取相应数据
 Map<String,String> responseParams = response.getParams();
 //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
 }else{
 //调用失败处理逻辑
 }
 } catch (AlipayApiException e) {
 // TODO Auto-generated catch block 
 //调用异常逻辑处理
 e.printStackTrace();
 }

入参说明

参数名称	必填	参数说明
parking_id	是	支付宝停车场 ID，系统唯一。
car_number	是	车牌号。
out_time	是	车辆离场时间，格式 YYYYMM-DD HH:mm:ss，24 小时制，请保证车辆的出场时间要晚于入场时间。

用户查询车辆停车费用

场景：车辆进入停车场后，用户可以通过用支付宝客户端的扫一扫功能扫描二维码支付停车费；用户也可以在支付宝客户端的车主服务 > 停车服务中查询并支付停车费。在用户通过支付宝客户端查询支付停车费的场景下，停车平台根据用户车辆驶入信息匹配并跳转到相应的服务商页面。服务商页面服务可通过接口获取用户的车牌号码，展示停车费用，在整个业务链路中引导用户完成停车费支付。

调用接口时序图

服务商需要将停车缴费查询页面（SPI）地址提供给支付宝，该页面地址用于服务商展示用户待缴费用信息，服务商可以通过 alipay.eco.mycar.parking.config.set（停车ISV系统配置接口）进行 SPI 配置，配置该页面地址的 URL；
SPI：SPI 是由支付宝给出定义规范，并由服务商或商家实现的接口。

用户通过支付宝客户端进入停车应用的方式查询停车费用时，支付宝将通过用户授权的方式提供给服务商车辆 ID，服务商需要调用 alipay.eco.mycar.parking.vehicle.query（车牌查询接口）来获取用户的车牌信息；

授权调用的方式可查看 [获取用户信息](https://opendocs.alipay.com/open-v3/05w67q?pathHash=f0df5233#第三步：换取 access_token 和 userId)，使用 auth_code 调用接口 alipay.system.oauth.token 换取 access_token 及用户 userId。**
**

示例代码

https://parking.abc.com/query.do?auth_code=ca34ea491e7146cc87d25fca24c4cD11RSA&car_id=2016042301020544234434&parking_id=201609086335558213543

入参说明

参数名称	必填	参数说明
car_id	是	车辆 ID，系统唯一。
auth_code	是	用户授权码，提供给服务商换取 access_token 及用户 userId。
parking_id	是	支付宝停车场标识，系统唯一。

获取用户车牌信息

服务商调用 alipay.eco.mycar.parking.vehicle.query（车牌查询接口）获取用户车牌信息，展示停车费用，在整个业务链路中引导用户完成停车费支付。

示例代码

//实例化客户端 
    AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY); 
    //实例化具体API对应的request类,类名称和接口名称对应 
    AlipaySystemOauthTokenRequest request = new AlipaySystemOauthTokenRequest(); 
    //授权设置 
    request.setGrantType("authorization_code"); 
    //auth_code设置,从alipay.eco.mycar.parking.userpage.query页面接口中可以获取到该值 
    request.setCode("2e4248c2f50bb4653bf18ecee3466UC18"); 
    //换取调用 
    AlipaySystemOauthTokenResponse response = alipayClient.execute(request); 
    if(response.isSuccess()){ 
        //调用成功 
        String uid = response.getUserId(); 
        //取得令牌 
        String access_token = response.getAccessToken(); 
        //通过授权令牌调用获取用户车牌信息接口 alipay.eco.mycar.parking.vehicle.query 
        AlipayEcoMycarParkingVehicleQueryRequest request = new AlipayEcoMycarParkingVehicleQueryRequest(); 
        //SDK已经封装掉了公共参数，这里只需要传入业务参数 
        //此次只是参数展示，未进行字符串转义，实际情况下请转义

 request.setBizContent("{" +
 "\"car_id\":\"201605061278654\"" +
 "}");//业务数据
 AlipayEcoMycarParkingVehicleQueryResponse response = alipayClient.execute(request,access_token); 
 //判断调用是否成功
 if(response.isSuccess()){
 //获取相应数据
 Map<String,String> responseParams = response.getParams();
 //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
 }else{
 //调用失败处理逻辑
 }
 } else {
  //换取令牌失败逻辑处理
 }

入参说明

参数名称	必填	参数说明
car_id	是	车辆 ID，支付宝系统唯一，用户车辆唯一标识。

出参说明

参数名称	必填	参数说明
car_number	是	车牌信息，用户想进行查询停车费用的车牌号码。

停车业务订单信息同步

在用户查看到车辆的停车费用信息，点击缴费调起收银台，支付停车费用的场景下，为保证停车平台与服务商停车场订单信息的同步，服务商需要在用户支付成功后。通过接口 alipay.eco.mycar.parking.order.sync（订单同步接口）将必要的停车缴费订单进行同步到停车平台，使用户在停车平台能够查询到相应的订单信息。

调用接口时序图

停车缴费订单生成可查看 alipay.trade.create（统一收单交易创建接口）。

支付结果异步通知可查看当面付异步通知。

服务商收到支付成功的通知后需要将停车订单信息通过 alipay.eco.mycar.parking.order.sync（订单同步接口）进行订单同步。**
**

示例代码

//实例化客户端
 AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY);
 //实例化具体API对应的request类,类名称和接口名称对应, alipay.eco.mycar.parking.order.sync
 AlipayEcoMycarParkingOrderSyncRequest request = new AlipayEcoMycarParkingOrderSyncRequest();
 //SDK已经封装掉了公共参数，这里只需要传入业务参数
 //此次只是参数展示，未进行字符串转义，实际情况下请转义
 request.setBizContent("{" +
 "\"user_id\":\"2088006362935583\"," +
 "\"out_parking_id\":\"201605061278654\"," +
 "\"parking_name\":\"上海证大五道口地下停车场\"," +
 "\"car_number\":\"浙Axxxxx\"," +
 "\"out_order_no\":\"201605061278654435466567\"," +
 "\"order_status\":\"1\"," +
 "\"order_time\":\"2016-08-12 20:27:30\"," +
 "\"order_no\":\"7674879087745646586\"," +
 "\"pay_time\":\"2016-08-12 23:20:23\"," +
 "\"pay_type\":\"1\"," +
 "\"pay_money\":\"20.00\"," +
 "\"in_time\":\"2016-08-12 20:20:13\"," +
 "\"parking_id\":\"1234567890123456\"," +
 "\"in_duration\":\"320\"," +
 "\"card_number\":\"2357868977445645645656\"" +
 "}");//业务数据
 try {
 AlipayEcoMycarParkingOrderSyncResponse response = client.execute(request);
 //判断调用是否成功
 if(response.isSuccess()){
 //获取相应数据
 Map<String,String> responseParams = response.getParams();
 //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
 }else{
 //调用失败处理逻辑
 }
 } catch (AlipayApiException e) {
 // TODO Auto-generated catch block 
 //调用异常逻辑处理
 e.printStackTrace();
 }

订单信息修改

在用户对停车订单有疑议而产生申诉，退款完成的场景下，服务商订单状态发生改变，为确保订单状态的一致性，服务商需要修改交易状态为支付成功的订单，通过接口 alipay.eco.mycar.parking.order.update（订单更新接口），将订单的状态变化信息同步到停车平台。

调用接口时序图

**
**

示例代码

//实例化客户端 
    AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY); 
    //实例化具体API对应的request类,类名称和接口名称对应, alipay.eco.mycar.parking.order.update 
    AlipayEcoMycarParkingOrderUpdateRequest request = new AlipayEcoMycarParkingOrderUpdateRequest(); 
    //SDK已经封装掉了公共参数，这里只需要传入业务参数 
    //此次只是参数展示，未进行字符串转义，实际情况下请转义 
    request.setBizContent("{" + 
        "\"user_id\":\"2088006362935583\"," +
        "\"order_no\":\"PO20160805204323394865\"," + 
        "\"order_status\":\"1\"" + "}");//业务数据

 try {
 AlipayEcoMycarParkingOrderUpdateResponse response = client.execute(request);
 //判断调用是否成功
 if(response.isSuccess()){
 //获取相应数据
 Map<String,String> responseParams = response.getParams();
 //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
 }else{
 //调用失败处理逻辑
 }
 } catch (AlipayApiException e) {
 // TODO Auto-generated catch block 
 //调用异常逻辑处理
 e.printStackTrace();
 }

停车场信息查询

停车服务商可调用 alipay.eco.mycar.parking.parkinglotinfo.query（停车场信息查询接口）通过支付宝停车平台车场 ID 或服务商外部车场 ID 查询自己名下的停车场信息。服务商只能查询正在调用接口的商家自己创建的停车场，即归属在当前服务商 PID下的车场。

调用接口时序图

**
**

示例代码

//实例化客户端
 AlipayClient client = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do",APP_ID,APP_PRIVATE_KEY,"json","UTF-8",ALIPAY_PUBLIC_KEY);
 //实例化具体API对应的request类,类名称和接口名称对应, alipay.eco.mycar.parking.parkinglotinfo.query
 AlipayEcoMycarParkingParkinglotinfoQueryRequest request = new AlipayEcoMycarParkingParkinglotinfoQueryRequest();
 //SDK已经封装掉了公共参数，这里只需要传入业务参数
 //此次只是参数展示，未进行字符串转义，实际情况下请转义
 request.setBizContent("{" +
 "\" parking_id \":\" PI1535687028031821446\"," +
 "\" out_parking_id \":\"10000110001\"," +
 "}");//业务数据
 try {
 AlipayEcoMycarParkingParkinglotinfoQueryResponse response = alipayClient.execute(request);
 //判断调用是否成功
 if(response.isSuccess()){
 //获取相应数据
 Map<String,String> responseParams = response.getParams();
 //通过返回数据进行业务处理，可以通过responseParams获取到返回的键值数据
 }else{
 //调用失败处理逻辑
 }
 } catch (AlipayApiException e) {
 // TODO Auto-generated catch block 
 //调用异常逻辑处理
 e.printStackTrace();
 }

停车场价格信息同步

停车服务商可以通过 alipay.eco.mycar.parking.chargeinfo.sync（停车场价格信息同步接口）向停车平台上报停车场收费价格信息，停车平台将在伙伴平台上进行车场收费信息展示，以便用户进行查询和决策。

调用接口时序图

示例代码

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayEcoMycarParkingChargeinfoSyncRequest request = new AlipayEcoMycarParkingChargeinfoSyncRequest();
request.setBizContent("{" +
"\"parking_id\":\"PI20190506152394234234\"," +
"\"is_charge\":\"1\"," +
"\"parking_space_count\":1600," +
"\"business_hours\":\"24小时\"," +
"\"has_charging_pile\":\"1\"," +
"\"free_period\":\"30分钟\"," +
"\"daily_price_upperbound\":\"260元或不封顶\"," +
"\"daylight_business_hours\":\"9:00-21:00\"," +
"\"night_business_hours\":\"21:00-9:00\"," +
"\"car_daylight_base_price\":\"10元/1小时或5元/30分钟\"," +
"\"car_daylight_advanced_price\":\"3元/小时或1.5元/30分钟\"," +
"\"car_night_base_price\":\"10元/1小时或5元/30分钟\"," +
"\"car_night_advanced_price\":\"3元/小时或1.5元/30分钟\"," +
"\"truck_daylight_base_price\":\"10元/1小时或5元/30分钟\"," +
"\"truck_daylight_advanced_price\":\"3元/小时或1.5元/30分钟\"," +
"\"truck_night_base_price\":\"3元/小时或1.5元/30分钟\"," +
"\"truck_night_advanced_price\":\"3元/小时或1.5元/30分钟\"," +
"\"car_onetime_price\":\"20元/次\"," +
"\"truck_onetime_price\":\"30元/次\"," +
"\"remark\":\"前3小时XXX，3-6小时之间XXX，超过6小时XXXX\"" +
"  }");
AlipayEcoMycarParkingChargeinfoSyncResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

停车场车位信息同步

停车服务商可以通过 alipay.eco.mycar.parking.spaceinfo.sync（停车场车位信息同步接口）实时向停车平台上报停车场车位使用信息，停车平台将在伙伴平台上进行车场空闲车位信息展示，以便用户进行查询和决策。

调用接口时序图

示例代码

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayEcoMycarParkingSpaceinfoSyncRequest request = new AlipayEcoMycarParkingSpaceinfoSyncRequest();
request.setBizContent("{" +
"\"parking_id\":\"PI20190506152394234234\"," +
"\"free_parking_space\":500," +
"\"free_charging_pile\":30," +
"\"parking_space_status\":\"1\"" +
"  }");
AlipayEcoMycarParkingSpaceinfoSyncResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

上线

自测验收完毕之后，服务商停车缴费业务即可自动上线。点此了解停车缴费页面设计建议规范。

说明：服务商本身应用上线时候，也要把支付宝开放平台-我的应用上线。

接口调用注意事项

接口英文名称	接口中文名称	注意事项
alipay.eco.mycar.parking.parkinglotinfo.create	录入停车场信息	支付宝根据所上传的信息分配的带有支付宝标识的停车场 id，调用成功会返回 parking_id。注意：和服务商所定义的停车场 id 不是同一个。录入停车场坐标，请使用高德地图定位地址，长度不能超过接口文档规定范围。
alipay.eco.mycar.parking.enterinfo.sync	车辆驶入接口	此时录入的停车场 id 为上传停车场时返回的parking_id。
alipay.eco.mycar.parking.exitinfo.sync	车辆驶出接口	此时上传的停车场 id 为上传停车场时返回的parking_id。
alipay.eco.mycar.parking.order.sync	订单同步接口	订单同步调用时请先用 auth_code 通过授权获取 token 和用户信息，同步订单时传入的用户 id 就是通过授权返回的用户 id。

接入指南

接口调用#

主要业务流程系统交互时序图#

服务商系统配置信息注册(查询)#

调用接口时序图#

示例代码#

入参说明#

停车业务配置信息#

示例代码#

﻿停车业务配置信息查询#

示例代码#

﻿入参说明#

服务商停车场信息注册或者修改#

调用接口时序图#

录入停车场信息#

示例代码#

﻿停车场信息修改#

示例代码#

用户车辆驶入(车辆驶出)停车场车辆信息同步#

调用接口时序图#

车辆驶入信息同步#

示例代码#

入参说明#

﻿车辆离场信息同步#

示例代码#

﻿入参说明#

用户查询车辆停车费用#

调用接口时序图#

示例代码#

入参说明#

﻿获取用户车牌信息#

示例代码#

﻿入参说明#

﻿出参说明#

﻿停车业务订单信息同步#

调用接口时序图#

示例代码#

订单信息修改#

调用接口时序图#

示例代码#

停车场信息查询#

调用接口时序图#

示例代码#

﻿停车场价格信息同步#

调用接口时序图#

示例代码#

停车场车位信息同步#

调用接口时序图#

示例代码#

上线#

接口调用注意事项#

接口调用

主要业务流程系统交互时序图

服务商系统配置信息注册(查询)

调用接口时序图

示例代码

入参说明

停车业务配置信息

示例代码

停车业务配置信息查询

示例代码

入参说明

服务商停车场信息注册或者修改

调用接口时序图

录入停车场信息

示例代码

停车场信息修改

示例代码

用户车辆驶入(车辆驶出)停车场车辆信息同步

调用接口时序图

车辆驶入信息同步

示例代码

入参说明

车辆离场信息同步

示例代码

入参说明

用户查询车辆停车费用

调用接口时序图

示例代码

入参说明

获取用户车牌信息

示例代码

入参说明

出参说明

停车业务订单信息同步

调用接口时序图

示例代码

订单信息修改

调用接口时序图

示例代码

停车场信息查询

调用接口时序图

示例代码

停车场价格信息同步

调用接口时序图

示例代码

停车场车位信息同步

调用接口时序图

示例代码

上线

接口调用注意事项