支付宝物业缴费接口开发指南

来自    物业社区 | 
作者:我是个导演  |  更新于:2018-03-16 15:32:38     

1.接口说明

  产品介绍

    物业缴费是支付宝给到物业行业的一种在线支付方式,物业公司或者物业开发者通过对接支付宝给出的开放接口,将账单上传到支付宝物业平台。支付宝通过通知消息通知到用户,用户在“支付宝-生活缴费-物业费”页面上查询物业缴费账单,并且针对账单进行支付。支付成功后,支付宝物业平台发送异步消息通知到开发者物业平台。

2.沙箱环境 

  注意:物业缴费必须先使用沙箱测试

  沙箱介绍

    物业缴费接口支持沙箱测试并且一定要先使用沙箱测试,在沙箱调通接口后,必须在线上正式环境进行测试与验收,所有返回码及业务逻辑以线上为准。

  如何沙箱测试物业缴费视频讲解↓↓↓

      

    沙箱密钥生成和上传流程和正式环境步骤相同请参考5.密钥配置

  使用沙箱测试物业缴费流程

     视屏讲解如何使用沙箱测试物业缴费流程↓↓↓

      

  注意点

    QA:一定要授权给这个链接并且使用的沙箱商家账号授权否则会报错权限不足:https://openauth.alipaydev.com/oauth2/appToAppAuth.htm?app_id=2016080100140559&redirect_uri=https%3a%2f%2falivemngsandbox.alipay-eco.com%2fcpmerchantmng-web-home%2fsecondauth%2fauthcode

    沙箱接口调用流程

      轻松5步完成物业缴费沙箱测试流程

      A.第一步调用alipay.eco.cplife.community.create(创建物业小区)接口

      B.第二步调用alipay.eco.cplife.basicservice.initialize(初始化小区物业基础服务)接口

      C.第三步调用alipay.eco.cplife.roominfo.upload(上传物业小区内部房屋信息)接口

      D.第四步调用alipay.eco.cplife.bill.batch.upload(批量上传待缴物业费账单)接口

      E.第五步调用alipay.eco.cplife.community.details.query(查询单个物业小区信息)接口

      F.其他辅助接口请自行测试

      视屏讲解如何使用沙箱测试物业缴费接口接入必看!!!↓↓↓

      

      注:demo下载地址请到6.demo&SDK查看

  常见问题

    Q:沙箱维护时间

    A:每周日中午12点至每周一中午12点沙箱环境进行维护,期间可能出现不可用。

    Q:沙箱报错:系统有点儿忙,一会儿再试试

    A: 请参考这个链接:https://openclub.alipay.com/read.php?tid=4475&fid=74

    Q:沙箱出现支付错误码ALI3151

    A: 请参考这个链接:https://openclub.alipay.com/read.php?tid=4100&fid=74&page=1

3.应用创建

  创建应用

    1.如何创建应用帖子说明:https://openclub.alipay.com/read.php?tid=1606&fid=25

    2.视屏讲解如何创建应用↓↓↓

      

  常见问题

    Q:应用有几种状态分别代表什么?

    A:有开发中,审核中,已上线三个状态,只有已上线才可以调用接口进行测试,有开发中,审核中不可以调用接口

    Q:应用可以删除吗?

    A:开发中,审核中可以删除,已上线状态不可以删除

    Q:应用名称和logo是否可以修改?

    A:可以修改一个月只能修改一次

    Q:第三方应用和自用型有什么区别?

    A:第三方应用:是服务商代替商户发起请求的应用,自用型:是给自己或自己公司使用的应用

    Q:现在创建的应用支持什么签名方式?

    A:从2018年1月5号起创建的应用只支持RSA2(也就是RSA(SHA256))签名方式详情请查看公告

4.签约准入

  注册入驻

    1.使用支付宝账号入驻开放平台 注册支付宝账号并完成实名认证,如已有支付宝账号请选择下一步入驻流程

      如何注册认证支付宝  |  现在去注册

    2.支付宝账号登录开放平台,完善开发者信息,在线签署协议,即可完成入驻

      现在去入驻

    注:如果还没有签约或者在签约过程中可以使用4.沙箱环境测试该接口

  如何签约

    一,自助签约(推荐)

    1.登录下面地址选择右下角的立即接入:点击查看

    2.重签,改签请根据这个帖子第三步进行咨询:https://openclub.alipay.com/read.php?tid=276&fid=72

  常见问题

    Q:怎么查看自己是否签约成功?进度到哪里了?

    A:根据这个帖子自查询:https://openclub.alipay.com/read.php?tid=2025&fid=72

 

