教育缴费学校信息录入接口

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

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/eco/edu/kt/schoolinfo/modify' \ --header 'Content-Type: application/json' \ --data-raw '{ "bank_notify_url": "https://www.xxx.xxx/xx", "bank_partner_id": "200002924334", "bank_uid": "20000293230232", "bankcard_no": "P0004", "batch_no": "201812180111030000034567270022", "card_alias_no": "c6c0c7a1b9d54e5db9d49eed39f00e65", "city_code": "330100", "city_name": "杭州市", "corporate_branch_pid": "2088301031335812", "district_code": "330106", "district_name": "西湖区", "isv_name": "杭州少年宫", "isv_no": "201600129391238873", "isv_notify_url": "https://isv.com/xxx", "isv_phone": "13300000000", "isv_pid": "2088121212121212", "province_code": "330000", "province_name": "浙江省", "school_icon": "http://ecopublic-dev.oss-cn-hangzhou.aliyuncs.com/eco/edu_alipay/school/school.png", "school_icon_type": "png", "school_name": "杭州市西湖第一实验学校", "school_pid": "20880012939123234423", "school_stdcode": "3133005132", "school_type": "4", "smid": "2088301031335814", "trans_in": "4325353", "white_channel_code": "TESTBANK10301" }'

请求参数

Body 参数application/json

bank_notify_url

string

可选

与浙江网商交易见证平台有交互ISV输入网商交易异步通知回调URL，教育缴费同步账单信息给网商，网商会回调此url，ISV即可获取网商相关的参数，根据教育缴费平台账单发送接口返回的 order_no和网商返回的outer_trade_no来对应账单信息。

示例值:

https://www.xxx.xxx/xx

bank_partner_id

string

可选

与浙江网商交易见证平台有交互的ISV,由交易见证平台分配给合作方业务平台签约唯一ID ，由网商分配给ISV的渠道参数

示例值:

200002924334

bank_uid

string

可选

与浙江网商交易见证平台有交互的ISV在创建账户时的uid，也就是ISV平台上的用户ID（字母或数字）

示例值:

20000293230232

bankcard_no

string

可选

对应集团到卡模式的银行编号.学校与支付宝后台签约时，由学校提交给支付宝的编号

示例值:

P0004

batch_no

string

可选

集团收单模式：分账批次号，支付宝配置后提供的银行卡批次号

示例值:

201812180111030000034567270022

card_alias_no

string

可选

学校开通直付通卡编号，smid与card_alias_no必须同时填写

示例值:

c6c0c7a1b9d54e5db9d49eed39f00e65

city_code

string

可选

城市的国家编码。参见国家统计局出版的行政区划代码。

示例值:

330100

city_name

string

城市名称

可选

示例值:

杭州市

corporate_branch_pid

string

可选

集团收单模式：BD批量上传银行卡信息后，支付宝系统分配给ISV的每个卡分配的唯一标识

示例值:

2088301031335812

district_code

string

可选

区县的国家编码。参见国家统计局出版的行政区划代码。

示例值:

330106

district_name

string

区县名称

可选

示例值:

西湖区

isv_name

string

可选

ISV公司名称，会在账单详情页面展示给用户

示例值:

杭州少年宫

isv_no

string

可选

注意：本参数于2017-08-03开始已经废弃，不再需要传递。由支付宝提供的给已经签约的isv的编码，业务上一般直接采用isv的支付宝PID。

示例值:

201600129391238873

isv_notify_url

string

可选

此通知地址是为了保持教育缴费平台与ISV商户支付状态一致性。用户支付成功后，支付宝会根据本isv_notify_url(异步通知说明https://docs.open.alipay.com/203/105286/)，通过POST请求的形式将支付结果作为参数通知到商户系统，ISV商户可以根据返回的参数更新账单状态。

示例值:

https://isv.com/xxx

isv_phone

string

可选

ISV的联系方式，会在账单详情页面展示给用户，用户有问题可以直接联系此电话获取帮助

示例值:

13300000000

isv_pid

string

可选

填写已经签约教育缴费的isv的支付宝PID

示例值:

2088121212121212

province_code

string

可选

省份的国家编码，参见国家统计局出版的行政区划代码。

示例值:

330000

province_name

string

省名称

可选

示例值:

浙江省

school_icon

string

可选

学校的校徽或logo，在学校展示页面作为学校的标识。该字段为图片的链接地址，只支持png或jpg图片格式，图片高度为108，宽度为108 ，不大于20k。注意：此链接要求公网可以访问，否则无法正常展示。

示例值:

http://ecopublic-dev.oss-cn-hangzhou.aliyuncs.com/eco/edu_alipay/school/school.png

school_icon_type

string

可选

如果填写了school_icon参数，则此字段不能为空。目前只支持png和jpg两种格式

示例值:

png

school_name

string

学校名称

可选

示例值:

杭州市西湖第一实验学校

school_pid

string

可选

学校签约支付宝教育缴费支付宝pid,如果是直付通学校，填写直付通返回的smid

示例值:

20880012939123234423

school_stdcode

string

可选

学校(机构)标识码（由教育部按照国家标准及编码规则编制，可以在教育局官网查询）

示例值:

3133005132

school_type

string

可选

学校的类型。枚举值如下： *1：代表托儿所。 *2：代表幼儿园。 *3：代表小学。 *4：代表初中。 *5：代表高中。注意：如果学校兼有多种属性，可以连写，比如：45：代表兼有初中部高中部；34：代表兼有小学部初中部。

示例值:

smid

string

可选

学校开通直付通返回的二级商户id，smid与card_alias_no必须同时填写

示例值:

2088301031335814

trans_in

string

可选

集团收单模式：分账批次号，支付宝配置后提供的银行卡批次号

示例值:

4325353

white_channel_code

string

可选

与浙江网商交易见证平台有交互的ISV,由网商分配给ISV的渠道参数

示例值:

TESTBANK10301

示例

application/json

Body

school_no

string

可选

支付宝分配给学校的编码，作为学校在支付宝的标识

示例值:

11010100000002

status

string

可选

Y：代表成功；N：代表失败

示例值:

教育缴费学校信息录入接口

请求参数

返回响应