同步应缴项目

接口描述

对接方主动推送应缴项目至缴费大厅

申请方式

发送邮件到hongfuhuang@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com,leowyang@tencent.com,luishhuang@tencent.com)，申请时需要注明APPKEY和使用场景

请求方法：

POST(application/json)

请求地址：

https://jf.weixiao.qq.com/api/open/project/syncUserArrear

参数说明：

{
    "timestamp":"1598950772",
    "app_key":"802FD0E12FF77984",
    "nonce":"1234567890",
    "school_code":"1013957946",
    "signature":"7A0EC39D2C0790A63586F2A4391ED7EC",
    "data":[
        {
            "card_number":"5110006235",
            "name":"陈小东",
            "arrears":[
                {
                    "project_name":"住宿费",
                    "project_code":"X123",
                    "project_note":"房间号:123\n度数:122",
                    "project_description":"统一四人间",
                    "project_mch_id":"1900008371",
                    "amount":"80000",
                    "arrear_amount":"80000",
                    "year":"2018",
                    "semester":"1",
                    "is_batch":0,
                    "is_need":0,
                    "status":0,
                    "end_at":"2019-01-01 00:00:00"
                }
            ]
        },
        {
            "card_number":"68686868",
            "name":"李华",
            "arrears":[
                {
                    "project_name":"学费",
                    "project_code":"X223",
                    "project_description":"上学期学费",
                    "amount":"60000",
                    "arrear_amount":"60000",
                    "status":0
                }
            ]
        }
    ]
}

参数	必填	类型	实例	说明
timestamp	是	Integer	1598950772	当前时间戳
app_key	是	String	802FD0E12FF77984	主体appKey
nonce	是	String	NONCE	随机字符串
school_code	是	String	1013957946	主体code
signature	是	String	7A0EC39D2C0790A63586F2A4391ED7EC	签名
data	是	Array	[]	缴费项数据

其中data的每一项表示每个用户的缴费数据，参数说明如下：

参数	必填	类型	示例	说明
card_number	是	String(32)	5110006235	学号
name	是	String(32)	学生A	姓名
arrears	是	Array	[]	缴费项
project_name	是	String(255)	缴费对接	缴费项目名称
project_code	是	String(255)	X123	缴费项目编号（需保证唯一）
project_description	否	String(255)	统一四人间	缴费项目描述
project_mch_id	否	String(255)	1900008371	缴费项目收款商户号
project_note	否	String(255)	房间号:123\n度数:122	缴费说明
amount	是	Int	80000	缴费项目应缴金额（单位为分）
arrear_amount	是	Int	80000	缴费项目待缴金额（单位为分）
year	否	Int	2018	年份，默认为0，不分学年
semester	否	Int	1	学期，默认为0，不分学期
is_batch	否	Int	0	是否允许分次缴费，默认为0不允许分次缴费，1为允许分次缴费
is_need	否	Int	0	是否必缴，默认为0非必缴,1为必缴
status	否	Int	0	缴费状态，默认为0未缴完，1为缴费完成，2 已过期， 3 已删除， 4缓交/助学贷款
end_at	否	Datetime	2019-01-01 00:00:00	项目截止时间

说明

• project_mch_id 为收款商户号，仅在创建缴费项目（首次同步至微校）时有效，已创建的项目不允许更改收款商户，否则将导致同步失败。

响应说明：

{
    "code": 0,
    "message": "ok"
}

参数				必填	类型	实例	说明
code				Integer	是	0	响应状态码，0为成功，其他为失败
message				String	是	ok	响应状态信息

签名算法

签名算法统一使用微校签名算法 (opens new window) APP KEY 采用的是学校服务商或者学校的APP KEY