淘宝开放平台 - 文档中心

请求地址：

环境	HTTPS请求地址
正式环境	https://openapi.alipay.com/gateway.do

公共请求参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	是	128	接口名称	alipay.eco.edu.kt.schoolinfo.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	是	-	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

参数	类型	是否必填	最大长度	描述	示例值
school_name	String	必须	256	学校名称	杭州市西湖第一实验学校
school_icon	String	可选	256	学校的校徽或logo，在学校展示页面作为学校的标识。该字段为图片的链接地址，只支持png或jpg图片格式，图片高度为108，宽度为108 ，不大于20k。注意：此链接要求公网可以访问，否则无法正常展示。	http://ecopublic-dev.oss-cn-hangzhou.aliyuncs.com/eco/edu_alipay/school/school.png
school_icon_type	String	特殊可选	10	如果填写了school_icon参数，则此字段不能为空。目前只支持png和jpg两种格式	png
school_stdcode	String	可选	16	学校(机构)标识码（由教育部按照国家标准及编码规则编制，可以在教育局官网查询）	3133005132
school_type	String	必须	6	学校的类型： 1：代表托儿所； 2：代表幼儿园；3：代表小学；4：代表初中；5：代表高中。如果学校兼有多种属性，可以连写，比如： 45：代表兼有初中部高中部；34：代表兼有小学部初中部	4
province_code	String	必须	8	省份的国家编码（国家统计局出版的行政区划代码 http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/）	330000
province_name	String	必须	32	省名称	浙江省
city_code	String	必须	16	城市的国家编码（国家统计局出版的行政区划代码 http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/）	330100
city_name	String	必须	64	城市名称	杭州市
district_code	String	必须	16	区县的国家编码（国家统计局出版的行政区划代码 http://www.stats.gov.cn/tjsj/tjbz/xzqhdm/）	330106
district_name	String	必须	64	区县名称	西湖区
isv_no	String	可选	128	注意：本参数从1.3版本开始已经废弃，不再需要传递。由支付宝提供的给已经签约的isv的编码，业务上一般直接采用isv的支付宝PID。	201600129391238873
isv_name	String	必须	256	商家名称，每个接入教育缴费的ISV商家名称，由ISV自己提供	杭州少年宫
isv_notify_url	String	必须	256	此通知地址是为了保持教育缴费平台与ISV商户支付状态一致性。用户支付成功后，支付宝会根据本isv_notify_url，通过POST请求的形式将支付结果作为参数通知到商户系统，ISV商户可以根据返回的参数更新账单状态。	https://isv.com/xxx
isv_pid	String	必须	128	填写已经签约教育缴费的isv的支付宝PID	2088121212121212
isv_phone	String	必须	20	ISV联系电话,用于账单详情页面显示	13300000000
school_pid	String	必须	128	学校用来签约支付宝教育缴费的支付宝PID	20880012939123234423
bankcard_no	String	可选	32	对应集团到卡模式的银行编号.学校与支付宝后台签约时，由学校提交给支付宝的编号	P0004
bank_uid	String	可选	32	与浙江网商交易见证平台有交互的ISV在创建账户获得的member_id，由网商分配	20000293230232
bank_notify_url	String	可选	256	与浙江网商交易见证平台有交互ISV输入网商交易异步通知回调URL，教育缴费同步账单信息给网商，网商会回调此url，ISV即可获取网商相关的参数，根据教育缴费平台账单发送接口返回的 order_no和网商返回的outer_trade_no来对应账单信息。	https://www.xxx.xxx/xx
bank_partner_id	String	可选	32	与浙江网商交易见证平台有交互的ISV,由交易见证平台分配给合作方业务平台签约唯一ID ，由网商分配给ISV的渠道参数	200002924334
white_channel_code	String	可选	32	与浙江网商交易见证平台有交互的ISV,由网商分配给ISV的渠道参数	TESTBANK10301

