提交车场进件

省市区参数

本文中的接口凡涉及省市区参数的，分位两类传递：

1. 传递省市区编码，编码参考附件“area_code.json”
2. 传递省市区名称，名称参考同上

参数具体传递类型，可参考参数说明及示例。

关于附件"area_code.json"说明：

该文件为JSON格式的省市区树形结构数据，其中code字段即为我们需要的编码，type类型字段定义为：

1. 省份
2. 城市
3. 地区

2.3 银行参数

本文中接口的银行参数主要包括：

1. 银行名称
2. 支行名称
3. 银行所在省份（传递名称）
4. 银行所在城市（传递名称）

以上四个参数具有关联性，且银行名称，支行名称需在附件“银行信息列表_20200603.xls”所列的银行名单内。

2.4 时间格式

P云接口需要传递日期/时间的参数，统一采用UTC时间格式，即“yyyy-MM-ddTHH:mm:ssZ”这种格式，例如：2018-12-10T16:00:00Z

对于身份证以及营业执照一类需要表示长期有效的截止时间字段，我们约定传参数“LONG_TERM”

3. 停车场进件接口：

3.1 停车场创建接口

https://api.4pyun.com/gate/1.0/park/apply

• 说明：创建停车场并配置支付渠道，如仅创建车场，可不传支付渠道配置相关参数，支付渠道可在P云管理平台提交申请配置。
• 请求方法：POST
• 请求参数：

• 请求示例：

    {
      "address":"讯美科技广场",
      "api_key":"D127h16FSDF",
      "api_park_uuid":"TD1232423",
      "app_id":"op02759c5493c7bf6",
      "apply_channel_type":"5",
      "bank_account":{
          "account_number":"283487234234",
          "account_type":"0",
          "account_branch":"中国银行深圳市分行",
          "account_name":"丁华娱乐有限公司",
          "account_bank":"中国银行",
          "account_province":"广东省",
          "account_city":"深圳市"
      },
      "business_licence":{
          "business_name":"丁华娱乐有限公司",
          "business_legal_person":"万丁华",
          "business_licence_expire":"LONG_TERM",
          "business_licence_img":"https://files.4pyun.com/d/80eaf09a9c",
          "business_licence_no":"PK124234234",
          "business_licence_effect":"2001-01-01T00:00:00Z",
          "business_register_address":"广东省深圳市讯美科技广场"
      },
      "city_code":"440300",
      "district_code":"440305",
      "manager_name":"徐先生",
      "manager_telephone":"15914040963",
      "park_name":"测试_XZF16",
      "province_code":"440000",
      "total_parking_space":"5"
    }
  

• 返回参数：

• 返回示例

    {
      "code":"1001",
      "data_node":"ChinaRoad-007",
      "seqno":"Hnms4EmUgFZ18TGm",
      "payload":{
          "parkUuid":"e06757cf-5694-4111-b2b3-269fa6c68f28",
          "manager_account":{
              "login_url":"https://mch.4pyun.com",
              "password":"15914040963",
              "name":"徐先生",
              "merchant":"22803716",
              "account":"15914040963"
          },
          "park_code":"22803716"
      }
    }
  

3.2 停车场查询接口

https://api.4pyun.com/gate/1.0/park/apply

• 说明：查询停车场信息，包含支付渠道配置信息
• 请求方法：GET
• 请求参数：

• 请求示例：

    https://api.4pyun.com/gate/1.0/park/apply?app_id=op72****24&park_uuid=e24deadf-1aa0-4643-bde5-f9c474c4f5f5&sign=D536C1408BE54554765B26A96126E62D
  

• 返回参数：

