一、名词解释

二、业务简介

基于停车行业，面向停车场业主方及车主用户，支付宝提供资金归集和各种形式的支付缴费（用户支付宝APP主扫在线缴费，用户支付宝APP被扫缴费，无感支付(代扣)，商户APP支付），同时提供生活号粉丝精准运营、会员卡发放，营销发券、扫码领红包，自助缴费机扫码找零，口碑综合体异业营销，电子发票等系列底层能力。帮助停车行业ISV和业主有效开展业务，提供更好的服务。

三、业务场景

根据停车缴费发生场景主要分为三种：场内扫码付，岗亭扫码收银，场外代扣

1、场内扫码付

     该场景缴费为车主在即将离场时，通过用支付宝APP扫停车场物料二维码弹出H5网页进行查询缴费。若有消息通知到车主支付宝APP，也可通过消息的链接打开H5网页进行查询缴费。车主缴费完成后，系统通知到收银员，车主出站时实现收银员或闸道自动抬杆。该场景基于H5页面，目前主要有三种接入方式：支付宝停车缴费平台、生活号、小程序

      a.支付宝停车缴费平台，该平台为支付宝APP提供的给车主停车缴费的统一交互页面。停车ISV无需开发H5页面，只需要将车场、停车数据等通过停车缴费接口传到支付宝，用户即可访问自己的停车数据。当车主用户离场点击缴费时，自动跳转ISV自己的H5缴费页面进行支付。该方式所有车场的物料一致，扫物料二维码所打开的页面都是停车缴费页面：

支付宝APP首页->更多->车主服务->停车缴费，手机上可通过以下scheme跳转alipays://platformapi/startapp?appId=2018031302367666&page=pages/index/index&chInfo=ch_carservice

      停车缴费平台时，parking_poiid在高德的获取方式如下：

            α.通过高德在线地图选点获取

            β.通过高德API接口DEMO工具，输入“地址”后“运行”获取

            γ.通过开发者开发对接高德API接口来获取

            δ.若停车场在高德查不到，则可通过高德新增地址的方式，48小时后生效。 

            高德新增兴趣点：http://map.amap.com/help/index.html?type=addpoi

            高德的400电话：400 810 0080

      停车缴费接入文档

       b.生活号，ISV通过开通自己的生活号，并完成生活号的各种功能和服务的配置，来运营自己的车主粉丝。

      生活号接入文档

       c.小程序，小程序是运行在支付宝客户端，开放了支付宝APP内一些JSAPI和OpenAPI原生能力，可以被便捷地获取和传播，为终端用户提供更优的用户体验。一次开发，同时可以跨安卓和IOS平台，适用所有支付宝APP装机用户。有自有APP或打算做APP的ISV可考虑小程序接入。

      小程序接入文档

2、岗亭扫码收银

     该场景主要用于车场未开通H5页面系统，通过为岗亭收银员提供扫码枪连接收银系统来进行当面付扫码扣款。或单独的POS机扫码收费形式。车主当面支付成功后离场。

      当面付接入文档