参数	类型	是否必填	最大长度	描述	示例值
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	必填	16	Y：代表成功；N：代表失败	Y
school_no	String	必填	16	支付宝分配给学校的编码，作为学校在支付宝的标识	11010100000002

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");
AlipayEcoEduKtSchoolinfoModifyRequest request = new AlipayEcoEduKtSchoolinfoModifyRequest();
request.setBizContent("{" +
"\"school_name\":\"杭州市西湖第一实验学校\"," +
"\"school_icon\":\"http://ecopublic-dev.oss-cn-hangzhou.aliyuncs.com/eco/edu_alipay/school/school.png\"," +
"\"school_icon_type\":\"png\"," +
"\"school_stdcode\":\"3133005132\"," +
"\"school_type\":\"4\"," +
"\"province_code\":\"330000\"," +
"\"province_name\":\"浙江省\"," +
"\"city_code\":\"330100\"," +
"\"city_name\":\"杭州市\"," +
"\"district_code\":\"330106\"," +
"\"district_name\":\"西湖区\"," +
"\"isv_no\":\"201600129391238873\"," +
"\"isv_name\":\"杭州少年宫\"," +
"\"isv_notify_url\":\"https://isv.com/xxx\"," +
"\"isv_pid\":\"2088121212121212\"," +
"\"isv_phone\":\"13300000000\"," +
"\"school_pid\":\"20880012939123234423\"," +
"\"bankcard_no\":\"P0004\"," +
"\"bank_uid\":\"20000293230232\"," +
"\"bank_notify_url\":\"https://www.xxx.xxx/xx\"," +
"\"bank_partner_id\":\"200002924334\"," +
"\"white_channel_code\":\"TESTBANK10301\"" +
"  }");
AlipayEcoEduKtSchoolinfoModifyResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

IAopClient client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "app_id", "merchant_private_key", "json", "1.0", "RSA2", "alipay_public_key", "GBK", false);
AlipayEcoEduKtSchoolinfoModifyRequest  request= new AlipayEcoEduKtSchoolinfoModifyRequest() ;
request.BizContent="{" +
"\"school_name\":\"杭州市西湖第一实验学校\"," +
"\"school_icon\":\"http://ecopublic-dev.oss-cn-hangzhou.aliyuncs.com/eco/edu_alipay/school/school.png\"," +
"\"school_icon_type\":\"png\"," +
"\"school_stdcode\":\"3133005132\"," +
"\"school_type\":\"4\"," +
"\"province_code\":\"330000\"," +
"\"province_name\":\"浙江省\"," +
"\"city_code\":\"330100\"," +
"\"city_name\":\"杭州市\"," +
"\"district_code\":\"330106\"," +
"\"district_name\":\"西湖区\"," +
"\"isv_no\":\"201600129391238873\"," +
"\"isv_name\":\"杭州少年宫\"," +
"\"isv_notify_url\":\"https://isv.com/xxx\"," +
"\"isv_pid\":\"2088121212121212\"," +
"\"isv_phone\":\"13300000000\"," +
"\"school_pid\":\"20880012939123234423\"," +
"\"bankcard_no\":\"P0004\"," +
"\"bank_uid\":\"20000293230232\"," +
"\"bank_notify_url\":\"https://www.xxx.xxx/xx\"," +
"\"bank_partner_id\":\"200002924334\"," +
"\"white_channel_code\":\"TESTBANK10301\"" +
"  }";
AlipayEcoEduKtSchoolinfoModifyResponse response=client.Execute(request);
Console.WriteLine(response.Body);

$aop = new AopClient ();
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->appId = 'your app_id';
$aop->rsaPrivateKey = '请填写开发者私钥去头去尾去回车，一行字符串';
$aop->alipayrsaPublicKey='请填写支付宝公钥，一行字符串';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='GBK';
$aop->format='json';
$request = new AlipayEcoEduKtSchoolinfoModifyRequest ();
$request->setBizContent("{" .
"\"school_name\":\"杭州市西湖第一实验学校\"," .
"\"school_icon\":\"http://ecopublic-dev.oss-cn-hangzhou.aliyuncs.com/eco/edu_alipay/school/school.png\"," .
"\"school_icon_type\":\"png\"," .
"\"school_stdcode\":\"3133005132\"," .
"\"school_type\":\"4\"," .
"\"province_code\":\"330000\"," .
"\"province_name\":\"浙江省\"," .
"\"city_code\":\"330100\"," .
"\"city_name\":\"杭州市\"," .
"\"district_code\":\"330106\"," .
"\"district_name\":\"西湖区\"," .
"\"isv_no\":\"201600129391238873\"," .
"\"isv_name\":\"杭州少年宫\"," .
"\"isv_notify_url\":\"https://isv.com/xxx\"," .
"\"isv_pid\":\"2088121212121212\"," .
"\"isv_phone\":\"13300000000\"," .
"\"school_pid\":\"20880012939123234423\"," .
"\"bankcard_no\":\"P0004\"," .
"\"bank_uid\":\"20000293230232\"," .
"\"bank_notify_url\":\"https://www.xxx.xxx/xx\"," .
"\"bank_partner_id\":\"200002924334\"," .
"\"white_channel_code\":\"TESTBANK10301\"" .
"  }");
$result = $aop->execute ( $request); 

