注意：以下文档只适用于TOP接口，请谨慎使用！

文档中心 > API类目 > 教育服务API

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

ISV与支付宝签约后，通过此接口同步学校信息到中小学教育平台。

公共参数

请求地址：
环境 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("调用失败");
}

响应示例

  • 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 业务异常系统繁忙, 请联系支付宝小二 重试或请联系小二

公共错误码

公共错误码
有用(2)
我要提问
返回
顶部

阿里巴巴集团|淘宝网|天猫|聚划算|全球速卖通|阿里巴巴国际交易市场|1688|阿里妈妈|阿里旅行 · 去啊|阿里云计算|YunOS|阿里通信|万网|高德|UC|友盟+

虾米|天天动听|来往|钉钉|支付宝

© 2009-2017 Aliyun.com 版权所有 ICP证：浙B2-20080101售前咨询 技术支持官方微博