• 返回示例

    {
      "code":"1001",
      "data_node":"HS1-1",
      "seqno":"d98b78fcc8c60ce3",
      "payload":{
          "enter_gate_image":"",
          "park_image":"",
          "address":"广东省深圳市南山区讯美科技广场",
          "leave_gate_image":"",
          "city_code":"440300",
          "park_code":"70552772",
          "manager_telephone":"15914040963",
          "province_code":"440000",
          "park_name":"测试_XZF14-停车场",
          "channel_config":[
              {
                  "type_id":1,
                  "name":"微信对公",
                  "channel":[
                      {
                          "pay_mode":3,
                          "type_id":1,
                          "name":"扫码支付",
                          "channel_code":"200201",
                          "status":0
                      },
                      {
                          "pay_mode":3,
                          "type_id":1,
                          "name":"微信车主服务",
                          "channel_code":"300005",
                          "status":0
                      }
                  ]
              },
              {
                  "type_id":2,
                  "name":"微信对私",
                  "channel":[
                      {
                          "pay_mode":11,
                          "type_id":2,
                          "name":"扫码支付",
                          "channel_code":"200201",
                          "status":0
                      }
                  ]
              },
              {
                  "type_id":3,
                  "name":"支付宝对公",
                  "channel":[
                      {
                          "pay_mode":4,
                          "type_id":3,
                          "name":"扫码支付",
                          "channel_code":"100102",
                          "status":0
                      },
                      {
                          "pay_mode":4,
                          "type_id":3,
                          "name":"支付宝车主服务",
                          "channel_code":"300004",
                          "status":0
                      }
                  ]
              },
              {
                  "type_id":4,
                  "name":"支付宝对私",
                  "channel":[
                      {
                          "pay_mode":12,
                          "type_id":4,
                          "name":"扫码支付",
                          "channel_code":"100102",
                          "status":0
                      }
                  ]
              },
              {
                  "type_id":5,
                  "name":"P云聚合支付",
                  "channel":[
                      {
                          "pay_mode":1,
                          "type_id":5,
                          "name":"微信扫码",
                          "channel_code":"200201",
                          "status":-1
                      },
                      {
                          "pay_mode":1,
                          "type_id":5,
                          "name":"微信无感",
                          "channel_code":"300005",
                          "status":-1
                      },
                      {
                          "pay_mode":1,
                          "type_id":5,
                          "name":"支付宝扫码",
                          "channel_code":"100102",
                          "status":-1
                      },
                      {
                          "pay_mode":1,
                          "type_id":5,
                          "name":"支付宝无感",
                          "channel_code":"300004",
                          "status":-1
                      }
                  ]
              }
          ],
          "applicant":"P云测试厂商",
          "channel_type_config":[
              {
                  "apply_sign_url":"",
                  "type_id":1,
                  "apply_no":"",
                  "name":"微信对公",
                  "status":0
              },
              {
                  "apply_sign_url":"",
                  "type_id":2,
                  "apply_no":"",
                  "name":"微信对私",
                  "status":0
              },
              {
                  "apply_sign_url":"",
                  "type_id":3,
                  "apply_no":"",
                  "name":"支付宝对公",
                  "status":0
              },
              {
                  "apply_sign_url":"",
                  "type_id":4,
                  "apply_no":"",
                  "name":"支付宝对私",
                  "status":0
              },
              {
                  "apply_sign_url":"",
                  "type_id":5,
                  "apply_no":"C202002287363",
                  "name":"P云聚合支付",
                  "status":3
              }
          ],
          "manager_name":"徐先生",
          "api_key":"DO29h38FSDF",
          "district_code":"440305",
          "api_park_uuid":"TD1232423",
          "supplier":{
              "name":"P云测试厂商",
              "merchant":"PV376764",
              "type":2
          },
          "total_parking_space":5,
          "charge_image":"",
          "tech_provider":{
              "code":"PO6277",
              "require_param":1,
              "name":"腾达智能",
              "alias":"",
              "status":1
          }
      }
    }
  

4. 支付渠道申请链接：

4.1 链接传参说明

跳转链接示例：https://b.4pyun.com/external/channel/list?app\_id=op01958c1095c8bf4&merchant=PV123422&api\_park\_uuid=WDH123456&token=Basic%20eyJpc3MiOiJvcDAxOTU4YzEwOTVjOGJmNCIsImlhdCI6MTU5NDcwOTk1MCwiZXhwIjoxNTk0Nzk2MzUwfQ%3D%3D.99AD7461C82A43907388EE00D3801702

说明：跳转链接前需保证车场已在平台创建(调用3.1 停车场创建接口)

URL: https://b.4pyun.com/external/channel/list

参数：

• app_id: 平台分配应用ID
• merchant: 平台分配厂商编码
• api_park_uuid: 第三方车场ID
• token: 请求令牌

4.2 令牌生成规则

let content = JSON.stringify({
                iss: 'op01958c1095c8bf4', // 应用ID
                iat: (+new Date() / 1000).toFixed(0), // 令牌生成时间戳(单位秒)
                exp: ((+new Date() + 24 * 60 * 60 * 1000) / 1000).toFixed(0), // 令牌过期时间(单位秒)
            })
let secret = "79B0F3E6E956A6F272D9E74FABD95EDE"; //应用ID密钥
let signature = MD5.hashBinary(content + "&key=" + secret); // 生成签名
let token = "Basic " + Base64.encode(content) + "." + signature; //生成令牌(注意"Basic"后有一空格)
token = encodeURI(token) // UrlEncode