开户意愿核实

功能概述

商户通过此接口提交开户意愿核实申请。

接口地址

https://apis.5upay.com/serviceprovider/declaration/openaccountintendconfirm/submitApply

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
partnerId 服务商编号 varchar(9) 子商户上属服务商商户在首信易系统的唯一身份标识,商户可登录商户后台查看 M
merchantId 商户编号 varchar(9) 商户在首信易系统唯一身份标识,商户可登录商户后台查看 M
requestId 开户意愿核实订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已报备成功或失败的订单,商户平台不能以相同订单号再次提交 M
reportRequestId 报备订单号 varchar(50) 微信或支付宝报备时的订单号requestId M
applyTimeout 超时时间 varchar(7) 开户意愿核实申请超时时间,以秒为单位,最长不超过30天;最小不能小于3天;不填默认30天 O
notifyUrl 异步通知地址 varchar(200) 服务器通知:当开户意愿核实申请有结果后会向该地址发送通知,该地址可以带参数,如:“https://www.5upay.com/callback.action?test=test”. M
name 超级管理员姓名 varchar(128) 超级管理员(联系人)姓名,支付宝渠道:必填,微信渠道:默认取法人信息 C
mobile 超级管理员手机号 varchar(11) 超级管理员(联系人)手机号,支付宝渠道: 必填,微信渠道:默认取法人信息 C
idCardNumber 超级管理员身份证号码 varchar(18) 超级管理员(联系人)身份证号码,支付宝渠道:必填,微信渠道:默认取法人信息 C
microBizType 小微商户经营类型 固定值 当渠道类型为“微信“时可选 C
MICRO_TYPE_STORE 门店场所
MICRO_TYPE_MOBILE 流动经营/便民服务
MICRO_TYPE_ONLINE 线上商品/服务交易
当渠道类型为“支付宝”时可选
STORE 线上商品/服务交易----门店场所
STALL 流动经营/便民服务----流动经营
小微商户必填
storeName 门店名称 varchar(128) 填写规范: C
门店场所:填写门店名称
流动经营/便民服务:填写经营/服务名称
线上商品/服务交易:填写线上店铺名称
小微商户必填
storeHeaderCopy 门店门头照片路径 varchar(256) 默认取商户入网填写的门店门头照(若传参就按照商户传的为准),需上传到sftp,见开发者服务-sftp数据传输说明 C
门店场所:提交门店门口照片,要求招牌清晰可见
流动经营/便民服务:提交经营/服务现场照片
线上商品/服务交易:提交店铺首页截图
小微商户必填
storeIndoorCopy 店内环境照片路径 varchar(256) 默认取商户入网的店内环境照(若传参就按照商户传的为准),需上传到sftp,见开发者服务-sftp数据传输说明 C
门店场所:提交店内环境照片
流动经营/便民服务:可提交另一张经营/服务现场照片
线上商品/服务交易:提交店铺管理后台截图
小微商户必填
channelType 渠道类型 固定值 WECHAT 微信 O
ALIPAY 支付宝,若不填默认微信。
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "applyTimeout": "", "hmac": "304502201be14243f4fc5dbe19b52249ce3b80ec727898bb53f67113 c3766af0804b4a10022100d2ec7cd6bc9133c8ef40a35a94dc3c8ab160786 b4cfb87a073238d0d5364ae0b", "idCardNumber": "132***287X", "merchantId": "8921**46", "microBizType": "", "mobile": "138***1847", "name": "张三", "notifyUrl": "http://www.baidu.com", "partnerId": "890***14", "reportRequestId": "1652***730", "requestId": "1652***4505", "storeHeaderCopy": "", "storeIndoorCopy": "", "storeName": "" }

请求返回参数列表

参数名称 参数中文名称 参数说明
partnerId 服务商编号 同请求参数
merchantId 商户编号 同请求参数
requestId 开户意愿核实订单号 同请求参数
status 响应状态 SUCCESS 成功
FAILED 失败
applymentId 申请单编号 微信支付宝返回的申请单编号
errCode 错误代码 错误代码
errCodeDesc 错误代码描述 错误代码描述
channelType 渠道类型 同请求参数
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "applymentId": "20000***2800", "merchantId": "89***46", "partnerId": "89***14", "requestId": "16528***04505", "hmac": "r/hECaJ6LLYI2/HBxa7OwWSs2OBSgf7vWomGk87fioNsgknoyjyIqO3s6v w2JxSi5J7flU1mIQUytBA+pP+ahVghKg==", "status": "SUCCESS" }

异步返回参数列表

参数名称 参数中文名称 参数说明
partnerId 服务商编号 同请求参数
merchantId 商户编号 同请求参数
applyRequestId 开户意愿核实订单号 同请求参数
reportStatus 意愿核实状态 AUDIT 审核中
APPLYMENT_STATE_REJECTED 审核驳回
AUTHORIZE_STATE_AUTHORIZED 已授权
AUTHORIZE_STATE_UNAUTHORIZED 未授权
APPLYMENT_STATE_CANCELED 已撤回
FAILED 失败
qrcodeData 二维码图片 意愿核实状态为未授权状态时返回
rejectParam 驳回参数 驳回参数
rejectReason 驳回原因 驳回原因
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "applyRequestId": "1652***4505", "reportStatus": "AUTHORIZE_STATE_UNAUTHORIZED", "merchantId": "89***46", "partnerId": "89***14", "qrcodeData": "http://weixin.qq.com/q/02-sMg8HoreR21BguJxyce", "hmac": "r/hECaJ6LLYI2/HBxa7OwWSs2OBSgf7vWomGk87fioNsgknoyjyIqO3s6vl i5J7flU1mIQUytBA+pP+ahVghKg==" }