3、场外代扣

     也称无感支付，车主开车进入车场时，通过摄像头借助OCR等技术自动识别车牌，判断该车牌对应支付宝车主是否签约代扣业务，若车主已开通代扣业务，在出场时根据自动计费规则，通过代扣的方式自动扣除业主的停车费。做到车主出场时无需停车，自动抬杆离场。代扣目前主要分三种：商户代扣、信用代扣(在商户代扣的基础上结合芝麻信用)、停车平台代扣(又称多费率代扣）。

      a.商户代扣，该代扣为用户和商户进行签约，商户可通过用户的签约协议号请求支付宝进行代扣金额支付。该代扣仅能在代扣签约商户下进行代扣收款（即该代扣签约关系为用户和商户）。需联系支付宝BD签约。

      商户代扣接入文档

      b.停车平台代扣，又称多费率代扣，该代扣为用户和支付宝停车平台签约代扣，可在停车平台的所有停车场进行代扣收款（即该代扣签约关系为用户和支付宝停车平台）。需联系支付宝BD签约。

      注意事项

       1）代扣的订单，有最终结果时（成功，失败）要通过订单同步接口同步给停车平台；
       2）代扣接口返回非成功的，都需要通过查询接口明确订单状态；
       3）退款接口只能退代扣成功（已同步给停车平台）的订单。

      停车代扣接入文档

    注：代扣存在一定的扣款失败风险，建议离场时先判断代扣是否成功再行抬杆。对于商户和ISV有自己的风险控制能力的，可自行设计抬杆和代扣的先后逻辑。

四、集成说明

ISV接入必读（第三方平台接入蚂蚁开放平台的的完整介绍，包含签约模式、代运营、开发模式、返佣、对账等详细介绍）

  1、ISV在集成过程中，建议走第三方应用授权的模式，停车场商户和支付宝签约，签约完成后第三方应用授权给ISV，ISV即可用商户授权的app_auth_token调用各接口，包括支付接口可直接收款到商户账户（ISV可代商户签约支付产品，代商户创建生活号，查看我的商家）

  2、对于“场内扫码付”场景中，用到了H5页面在线缴费的支付时，建议使用当面付在线支付的方案进行收费，不推荐使用WAP支付，（由于WAP支付不支持第三方应用授权的模式，收款时只能收款到调用者自己的账户，ISV调用就只能收款到ISV自己的账户。当面付支持第三方应用授权的模式，支持ISV通过app_auth_token调用来直接收款到商户的账户）

  3、在手机端外部APP唤起支付宝APP并打开指定页面url地址。alipays://platformapi/startapp?appId=20000067&url=https%3A%2F%2Fwww.baidu.com   （其中20000067为固定值，url的值为需要打开的页面地址做url编码，java伪代码："alipays://platformapi/startapp?appId=20000067&url=" + URLEncoder.encode(s1, "utf-8");）

  4、扫码找零解决方案（车主在停车场内自助缴费机上现金缴费，找零时车主通过扫码，自助缴费机自动找零到车主支付宝账户）

    a.通过用户信息授权（scope="auth_base”静默授权，页面不弹框提示获取到支付宝用户user_id）

    b.通过获取到的user_id调用 单笔转账到支付宝账户接口 进行找零给用户。

  5、停车行业支付接口参数规范

备注：

    a.原则上“场地名称,车牌号,入场时间”中的3项内容商户都需要填写，有特殊情况导致某项内容无法填写时，比如“车牌号”无法获取时，该项内容可以留空。

范例如：杭州庆春银泰,,2016-01-24 03:07:50

    b.入场时间格式为：yyyy-MM-dd HH:mm:ss

  6、异步通知特性（文档）

• 什么情况下发起通知：当支付宝交易系统中存在该交易，并且该交易状态发生变化时，才可能发起通知。如用户扫码创建订单后支付宝发起交易创建通知，用户付款成功后发起交易成功通知等。
• 如何获取通知信息：支付宝通过HTTP POST方法，以表单的形式通知消息，开发者可以通过获取表单参数的形式获取对应字段值。如获取交易状态字段（trade_status）可参考如下方法，java参考request.getParameter("trade_status")；asp参考reques.Form("trade_status")；php参考$_POST['trade_status']。
• 商户接收通知地址的要求：通知地址公网可访问，且仅支持80和443端口，地址形式如 https://www.test.com/pay/notify。对于https地址，商户证书必须为认证机构颁发的证书，不可使用非授信组织颁发的测试证书，如不可使用自行颁发的证书。
• 如何判断交易成功：首先签名(sign)必须验证通过，其次判断交易状态(trade_status)必须为支付成功状态（如TRADE_STATUS），此时可保证该通知为支付宝支付成功通知。在此基础上，可以额外判断订单号是否在商户系统存在、订单金额是否与下单时金额一致等，以加强订单相关一致性校验。
• 处理通知后如何返回：如果商户系统处理业务成功，则返回success字符串。否则返回其他信息、抛异常或者无返回，支付宝均会认为商户系统处理失败，并进行重复通知。
• 如何重复通知：当第一次通知失败后，支付宝以4m,10m,10m,1h,2h,6h,15h的时间间隔，在25小时内完成8次通知，以防止通知丢失等异常情况。
• 关于通知无序性说明：由于互联网中存在拥塞、丢包、重发等现象，所以支付宝异步通知可能在极端情况下以未定义的顺序到达商户服务端，比如在开启了通知用户支付中和通知交易成功的情况下，可能用户支付中的通知处理失败导致触发支付宝重发支付中通知，又或可能存在由于网络延时、丢包等原因，导致商户系统接收到交易成功通知后，接收到相同交易的交易创建通知（甚至重复接收到支付成功通知），此时需要商户端对支付成功通知做且仅做一次成功业务的处理。

   7、若接入了 “停车缴费” 或 “停车代扣”，上线前按如下流程验收，具体检查项可查看checklist。

       1）验收前，需按如下配置连接到停车平台预发环境。
           （a)先绑定host:开放平台预发网关地址103.52.199.48 openapipre.alipay.com #openapi
            (b)使用生产环境的正式账户PID
      2）验收共分三道，包含修改、复验的时间，大约2个工作日；

           验收通过后，才能申请SPI和特色服务配置，流程通常2个工作日；

  8、支付成功页推荐默认关注生活号设置

  设置后客户端默认关注规则：

    a.用户支付金额 >=2 元； （订单金额）
    b.用户对该生活号曾经主动取消过关注的，不默认勾选；
    c.该生活号当前粉丝数 > 50 万，不默认勾选。有特殊情况需专门申请；
    d.只要用户不主动取消勾选的，用户点击“完成”、离开页面等情况，均默认为用户关注该生活号

  9、运营上可以支持自核销和支付宝核销两种方式营销配券活动：

