接口地址
生产环境：https://cus.allinpay.com/cusapi/activity/cusactivity
测试环境：https://syb-test.allinpay.com/vsppcusapi/activity/cusactivity
使用场景：
商户活动报名接口给予代理商为参加活动商户报送相关资料信息：
请求参数：
|
参数 |
参数名称 |
取值 |
可空 |
长度 |
备注 |
|---|---|---|---|---|---|
|
orgid |
代理商号 |
平台分配的代理商号 |
否 |
15 |
|
|
cusid |
商户号 |
平台分配的商户号 |
否 |
15 |
|
|
appid |
应用ID |
平台分配的机构APPID |
否 |
8 |
|
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
|
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
|
corpbusname |
营业执照名称 |
|
可 |
50 |
|
|
branchname |
门店名称 |
|
可 |
50 |
|
|
areacode |
所在地区 |
广东省广州市荔湾区 |
可 |
64 |
|
|
address |
详细地址 |
|
可 |
64 |
|
|
acttype |
活动类型 |
|
否 |
2 |
03表示饭堂活动 04表示教培活动 07教育行业非学校主体商户餐饮消费场景费率活动 08 教育行业学校主体食堂场景费率活动 09 微信商业医疗行业活动 10微信停车行业优惠 11微信商业医疗行业返佣活动 |
|
zippicurl |
报送资料 图片压缩包url |
|
否 |
128 |
具体格式请看下面详细介绍 （zippicurl压缩包格式） |
|
notifyurl |
回调url |
|
否 |
128 |
|
|
signtype |
签名类型 |
RSA/SM2 |
否 |
|
|
|
actdetail |
活动详细信息 |
ActdetailJsonObject acttype04.07.08.09.10.11为时必填 json字符串 材料需要提前调2.15上传文件接口 |
|
|
|
ActdetailJsonObject
当acctype=03 ,actdetail字段json格式如下
|
主体类型 |
材料id |
材料名 |
备注 |
|---|---|---|---|
|
企业/个体户 |
school_qualification_proof |
学校资质证明 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
cooperation_qualification_proof |
合作资质证明 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
|
activity_rate_commitment |
优惠费率承诺函 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
|
canteen_environment_photo |
食堂内部用餐环境照片 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
|
canteen_front_photo |
食堂门头照片 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
|
党政、机关及事业单位/其他组织 |
school_qualification_proof |
学校资质证明 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
school_license_proof |
办学许可证 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
|
canteen_front_photo |
食堂门头照片 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
|
canteen_environment_photo |
食堂内部用餐环境照片 |
材料需要提前调上传文件接口传入token值，不超过5张 |
例子：
{"school_qualification_proof":["2020110401zrirbwixriku","2020110401zrirbwixriku"],"cooperation_qualification_proof":["2020110401zrirbwixriku"],"activity_rate_commitment":["2020110401zrirbwixriku"],"canteen_environment_photo":["2020110401zrirbwixriku"],"canteen_front_photo":["2020110401zrirbwixriku"]}
当acctype=04 ,actdetail字段json格式如下
|
企业性质 |
材料id |
备注 |
备注 |
|---|---|---|---|
|
企业/个体户 |
qualification_proof |
机构资质证明 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
store_tenancy_proof |
门店租赁相关证明 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
|
store_door_photo |
门头照片 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
|
其他组织 |
qualification_proof |
机构资质证明 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
store_tenancy_proof |
门店租赁相关证明 |
材料需要提前调上传文件接口传入token值，不超过5张 |
|
|
store_door_photo |
门头照片 |
材料需要提前调上传文件接口传入token值，不超过5张 |
例子：
{"qualification_proof":["2020110401zrirbwixriku"],"store_tenancy_proof":["2020110401zrirbwixriku"],"store_door_photo":["2020110401zrirbwixriku"]}
当acctype=07 ,actdetail字段json格式如下
|
材料id |
备注 |
备注 |
|---|---|---|
|
school_qualification_proof |
学校资质证明 |
材料需要提前调上传文件接口 |
|
cooperation_qualification_proof |
合作资质证明 |
材料需要提前调上传文件接口 |
|
canteen_environment_photo |
食堂内部用餐环境照片 |
材料需要提前调上传文件接口 |
|
canteen_front_photo |
食堂门头照片 |
材料需要提前调上传文件接口 |
|
food_qualification_proof |
食品经营相关资质 |
材料需要提前调上传文件接口 |
例子：
{"school_qualification_proof":["2020110401zrirbwixriku"],"cooperation_qualification_proof":["2020110401zrirbwixriku"],"canteen_environment_photo":["2020110401zrirbwixriku"],"canteen_front_photo":["2020110401zrirbwixriku"],"food_qualification_proof":["2020110401zrirbwixriku"]}
当acctype=08 ,actdetail字段json格式如下
|
材料id |
备注 |
备注 |
|---|---|---|
|
school_qualification_proof |
学校资质证明 |
材料需要提前调上传文件接口 |
|
canteen_environment_photo |
食堂内部用餐环境照片 |
材料需要提前调上传文件接口 |
|
canteen_front_photo |
食堂门头照片 |
材料需要提前调上传文件接口 |
|
food_qualification_proof |
食品经营相关资质 |
材料需要提前调上传文件接口 |
例子：
{"school_qualification_proof":["2020110401zrirbwixriku"],"canteen_environment_photo":["2020110401zrirbwixriku"],"canteen_front_photo":["2020110401zrirbwixriku"],"food_qualification_proof":["2020110401zrirbwixriku"]}
当acctype=09 ,actdetail字段json格式如下
|
材料id |
备注 |
备注 |
|
medical_institution_pratice_license |
医疗机构执业许可证 |
材料需要提前调上传文件接口 |
|
hospital_frontdoor_photo |
医院门头照 |
材料需要提前调上传文件接口 |
当acctype=10 ,actdetail字段json格式如下
|
材料id |
备注 |
备注 |
|
parking_qualification_proof |
停车场资质证明 |
材料需要提前调上传文件接口 |
|
parkingarea_photo |
停车场实际经营场景照 |
材料需要提前调上传文件接口 |
当acctype=11 ,actdetail字段json格式如下
|
材料id |
备注 |
备注 |
|
image1 |
医疗机构执业许可证 |
必填,不超过1张，材料需要提前调上传文件接口 |
|
image2 |
补充照片 |
选填,不超过1张，材料需要提前调上传文件接口 |
其中zippicurl压缩包格式（压缩包内只能包含图片，并按规定做好相关命名）
1、zippicurl要求允许外网访问
2、压缩包名称尽量使用英文数字来表示
3、压缩包文件格式如下
第一层为文件目录，文件目录名称为接口参数名，目录里面保存的是图片文件名，表示接口参数要求的图片文件名
例如：
当acttype=07 时压缩包文件格式如下
响应参数：
|
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
|---|---|---|---|---|---|
|
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
SUCCESS-请求成功 FAIL-请求或前端处理失败，具体看retmsg |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
|
trxstatus |
状态码 |
1000|1999 |
否 |
4 |
1000: 获取结果成功 1999:获取结果失败 |
|
orgid |
代理商号 |
|
否 |
15 |
与请求一致 |
|
cusid |
商户号 |
|
否 |
15 |
与请求时一致 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
|
errmsg |
错误信息 |
|
是 |
100 |
|
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |