文档中心 > API类目 > 社区物业API

alipay.eco.cplife.pay.result.query (查询单笔物业费交易关联账单详情)

开发者根据支付宝交易号或查询token,查询帮助授权物业公司创建的小区中曾缴费的交易详情及对应的业务账单信息。

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.eco.cplife.pay.result.query
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 - 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
trade_no String 特殊可选 64 用户完成物业缴费后由支付宝异步通知的支付宝交易号,和查询token参数二者传其一即可。 2017070321001004170201038448
query_token String 特殊可选 64 查询令牌,部分模式下用户缴物业费成功后由支付宝通过异步通知给到开发者系统,和trade_no二者传其一即可。 2GjV8Z/WuK/GgLdt1Lgd0DLcdhfBYzR8G16bm6wqY9o=

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
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=

响应参数

参数 类型 是否必填 最大长度 描述 示例值
trade_no String 必填 64 用户完成物业缴费对应的支付宝交易号 2017070321001004170201038448
buyer_user_id String 必填 32 买家支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。 2088102146225130
buyer_logon_id String 必填 128 脱敏后的买家支付宝登录账号 159****5620
seller_id String 必填 32 卖家(即物业缴费收款方)支付宝用户号 2088102146225130
trade_status String 必填 32 交易状态 TRADE_SUCCES
total_amount Price 必填 11 本次交易支付的订单金额,单位为人民币(元) 10.21
biz_entity_id String 必填 128 该笔缴费归属的支付宝房号,支付宝小区编号,和物业房间户号 支付宝房号|支付宝小区编号|物业端户号
biz_type String 必填 12 缴费类型:
00--上传账单类缴费
CJ--欠费直查类缴费
YC--预存类缴费
00
gmt_payment Date 必填 20 交易完成付款时间 2014-11-27 15:45:57
fund_bill_list FundBillListEco 必填 - 交易支付使用的资金渠道
  • └ fund_channel
  • String
  • 必填
  • 32
  • 交易使用的资金渠道,详见 支付渠道列表
  • ALIPAYACCOUNT
  • └ amount
  • Price
  • 必填
  • 11
  • 该支付工具类型所使用的金额
  • 10.01
assoc_bill_details TradeAssocBillDetails 必填 - 本次交易关联的账单详情
  • └ bill_entry_id
  • String
  • 必填
  • 32
  • 用于标识该笔缴费对应的缴费明细项外部编号;如果是预存缴费,则为外部户号
  • 0001
  • └ bill_entry_amount
  • Price
  • 必填
  • 11
  • 缴费明细项金额
  • 10.21
  • └ cost_type
  • String
  • 选填
  • 32
  • 缴费明细项类型
  • 物业费
  • └ acct_period
  • String
  • 选填
  • 32
  • 明细条目所归属的账期
  • 2017年7月

请求示例

  • JAVA
  • .NET
  • PHP
  • HTTP请求源码
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayEcoCplifePayResultQueryRequest request = new AlipayEcoCplifePayResultQueryRequest();
request.setBizContent("{" +
"\"trade_no\":\"2017070321001004170201038448\"," +
"\"query_token\":\"2GjV8Z/WuK/GgLdt1Lgd0DLcdhfBYzR8G16bm6wqY9o=\"" +
"}");
AlipayEcoCplifePayResultQueryResponse response = alipayClient.pageExecute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"alipay_eco_cplife_pay_result_query_response":{
		"msg":"Success",
		"assoc_bill_details":{
			"cost_type":"物业费",
			"bill_entry_id":"0001",
			"acct_period":"2017年7月",
			"bill_entry_amount":10.21
		},
		"gmt_payment":"2014-11-27 15:45:57",
		"code":"10000",
		"biz_type":"00",
		"buyer_user_id":"2088102146225130",
		"fund_bill_list":{
			"amount":10.01,
			"fund_channel":"ALIPAYACCOUNT"
		},
		"biz_entity_id":"支付宝房号|支付宝小区编号|物业端户号",
		"total_amount":10.21,
		"trade_status":"TRADE_SUCCES",
		"trade_no":"2017070321001004170201038448",
		"buyer_logon_id":"159****5620",
		"seller_id":"2088102146225130"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

  • JSON示例
{
	"alipay_eco_cplife_pay_result_query_response":{
		"msg":"Service Currently Unavailable",
		"code":"20000",
		"sub_msg":"系统繁忙",
		"sub_code":"isp.unknow-error"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

错误码 错误描述 解决方案
INVALID_PARAMETER 参数有误 检查请求参数,修改后重新发起请求
SYSTEM_ERROR 系统繁忙 稍后重试
PAY_INFO_NOT_EXISTING 在线物业缴费系统不存在指定的交易信息 确认请求参数是否有效的在线物业缴费交易号或查询令牌
PAY_INFO_BELONGING_TO_OTHERS 指定的交易信息属于其他物业小区 检查传入的物业授权令牌app_auth_token和支付宝交易号等参数,修改后重新发起请求

公共错误码

返回
顶部