$responseNode = str_replace(".", "_", $request->getApiMethodName()) . "_response";
$resultCode = $result->$responseNode->code;
if(!empty($resultCode)&&$resultCode == 10000){
echo "成功";
} else {
echo "失败";
}

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.eco.edu.kt.schoolinfo.modify&app_id=4303&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
"school_name":"杭州市西湖第一实验学校",
"school_icon":"http://ecopublic-dev.oss-cn-hangzhou.aliyuncs.com/eco/edu_alipay/school/school.png",
"school_icon_type":"png",
"school_stdcode":"3133005132",
"school_type":"4",
"province_code":"330000",
"province_name":"浙江省",
"city_code":"330100",
"city_name":"杭州市",
"district_code":"330106",
"district_name":"西湖区",
"isv_no":"201600129391238873",
"isv_name":"杭州少年宫",
"isv_notify_url":"https://isv.com/xxx",
"isv_pid":"2088121212121212",
"isv_phone":"13300000000",
"school_pid":"20880012939123234423",
"bankcard_no":"P0004",
"bank_uid":"20000293230232",
"bank_notify_url":"https://www.xxx.xxx/xx",
"bank_partner_id":"200002924334",
"white_channel_code":"TESTBANK10301"
  }

//为确保安全通信，需自行验证响应示例中的sign值是否为蚂蚁金服所提供。

JSON示例

{
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
	"alipay_eco_edu_kt_schoolinfo_modify_response":{
		"msg":"Success",
		"code":"10000",
		"school_no":"11010100000002",
		"status":"Y"
	}
}

JSON示例

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

错误码	错误描述	解决方案
SYSTEM_ERROR	系统繁忙	请重试
INVALID_PARAMETER	参数有误。	检查请求参数，修改后重新发起请求。
INVALID_PARAMETER	参数有误。参数不正确,学校名称不正确	输入正确的学校名称
INVALID_PARAMETER	参数有误。参数不正确，省的编码不正确	请填写正确的省编码
INVALID_PARAMETER	参数有误。参数不正确，市的编码不正确	请填写正确的市编码
INVALID_PARAMETER	参数有误。参数不正确，区县编码不正确	请填写正确的区县编码
INVALID_PARAMETER	ISVPID参数参数有误。	请输入正确的ISVPID参数
INVALID_PARAMETER	参数有误参数有误，请输入正确的学校pid	检查学校pid是否签约
INVALID_PARAMETER	参数有误参数有误，学校pid和isv的pid重复	参数有误，学校pid和isv的pid重复
INVALID_PARAMETER	参数有误参数有误，请输入正确学校类型参数	输入正确的学校类型
INVALID_PARAMETER	参数有误SV电话参数有误	参数有误，请输入正确的ISV电话参数
INVALID_PARAMETER	参数有误参数有误，学校名称不存在	输入正确学校名称参数
INVALID_PARAMETER	参数有误参数有误，请输入正确的学校编码参数	输入正确的学校编码
INVALID_PARAMETER	参数有误参数有误，请输入正确参数	输入正确参数
BIZ_ERROR	业务异常系统异常, 请联系支付宝小二	重试或联系小二
BIZ_ERROR	业务异常系统繁忙, 请联系支付宝小二	重试或请联系小二

公共错误码

开放平台

教育服务API

alipay.eco.edu.kt.schoolinfo.modify (教育缴费学校信息录入接口)

公共参数

请求参数

公共响应参数

响应参数

请求示例

响应示例

异常示例

业务错误码

公共错误码