开发者通过该接口帮助物业公司或其他小区管理主体发起指定小区的基础服务信息变更申请。
环境 | HTTPS请求地址 |
---|---|
正式环境 | https://openapi.alipay.com/gateway.do |
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
app_id | String | 是 | 32 | 支付宝分配给开发者的应用ID | 2014072300007148 |
method | String | 是 | 128 | 接口名称 | alipay.eco.cplife.basicservice.modify |
format | String | 否 | 40 | 仅支持JSON | JSON |
charset | String | 是 | 10 | 请求使用的编码格式,如utf-8,gbk,gb2312等 | utf-8 |
sign_type | String | 是 | 10 | 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 | RSA2 |
sign | String | 是 | 256 | 商户请求参数的签名串,详见签名 | 详见示例 |
timestamp | String | 是 | 19 | 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" | 2014-07-24 03:07:50 |
version | String | 是 | 3 | 调用的接口版本,固定为:1.0 | 1.0 |
app_auth_token | String | 否 | 40 | 详见应用授权概述 | |
biz_content | String | 是 | - | 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档 |
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
community_id | String | 必须 | 32 | 支付宝社区小区统一编号,必须在物业账号名下存在。 | AJ5OFJC124403 |
service_type | String | 必须 | 32 | 基础服务类型,目前支持的类型值为:
PROPERTY_PAY_BILL_MODE - 物业缴费账单上传模式 |
PROPERTY_PAY_BILL_MODE |
status | String | 可选 | 32 | 申请变更的服务状态,可选值为:
ONLINE - 上线,服务对接成功并在生产环境验证通过后,需要在status传值ONLINE调用本接口申请服务上线。 MAINTAIN - 维护中 OFFLINE - 下线 |
ONLINE |
external_invoke_address | String | 可选 | 512 | 由开发者系统提供的,支付宝根据基础服务类型在特定业务环节调用的外部系统服务地址,开发者需要确保外部地址的准确性。在线上环境需要使用HTTPS协议,会检查ssl证书,要求证书为正规的证书机构签发,不支持自签名证书。
对于PROPERTY_PAY_BILL_MODE服务类型,该地址表示用户缴费支付完成后开发者系统接受支付结果通知的回调地址。 |
https://example.com/gateway.do |
account_type | String | 可选 | 32 | 若服务类型为物业缴费账单模式,每个小区默认的收款帐号为授权物业的支付宝账号,但允许开发者为每个小区服务传入一个指定的物业收款帐号,收款帐号支持三种类型:
ALIPAY_LOGON_ID - 物业签约支付宝收单产品时配置的支付宝收款限制集中的支付宝登陆账号,必须在授权物业账号名下的收款限制集中。 ALIPAY_PARTNER_ID - 物业签约支付宝收单产品时配置的支付宝收款限制集中的账号PID,2088开头的16位账号。必须在授权物业账号名下的收款限制集中。 BANK_CARD_ID - 物业集团公司在签约收单产品时支付宝平台配置的银行卡编号(注:非实际银行账号)。 |
ALIPAY_LOGON_ID |
account | String | 可选 | 64 | 若服务类型为物业缴费账单模式,每个小区默认的收款帐号为授权物业的支付宝账号,默认不用传该参数。
但为满足部分物业个性化需求,允许开发者为每个小区服务传入一个指定的物业收款帐号。根据不同账号类型,开发者需要向物业或支付宝商务支持接口人获取具体的收款帐号。 |
2088501624560333 |
service_expires | Date | 可选 | 20 | 若本服务需要变更过期时间(如在物业服务合同中约定),开发者按标准时间格式:yyyy-MM-dd HH:mm:ss传入。 | 2017-12-31 23:59:59 |
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
code | String | 是 | - | 网关返回码,详见文档 | 40004 |
msg | String | 是 | - | 网关返回码描述,详见文档 | Business Failed |
sub_code | String | 否 | - | 业务返回码,详见文档 | ACQ.TRADE_HAS_SUCCESS |
sub_msg | String | 否 | - | 业务返回码描述,详见文档 | 交易已被支付 |
sign | String | 是 | - | 签名,详见文档 | DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo= |
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
status | String | 选填 | 64 | 若服务成功变更,则返回当前状态。 | OFFLINE |
next_action | String | 选填 | 64 |
服务变更成功后,若从当前状态到下一状态需要完成下一步条件代码,则返回该字段,否则不返回。
格式为“条件代码|操作主体”。 操作主体有: INVOKER - 接口调用方 MERCHANT - 物业公司 AUDITOR - 平台审核方 条件代码包括但不限于: WAIT_SERVICE_PROVISION - 等待基础服务初始化 WAIT_PROD_VERIFICATION - 等待在生产环境通过自测 WAIT_ONLINE_APPLICATION - 等待提起上线申请(目前支持开发者调用alipay.eco.cplife.basicservice.modify接口发起上线申请) WAIT_AUTH_TO_PLATFORM - 等待物业授权给支付宝社区平台 WAIT_CONFIRMATION - 等待相关方确认 WAIT_AUDITING - 等待审核 |
WAIT_PROD_VERIFICATION|MERCHANT |
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2"); AlipayEcoCplifeBasicserviceModifyRequest request = new AlipayEcoCplifeBasicserviceModifyRequest(); request.setBizContent("{" + "\"community_id\":\"AJ5OFJC124403\"," + "\"service_type\":\"PROPERTY_PAY_BILL_MODE\"," + "\"status\":\"ONLINE\"," + "\"external_invoke_address\":\"https://example.com/gateway.do\"," + "\"account_type\":\"ALIPAY_LOGON_ID\"," + "\"account\":\"2088501624560333\"," + "\"service_expires\":\"2017-12-31 23:59:59\"" + " }"); AlipayEcoCplifeBasicserviceModifyResponse response = alipayClient.execute(request); if(response.isSuccess()){ System.out.println("调用成功"); } else { System.out.println("调用失败"); }
{ "alipay_eco_cplife_basicservice_modify_response":{ "msg":"Success", "code":"10000", "next_action":"WAIT_PROD_VERIFICATION|MERCHANT", "status":"OFFLINE" }, "sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE" }
{ "alipay_eco_cplife_basicservice_modify_response":{ "msg":"Service Currently Unavailable", "code":"20000", "sub_msg":"系统繁忙", "sub_code":"isp.unknow-error" }, "sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE" }
错误码 | 错误描述 | 解决方案 |
---|---|---|
INVALID_PARAMETER | 参数有误。 | 检查请求参数,修改后重新发起请求。 |
SYSTEM_ERROR | 系统繁忙。 | 稍后重试。 |
COMMUNITY_NOT_EXISTING | 请求的小区编号在当前物业账号名下不存在。 | 请通过小区查询接口确认授权物业公司账号名下是否存在该小区编号。请修改小区编号并重试。 |
SERVICE_NOT_INIT | 指定小区对应的服务类型未初始化。 | 请调用查询单个物业小区信息接口确认指定小区服务注册情况。 |
INVALID_STATUS | 待变更的状态值不合法。 | 请参考接口文档确认待变更的状态值是否在支持范围内。 |
INVALID_SERVICE_TYPE | 服务类型非法。 | 传入的服务类型不支持,请按照接口文档列举的值修改并重试。 |
INVALID_EXTERNAL_ADDRESS | 外部系统服务地址未通过校验。 | 提供的外部系统服务地址格式未通过校验,请修改并重试。 |
INVALID_ACCOUNT_TYPE | 收款帐号类型非法。 | 传入的收款帐号类型不支持,请按照接口文档列举的值修改并重试。 |
INVALID_ACCOUNT | 收款帐号非法。 | 传入的收款帐号不存在或格式非法,请开发者和物业确认收款帐号有效性,修改并重试。 |
INVALID_SERVICE_EXPIRES | 服务过期时间非法。 | 请按照yyyy-MM-dd HH:mm:ss的标准时间格式传入合理的服务过期时间,修改并重试。 |