• 支付宝端核销的方式：通过支付宝提供的运营中心平台自行创建营销活动（支持代金券、折扣券、兑换券），无需系统开发，创建后通过二维码或链接的方式，商户自行选择露出的方式，让用户主动领取。领取后用户下次支付宝支付时自动核销。
• 商户端自有营销系统核销的方式：如果ISV自有营销系统，则可以使用支付宝的卡券能力（alipass），将优惠券推送至支付宝的卡包中，提高券露出，增强用户对券的感知，方便用户选择核销。该模式券的核销在商户的营销系统，核销后同步更改支付宝端券状态。

  10、对账单获取，目前对账单包含了业务账单和资金账单，当面付产品、APP支付、手机网站支付等含有业务账单，代扣类产品（商户代扣、停车代扣）无业务账单，仅含有资金账单。（对于没有业务账单的，请参考资金账单对账）。对应到接口参数即为"bill_type":"signcustomer"表示资金账单，"bill_type":"trade"为业务账单。

• 账单获取接口仅能下载调用APPID对应的PID作为收款账号的账单数据，若需要下载非当前APPID对应PID账号下的账单数据，需经过第三方应用授权。详见本文第三方应用授权。
• 确认当前APPID是否具备账单获取接口的权限，该接口附随“当面付”“商户代扣”产品一起开通，若签约了如上两个产品之一，即有相应权限。若无签约以上接口，可通过开放平台自助签约“当面付产品”即可（已签约，则可在相应应用APPID下自行“添加功能”）。

   11、ISV开发完自己的蚂蚁应用后，可选择通过服务市场将产品以服务的形式发布到蚂蚁服务市场来推广售卖自己的产品，同时商户也可以通过蚂蚁服务市场(https://fw.alipay.com)订购ISV发布的各种服务。

五、返佣传参说明

1、ISV身份识别传参

  a、 联系支付宝业务BD进行后台签约返佣协议。
  b、 isv必须采用独立的支付宝账号入驻开放平台，该账号（下简称服务商PID）专门用于

    ♦ 签约返佣协议

    ♦ 做为各支付接口的返佣埋点参数传递(该PID不能作为收款账号)

    ♦ 2.0接口(接口请求地址为openapi.alipay.com)返佣参数为："extend_params":{"sys_service_provider_id":"2088012345678912"}

    ♦ 1.0接口(接口请求地址为mapi.alipay.com)返佣参数为：extend_params={"AGENT_ID":"2088012345678912"}

    ♦系统更新后可输入交易号通过自助云排查工具查看sys_service_provider_id：https://openmonitor.alipay.com/acceptance/cloudparse.htm

    ♦ alipay.eco.mycar.parking.order.pay接口较特殊，返佣参数为："agent_id":"2088012345678912"。该接口可通过ISV打印本地日志进行查看，自助云排查工具无法查。

  c、 返佣账单对账、结算开票

服务商使用返佣签约账户登录 开放平台—服务商中心—协作费管理—账单管理：https://mbillexprod.alipay.com/enterprise/cooperationFeeUnsettleBillQuery.htm

如果isv的业务中，停车费是由isv账号收取，而非业主方账号收取，则上述第2条尤其需要注意！
【业务收款账号】与【接收返佣账号】必须是【两个不同的账号】，否则无法收到返佣！

2、停车场订单识别传参 

♦ 停车订单埋点参数仅适用于支付产品2.0(支付请求地址为openapi.alipay.com的即为2.0)

♦ 对于支付产品1.0（(支付请求地址为mapi.alipay.com的即为1.0）,建议先将支付接口升级到对应的2.0。

♦ 对于同一笔停车订单多笔支付交易，返佣只记录一笔交易。如：同一个辆车，同一时间的一个停车订单，先后发起了两笔支付请求，最后成功支付了一笔的场景，返佣只记录一笔交易。

各支付产品列表如下：

停车场订单埋点参数：industry_reflux_info(此参数为各2.0支付产品接口中extend_params的下级参数，包含在biz_content中，且特别注意industry_reflux_info为字符串，而非jason对象)

industry_reflux_info参数填充内容

scene_data参数说明

/**
 * 停车订单传参测试
 */
public class AlipayTradeCreateTest {
	
	private static final Logger logger = LoggerFactory.getLogger(AlipayTradeCreateTest.class);
	
	@Test
	public void tradeCreate() throws Exception {
		
		AlipayTradeCreateRequest request = new AlipayTradeCreateRequest();
        
		//refluxInfo参数
	    Map<String, Object> refluxInfoMap = new HashMap<String, Object>();
	    Map<String, Object> sceneDataMap  = new HashMap<String, Object>();
  	    refluxInfoMap.put("scene_code", "parking_fee_order");
  	    refluxInfoMap.put("channel", "common_park_provider");
  	    sceneDataMap.put("license_plate", "浙A3DK19");
  	    sceneDataMap.put("start_time", "2017-06-13 17:30:26");
  	    sceneDataMap.put("parking_lot_id", "PI1509464128728884840");
  	    sceneDataMap.put("parkling_lot_name", "山下停车场");
  	    sceneDataMap.put("city_code", "310000");
  	    refluxInfoMap.put("scene_data", sceneDataMap);
  	  
  	    String refluxInfoString = JSON.toJSONString(refluxInfoMap);
  	    logger.info("refluxInfoString: {}",refluxInfoString);
  	    
  	    //extendParams参数
  	    Map<String, Object> extendParamsMap = new HashMap<String, Object>();
	    
	    extendParamsMap.put("sys_service_provider_id", "2088012345678912");
	    extendParamsMap.put("industry_reflux_info", refluxInfoString);
	    
	    //bizContent参数
	    Map<String, Object> bizContentMap = new HashMap<>();
	    bizContentMap.put("out_trade_no", RandomUtils.getRandomRequestId());
	    bizContentMap.put("buyer_id","2088012345678912");//支付授权码,扫到的条码
	    bizContentMap.put("subject","统一支付");//
	    bizContentMap.put("total_amount","0.01");//
	    bizContentMap.put("body","统一支付测试");
	    bizContentMap.put("timeout_express","5m");
	    bizContentMap.put("extend_params", extendParamsMap);
	    
        request.setBizContent(JSON.toJSONString(bizContentMap));
	    
        logger.info("bizContent: {}",request.getBizContent());
        
	    DefaultAlipayClient alipayClient = new DefaultAlipayClient(AlipayConfig.URL, AlipayConfig.APPID, AlipayConfig.RSA_PRIVATE_KEY, AlipayConfig.FORMAT, AlipayConfig.CHARSET, AlipayConfig.ALIPAY_PUBLIC_KEY,AlipayConfig.SIGNTYPE);

        AlipayTradeCreateResponse response = alipayClient.execute(request);

        logger.info("responseBody: {}",response.getBody());
        if(response.isSuccess()){
        	logger.info("调用成功,返回的支付宝订单号:"+response.getTradeNo());
        } else {
        	logger.info("调用失败");
        }
	}
}

HTTP请求样例：

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.trade.precreate&app_id=2018123456789012&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=

{
"extend_params": {
"sys_service_provider_id": "2088012345678912",
"industry_reflux_info": "{\"scene_data\":{\"start_time\":\"2017-06-13 17:30:26\",\"license_plate\":\"浙A3DK19\",\"parkling_lot_name\":\"山下停车场\",\"city_code\":\"310000\",\"parking_lot_id\":\"PI1509464128728884840\"},\"channel\":\"common_park_provider\",\"scene_code\":\"parking_fee_order\"}"
},
"out_trade_no": "2018032216442400349105",
"total_amount": "0.01",
"subject": "统一支付",
"timeout_express": "5m",
"buyer_id": "2088012345678912",
"body": "统一支付测试"

} 

城市编码：http://aopsdkdownload.cn-hangzhou.alipay-pub.aliyun-inc.com/doc/2016.xls?spm=a219a.7395905.0.0.QFyjQL&file=2016.xls

返佣自查：

1、是否签约过返佣协议：请用支付宝账号登录b.alipay.com-产品中心中查看是否签约了返佣协议【停车行业激励方案（后台）】；
2、是否做了正确的交易埋参：请查看是否按照政策接入文档中的交易埋参文档做了正确交易埋参:
  2.1 通过自助云排查工具(附：工具使用说明文档)输入APPID、产品功能、接口名、请求日期、请求时间 进行日志查询
  2.2 根据查询结果查看是否含有如下字段信息，若不存在可参考停车场订单识别传参文档和示例修改代码
      · extend_params字段存在且为jason对象
      · sys_service_provider_id字段存在且为字符串
      · industry_reflux_info字段存在且为字符串（以及start_time、license_plate、parkling_lot_name、city_code、parking_lot_id 5个字段都必须存在且格式为字符串）
3、是否提交过基础接入和标杆接入的报名：
  3.1 基础报名提交地址：https://mycar-parkingplatform.alipay-eco.com/pbizplatform/parking/main/home；
  3.2 标杆提交地址：登录手机或电脑版钉钉-点击菜单栏【开放平台】-点击【审批】，提交【停车场标杆项目申请】报名；
4、什么时候出返佣账单：返佣账单一般会在次月25号左右出来 ，查询路径：open.alipay.com-服务商中心-协作费管理-账单管理
5、怎么结算全部返佣款项：详情参考【开放平台业务协作费结算规则细则】https://docs.open.alipay.com/rules_basic/pvtnyn
6、以上都查了，返佣还是不对，如何申诉：开放平台-服务商中心-账单管理-详情-问题反馈

六、营销传参说明

1、营销活动识别传参

  a、 支付宝运营活动统一配置规则参数标准：复用现有营销平台己配置的参数“parking_id”(即alipay.eco.mycar.parking.parkinglotinfo.create(录入停车场信息)，获得支付宝停车场parking_id)，根据接口中上传的parking_id信息匹配营销规则，没有parking_id根据“ISV 名称+车场名称”匹配营销规则，请保证填写准确无误。

  b、 各接口对接说明（请求参数中请加入如下示例参数，parking_id根据实际情况填写）

    ♦ 2.0接口(接口请求地址为openapi.alipay.com，如alipay.trade.pay)营销参数为："promo_params":{"parking_id":"XXXXXXXXXXXXXXX"}

    ♦ 1.0接口(接口请求地址为mapi.alipay.com，如alipay.acquire.createandpay)营销参数为：promo_params={"parking_id":"XXXXXXXXXXXXXXX"}

上述2.0和1.0接口系统更新后可通过自助云排查工具：https://openmonitor.alipay.com/acceptance/cloudparse.htm(附：工具使用说明文档，云排查开发者社区)输入APPID、产品功能、接口名、请求日期、请求时间进行日志查询，根据查询结果查看是否含有如下字段信息：promo_params字段存在且为json对象，parking_id的值是否填写正确。

    ♦ alipay.eco.mycar.parking.order.pay接口营销参数为："promo_params":{"parking_id":"XXXXXXXXXXXXXXX"}

注意该接口可通过ISV打印本地日志进行查看，自助云排查工具无法查看。

2、营销活动补充说明

a、 参与正式活动前请做好开发测试、优惠验证工作，确保传递参数准备无误，享受到正确的优惠，避免出现用户误解或者不必要的用户投诉。

b、 了解更多运营方法和运营支持政策，请加入支付宝停车解决方案官方钉钉群：

七、综合体营销打通传参说明

1、签约准备：停车场开通支付宝账号，并签约“当面付”，“停车缴费”产品。
2、配置准备：在支付宝开放平台应用中添加"当面付","停车缴费"的功能权限。
3、停车ISV接入停车平台：https://docs.open.alipay.com/296/106089/。（若未接入停车平台，需联系支付宝停车BD安排停车平台技术对接）
4、停车场开店
     a.车场ISV工作：车场有入驻停车平台的支付宝停车场parking_id作为口碑的store_id；(即alipay.eco.mycar.parking.parkinglotinfo.create(录入停车场信息)，获得支付宝停车场parking_id)
     b.口碑服务商工作：通过车场ISV提供的store_id等信息进行开店，以及综合体圈店。(联系口碑BD开通"爱车"-"停车场"类目的开店白名单)
5、用户支付停车费时，停车ISV使用当面付在线支付(需传入"store_id":"parking_id的具体值)，即可参与口碑营销活动，如消费积分、口碑券核销等。

八、其他相关开放能力输出

会员卡产品接入

通过创建会员卡，并同步至支付宝卡包中增强露出和提高用户感知，会员卡中可展示相关权益和自自定义功能。

支付宝发奖接入指南

当前大红大紫的支付宝人传人红包商家版。支付宝出资的红包领取方案，可在支付宝客户端、其他客户端、APP支付聚合页等渠道露出，用户可通过链接、吱口令、手机号等不同方式领取红包。用户核销红包后，发放红包渠道的ISV可获得红包赏金，赏金直接进入ISV支付宝账号余额。

用户信息授权

第三方应用授权

JSAPI

支付宝APP内置浏览器环境内打开外部ISV和商户的H5页面时，可通过该JSAPI提供一些基础能力进行相关控制

闪电开票

支付宝闪电开票为商户提供了快速获取用户发票抬头的功能，省去用户繁琐的填写过程和减少出错概率，方便快速开票。支付宝钱包-发票管家为用户提供了新增、修改、删除发票抬头的功能，方便用户管理自己所有的发票抬头，免去后续所有填写工作。

 服务市场

开发者在蚂蚁金服开放平台开发应用功能，并将功能包装为服务进行发布，发布后服务会进入服务市场进行售卖。同时也可以将蚂蚁服务市场作为自身产品的一个推广售卖渠道。

九、遇到困难

• 系统上线前遇到问题可通过如下方式优先寻求帮助：
  • 自助云排查工具(附：工具使用说明文档)
  • 官网搜索问题知识库(技术支持)
  • 在线技术支持

• 系统上线正式运营后可通过如下渠道寻求售后保障帮助：
  • 在线咨询：https://cschannel.alipay.com/newPortal.htm?scene=mt_zczx （注意输入partner或签约支付宝账号，进入大客户通道）
  • 邮箱：techservices@alipay.com(工作日支持)
  • 电话咨询：0571-88158090

十、FAQ

Q：返佣参数如何传输，如何确认是否已传输。

A：请参考“停车行业接入指南”第五章节部分内容返佣传参说明：

https://open.alitrip.com/docs/doc.htm?&docType=1&articleId=108053#s5

Q：返佣对账时发现少了一笔交易，自行排查传参格式也没有问题。

A:对于同一笔停车订单多笔支付交易，返佣只记录一笔交易。如：同一个辆车，同一时间的一个停车订单，先后发起了两笔支付请求，最后成功支付了一笔的场景，返佣只算一笔交易。

Q：营销活动参数如何传输，如何确认是否已传输。

A：请参考“停车行业接入指南”第六章节部分内容营销传参说明：

https://open.alitrip.com/docs/doc.htm?&docType=1&articleId=108053#s6

Q：无法享受营销活动的优惠或折扣，自行排查传参格式也没有问题。

A：请与支付宝BD、运营同学联系确定已经成功报名参与了该项运营活动，并且协议签署无误（如需签署协议的活动）。

Q：ISV能否将券发到支付成功页，在支付成功页上做营销？

A：支付成功页都属于支付宝的运营资源，具体可以向该行业的支付宝BD、运营同学看是否可申请资源。

Q：支付宝异步通知我们平台时，我们这边收到通知后是否需要传入指定值告知支付宝？可以是任意的值吗

A：异步通知处理参考：https://tech.open.alipay.com/support/knowledge/index.htm?knowledgeId=201602051359&categoryId=20070#/?_k=wru2ae

Q：alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址)调用时报错“账单不存在”

A：非open.alipay.com公开的支付产品，基本都没有业务账单；请使用"bill_type":"signcustomer"下载账务账单进行对账。

Q：配置或更改应用网关报错“应用网关响应异常”

A：应用网关的配置和改变，都需要重新验证激活，详见：https://tech.open.alipay.com/support/knowledge/index.htm?knowledgeId=201602048845&categoryId=20015#/?_k=z9ag2u

Q：我们的账户A签约并开通了手机网站支付（或当面付等），如果我把账户B添加为我们的商户，但账户B并没有签约开通手机网站支付（或当面付等），请问我用账户A发起的手机网站支付（或当面付等）的交易请求，能收款到账户B吗？

A：不能，目前停车行业都是直连，只能用签约商户的账户发起交易请求并收款到自己的账户。

Q：使用当面付支付停车费，用户的同一个停车记录，发生重复扣款。

A：使用当面付支付接口出现重复扣款，一般未结合查询、轮询和撤销引起。可参考接入规范进行修复：https://docs.open.alipay.com/194/105322/

Q：使用当面付支付停车费，支付接口返回“10003”、“20000”等错误码。

A：请参考https://docs.open.alipay.com/194/105322/ 文档中的接口调用规范和异常处理流程来进行接入。

Q：确认已签约完产品，调用产品接口确报错"权限不足"

A：由BD人工签约的产品，默认自动给系统初始应用的APPID绑定对应功能接口。无特殊原因请是用系统初始的APPID;若要使用别的APPID调用接口，则找对应行业PD申请单独挂接口功能包。

系统初始应用指：开放平台为开发者账号自动创建的应用。

  1、若开通了生活号，则系统初始应用的APPID和生活号应用为同一APPID。
  2、若未开通生活号，则APPID(值以日期开头)日期最早的一个即为系统初始应用的APPID，通常应用名称为“应用2.0签约XXXXXXXX”。

Q：生活号APPID如何查看

A：开放平台查看生活号APPID:https://openhome.alipay.com/platform/publicAppManage.htm；登录生活号查看生活号APPID:https://fuwu.alipay.com/platform/main.htm

Q：接口中存在公共参数的app_auth_token和auth_token如何处理

A：app_auth_token是是商户给ISV的第三方应用授权，auth_token是用户给商户的用户信息授权。
若是ISV调用接口，公共参数里的app_auth_token和auth_token两个参数都需要赋值,app_id用isv的；
若是商户直接调用接口，只需给auth_token赋值，app_id用商户自己的。
第三方应用授权：https://docs.open.alipay.com/common/105193
用户信息授权：https://docs.open.alipay.com/289/105656

Q：使用alipay.trade.create+jsapi支付，支付成功页如果不点击完成，就收不到callback回调，怎么判断支付结果

A：js唤起收银台的结果以异步通知为准的，JS的callback回调只做参考。alipay.trade.create接口的notify_url填入异步通知地址，用户支付后即触发异步通知。
异步通知详见：https://docs.open.alipay.com/194/103296

Q：结算到卡的银行卡主体跟我司主体不一致的可以绑定吗？

A：可以绑定。

Q：我们是ISV身份，如何实现直接收款到商户？

A：若业务上，商户和支付宝签约了对应支付产品的销售方案，调用该支付接口时建议用商户的APPID(1.0接口为PID)和对应的密钥来发起调用，直接收款到商户账户；也可参考第三方应用授权方式：https://docs.open.alipay.com/common/105193，由ISV代替商户发起调用请求，并收款到商户账户（注意要进行第三方调用，开发者需要在应用中添加对应功能并获得商户授权，商户需要申请开通相应的权限）。如对接手机网站支付、APP支付需要采用第三方应用授权方式，需要联系支付宝BD开通功能后调用；对接当面付产品，默认已开通第三方应用授权方式调用，无需再联系支付宝BD开通。

Q：我们是ISV身份，如何实现商户的收款以及经销商的分润？

A：如果用户的一笔支付，发起方和经销商各收一部分叫分润，这种方式找支付宝业务经理签“对应收单产品”的“分账账户限制集”后，接口参数royalty_info来控制分润。

Q：目前我们财务是人工将支付宝里面的金额划转到绑定的银行账户的，有没有可以设定自动划转到绑定的银行账户？

A：可以通过签约委托提现产品，来实现自动划转。一般是T+1日将前一天账户24点的历史余额全部（或可以预留部分）提现到您公司对应的银行账户。

Q：关于手续费的发票如何取得？具体流程如何？

A：手续费发票首次申请，需要商户登录b.alipay.com-对账中心-发票管理-填写发票信息，也可以直接进连接：https://mbillexprod.alipay.com/enterprise/mctArInvoiceListQuery.htm 一般建议选择按月自动开票，一般次月的第15个工作日开始开具上一个月的手续费发票。

Q：支付宝账单详情显示的商户名称可否修改？

A：账单详情显示的名字取自发起交易的账号登记的名称，该名称在注册签约时设定。即谁发起交易显示谁的名称。

Q：联调时报“商户无效”或“appid无效”是什么原因？

A：需要在相关产品销售方案完成签约后联调，并使用正确的APPID发起请求。

Q：停车场坐标是否有长度限制？

A：请求接口时停车场坐标长度限定长度为12，不能超过此长度，如果超过请自行处理后上传经纬度，请使用高德地图坐标经纬度。

Q：录入停车场信息时报门店已存在的原因？

A：同店校验规则，以下规则任意一种情况出现，就会报门店已存在：

1. 门店(停车场)名称+省市区编码一样
2. 省市区编码一样+详细地址一样

Q：停车场录入失败的原因？

A：请排查是否重复录入导致数据重复，数据在平台已经存在。

Q：沙箱环境扫码进入车主平台时为什么看不到停车缴费图标？

A：沙箱环境中车主服务请选择杭州、上海等城市即可。

Q：调用接口报301的原因？

A：如果调用接口的时候报301，请检查请求网关时用的http还是https，如果是http请改成https。

Q：点击缴费报403的原因？

A：如果点击缴费时报403，请检查服务器是否可访问外部网络。

Q：点击缴费报405的原因？

A：请检查接收请求的controller需要与请求方式保持一致。

Q：如何调用车牌查询接口？

A：用户点击缴费时会回调isv提供的链接，平台会拼接参数返回&/?auth_code=xxx&car_id=XXX&parking_id=xxx，用户拿到auth_code去换token，用token和用户id调用查询车牌接口即可。

Q：请求接口正确返回信息但抛出异常信息的原因？

A：请确认支付宝公钥是否调用错误。

Q：如何在支付后禁用分享功能？

A：在页面上增加以下内容：

 document.addEventListener('AlipayJSBridgeReady', function () {

            console.log(typeof AlipayJSBridge);

            AlipayJSBridge.call("hideToolbar");

            AlipayJSBridge.call("hideOptionMenu");

}, false);

Q：调用接口返回HTML代码的原因？

A：传的参数格式非json或有误导致直接返回页面源码。

Q：调用收银台，监听关闭当前页面

A：返回关闭当前页面

$(function(){

      $(document).off('back', function (e) {

      });

      $(document).on('back', function (e) {

          e.preventDefault();

        goBack();

      });

      function goBack() {

         //AlipayJSBridge.call('popTo', {index: -1});

        AlipayJSBridge.call('closeWebview');

      }

    }

  });

Q：调用alipay.eco.mycar.parking.config.set(停车ISV系统配置接口)报40004异常

A： merchant_name商户简称在平台具有唯一性，被其它appid调用过后将不能使用，需要更换名称或去修改之前调用过该配置的appid对应的merchant_name

Q：在车主服务中找不到停车平台入口

A：请确认车主服务中的该城市是否已开通停车服务，如未开通请通过扫码方式直接进入停车平台，或选择有入口的城市，如：北京、上海、杭州

Q：调用接口时把参数转成Json时报格式错误

A：如果遇到封装接口参数返回string转json错误时，请确认是否参数封装完毕后调用了.toString方法，正确方式：封装参数转换成json格式的string字符串

Q：请求停车平台的接口正常返回数据，但报密钥异常

A：请自检代码中配置的支付宝公钥是否正常

Q：操作的数据和请求的不一致问题

A：请自检调用网关地址是否正常，是否调用到其它环境

Q：访问权限不足40006 ISV权限不足

A：与支付宝网关确认是否开通访问接口的权限

Q：接口返回错误描述为"ISV无效"，"无ISV信息"等

A：与支付宝确认对应环境的ISV是否已录入到公用基础平台

Q：用户点击缴费跳转ISV页面失败

A：核实公用基础平台上ISV的缴费页面地址是否配置正确，对应商户配置接口(config.set)的interface_url

Q：调用停车平台接口，返回错误描述为"非空参数为空"

A：请核对开放平台停车接入文档，查看接口必填项 

FAQ