教育缴费账单发送接口

商家发送教育缴费账单给孩子，家长在支付宝可以查看自己绑定的孩子的缴费账单。

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/eco/edu/kt/billing/send' \ --header 'Content-Type: application/json' \ --data-raw '{ "ext_info": { "order_pay_type": "1", "royalty_amount": "0.01", "trans_in_pid": "分账收入户PID" }, "amount": "88.88", "charge_bill_title": "学生开学收费项", "charge_item": [ { "item_mandatory": "N", "item_maximum": 5, "item_name": "校服费", "item_price": "8.88", "item_serial_number": 1 } ], "charge_type": "M", "child_name": "张晓晓", "class_in": "3班", "end_enable": "Y", "grade": "高一", "out_trade_no": "20160232343253253453", "partner_id": "201600129391238873", "school_no": "11010100000002", "school_pid": "20880012939123234423", "student_code": "2098453900091", "student_identify": "310193199905289483", "users": [ { "user_change_mobile": "string", "user_mobile": "string", "user_name": "string", "user_relation": "string" } ], "gmt_end": {} }'

请求参数

Body 参数application/json

ext_info

object (BillSendExtInfo)

可选

order_pay_type

string

可选

账单唤起收银台的方式： 1-手机wap;2-当面付。默认值为1（不传值或传非数字值）

示例值:

royalty_amount

string

分账金额

可选

示例值:

0.01

trans_in_pid

string

2088xxx

可选

示例值:

分账收入户PID

amount

string

可选

总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]，如果是非多选项，是要和缴费项的总和相同，多选模式不做验证

示例值:

88.88

charge_bill_title

string

缴费账单名称

可选

示例值:

学生开学收费项

charge_item

array[object (ChargeItems) {5}]

可选

缴费详情：输入json格式字符串。Json定义：key填写缴费项名称，value填写缴费项金额，金额保留2位小数

item_mandatory

string

可选

缴费项是否必选如果缴费项是多选模式，此参数生效。 “Y”表示必填，“N”或空表示非必填。

示例值:

item_maximum

integer

可选

缴费项最大可选数如果缴费项是多选模式，此参数生效，范围是1-9，如果为空，则最大项默认为9

示例值:

item_name

string

缴费项名称

可选

示例值:

校服费

item_price

string

缴费项金额

可选

示例值:

8.88

item_serial_number

integer

可选

缴费项序号，如果缴费项是多选模式，此项为必填，建议从1开始的连续数字，用户支付成功后，通过passback_params参数带回已选择的缴费项。例如:orderNo=uoo234234&isvOrderNo=24werwe&items=1-2|2-1|3-5 1-2|2-1|3-5 表示：缴费项序列号-缴费项数|缴费项序列号-缴费项数

示例值:

charge_type

string

可选

缴费项模式：空或"N"，表示缴费项不可选， "M"表示缴费项为可选，支持单选和多选。

示例值:

child_name

string

孩子名字

可选

示例值:

张晓晓

class_in

string

孩子所在班级

可选

示例值:

3班

end_enable

string

可选

截止日期是否生效，与gmt_end发布配合使用,N为gmt_end不生效，用户过期后仍可以缴费；Y为gmt_end生效，用户过期后，不能再缴费。

示例值:

grade

string

孩子所在年级

可选

示例值:

高一

out_trade_no

string

可选

ISV端的缴费账单编号

示例值:

20160232343253253453

partner_id

string

可选

Isv支付宝pid, 支付宝签约后，返回给ISV编号

示例值:

201600129391238873

school_no

string

可选

学校编码，录入学校接口返回的参数

示例值:

11010100000002

school_pid

string

可选

学校支付宝pid,直付通填写smid

示例值:

20880012939123234423

student_code

string

可选

学生的学号，只支持字母和数字类型，一般以教育局学号为准，作为学生的唯一标识。此字段与student_identify、家长user_mobile至少选一个

示例值:

2098453900091

student_identify

string

可选

学生的身份证号，如果ISV有学生身份证号，则同步身份证号作为学生唯一标识。此字段与student_code、家长user_mobile至少选一个。大陆身份证必须是18位，其它地区或国家的身份证开头需要加"IC"开头区分并且不超过18位，但查询账单的时候不要带"IC"

示例值:

310193199905289483

users

array[object (UserDetails) {4}]

可选

孩子的家长信息，最多一次输入10个家长，此字段做为识别家长的孩子用，与student_identify、student_code至少选一个

user_change_mobile

string

可选

用户变更手机号，替换旧的手机号

user_mobile

string

孩子家长的手机号

可选

user_name

string

张三

可选

user_relation

string

可选

孩子与家长的关系： 1、爸爸 2、妈妈 3、爷爷 4、奶奶 5、外公 6、外婆 7、家长

gmt_end

string

可选

缴费截止时间，格式"yyyy-MM-dd HH:mm:ss"，日期要大于当前时间。请注意，过期时间不宜设置过短。

示例值:

{}

示例

教育缴费账单发送接口

请求参数

返回响应