5.密钥配置

  生成RSA2密钥

    1.密钥生成工具下载:

       windows密钥工具:下载

       MAC_OSX密钥工具:下载

    2.如何生成RSA2密钥教程:https://openclub.alipay.com/read.php?tid=1833&fid=46

    3.生成密钥视频教程

       

  其他工具生成方式

    1.一键生成pem格式密钥:https://openclub.alipay.com/read.php?tid=2177&fid=46

    2.使用OpenSSL工具生成密钥:https://openclub.alipay.com/read.php?tid=4523&fid=72

  上传商户公钥获取支付宝公钥

    1.如何上传商户公钥获取支付宝公钥帖子教程https://openclub.alipay.com/read.php?tid=2190&fid=69

    2.如何上传商户公钥获取支付宝公钥视频教程↓↓↓

      

  常见问题

    Q:使用密钥工具生成的密钥,每一次点击生成的密钥相同吗?

    A:密钥工具每点击一次生成密钥,都是唯一的

    Q:我的私钥丢失的应该怎么办?有商户公钥可以找回吗?

    A:  1.可以找到以前使用的项目有用到过这一对密钥的项目把密钥找回 

         2.重新生成一对密钥,重新上传商户公钥,保存商户私钥

 

6.demo&SDK

  1.demo下载地址(内含沙箱测试账号,方便大家测试流程,也可以替换自己的沙箱账号测试流程

    java版: wuyejiaofei-utf-8-JAVA.zip

    php版: wuyejiaofei-php-utf-8.zip

  2.官方服务端SDK下载地址(支持java,php,.net):https://docs.open.alipay.com/54

  3.其他开发语言参考方案(仅供参考):

    A.Python原生服务端签名生成请求订单信息:https://openclub.alipay.com/read.php?tid=1223&fid=60

    B.PHP原生服务端签名生成请求订单信息:https://openclub.alipay.com/read.php?tid=1203&fid=60

    C.node.js服务端签名请求示例:https://openclub.alipay.com/read.php?tid=2170&fid=69

7.开发知识点

  正式环境接入注意点

    1.物业缴费正式环境的 external_invoke_address接口直接配置是无法使用的,请发送这个邮件进行申请:jun.guo@bangdao-tech.com会有专门同学处理配置

    邮件格式(一定要包含以下6点信息):1.公司名中文名:2.PID 3.APPPID 4.支付宝帐号 5.授权回调地址 6.是否完成小区初始化服务

     2.没有上到支付宝钱包的物业平台(例如自己开发生活号,小程序,h5页面的程序都属于不在支付宝钱包平台)物业公司签约需要签约当面付接口,服务商不需要签约服务商需要添加当面付功能包即可。

    3.上传住户账单一定要上线把完整的住户上传好。不建议在正式环境测试1分钱的账单

    4.对账单可以使用当面付,对账单下载接口:查询对账单下载地址

    5.物业公司授权给服务商,服务商调用第三方应用授权接口获取物业公司的app_auth_token代替物业公司发起请求

      a.如何使用沙箱测试第三方应用授权(java版):https://openclub.alipay.com/read.php?tid=1649&fid=68

      b.如何获取第三方应用授权app_auth_token:https://openclub.alipay.com/read.php?tid=458&fid=55

    6.服务商拿返佣有两种方式:

      a.物业公司签约返佣协议,并且物业公司在支付宝钱包物业平台中,这个时候产生的交易会自动带上服务商的返佣id,进行返佣

      b.非支付宝钱包物业平台(例如自己开发生活号,小程序,h5页面的程序都属于不在支付宝钱包物业平台),首先签约返佣协议,然后再调用当面付接口是带上返佣参数(sys_service_provider_id)这样才能拿到返佣

    7.使用sdk签名方法详解:https://openclub.alipay.com/read.php?tid=2212&fid=46

    8.支付宝交易状态快速掌握:https://openclub.alipay.com/read.php?tid=1295&fid=72

    9.关于支付宝异步通知的那些事:https://openclub.alipay.com/read.php?tid=1314&fid=69

    正式环境强烈推荐云排查!!!(自查问题神器)https://openclub.alipay.com/read.php?tid=1132&fid=25

常见问题自查方案

  无效的appid:https://openclub.alipay.com/read.php?tid=1909&fid=72

  ISV权限不足:https://openclub.alipay.com/read.php?tid=1672&fid=72

  无效签名:https://openclub.alipay.com/read.php?tid=1568&fid=69

  验签出错:https://openclub.alipay.com/read.php?tid=2432&fid=72

  收不到异步通知:https://openclub.alipay.com/read.php?tid=1677&fid=72

  验签失败:https://openclub.alipay.com/read.php?tid=1598&fid=69

 

8.最后说明

  如果您看完这个物业缴费接口还是有很多疑问,相信还是这个建议流程开发文档不够完善,欢迎您的在本帖下方追问和吐槽,如果您对接入文档有更好的建议或者想法欢迎在本帖下方说明,最后祝大家接入顺利.

蚁皇:孝弟 | 2018-04-17 15:09:41
很好,解释的很详细,按这个流程走完就能走通了
里牛克斯 | 2018-05-18 10:50:27
请问一下,审核 物业缴费正式环境的 external_invoke_address 回调地址需要多久?
我是个导演 | 2018-05-18 11:16:04
里牛克斯:请问一下,审核 物业缴费正式环境的 external_invoke_address 回调地址需要多久?回到原帖
审核处理时间1周内完成,如果一周后还有问题,请提供地址+签约账号6+appid+邮件申请时间。我这边去核实进度。
我的回复

返回顶部