需求文档写法

第一章引言

1.1项目概述、背景

第二章业务说明

2.1总体说明

2.2业务流程

2.2.1交易业务流程图

• 会员批量开户及绑卡/换卡

  商户平台进行批量注册绑卡，通过资金账户管理系统进行账户验证，建立相应的会员信息账户及子账户。通过4要素验证绑卡则用户允许投资及提现，只通过实名认证的用户仅允许融资，充值；若批量换卡，通过资金账户管理系统账户验证进行登记并解绑，通过短验绑卡重新绑定。具体业务流程图如下：

  

第三章开发规范

3.1通讯规范

3.2安全规范

3.3注意事项

• 接口中各项参数当标识是M时参数必选，为O时可选。
• 接口说明中，若参数字体为红色，请仔细阅读备注说明。
• 日期格式C(8)表示 YYYYMMDD 例如：20170101
• 时间格式C(6)表示 HHmmSS 例如 120101
• 个人代付异步通知为30秒一次，通知10次
• 其他异步通知为2分钟一次，通知10次。

3.4接口示例

说明：

​ 1、请求ip地址为网络联调时候提供的地址；

​ 2、提交方式为表单提交，采用post方式

​ 3、请求参数中注明是JSON格式，表单提交时候 JSON作为字符串提交

	例如：name=data  value={"remark": "d1234567" }

​ 4、请求响应为json格式

接口说明：

请求参数说明：

限制：M必填，O选填

响应参数：

第四章接口描述

4.1用户相关

4.1.1批量开户（四要素绑卡）

接口说明：

请求参数说明：

限制：M必填，O选填

参数	限制	长度	说明
plat_no	M	C(32)	商户平台在资金账户管理平台注册的平台编号
order_no	M	C(50)	批量订单号
partner_trans_date	M	C(8)	商户交易日期
partner_trans_time	M	C6	商户交易时间
total_num	M	N	总数量
data	M		JsonArray，批量明细数据
data .detail_no	M	C(30)	明细编号
data .name	M	C(10)	用户姓名
data .id_type	M	C(2)	证件类型（1：身份证）
data .id_code	M	C(20)	证件号码
data .mobile	M	C(20)	手机号码
data .email	O	C(30)	电子邮箱
data .sex	O	C(2)	性别（0:男性，1:女性）
data .cus_type	O	C(1)	客户类型（1:个人客户），仅限个人
data .birthday	O	C(32)	出生日期
data .open_branch	O	C(50)	开户行
data .card_no	M	C(25)	卡号
data .card_type	O	C(1)	卡类型(1:借记卡，2:信用卡)
data .pre_mobile	M	C(20)	预留手机号
data .pay_code	M	C(20)	支付通道
data .notify_url	O	C(100)	异步通知地址，企业客户必填
data .remark	O	C(600)	备注
signdata	M		签名数据

响应参数：

格式	json
格式示例

参数	限制	说明
recode	M	返回码，10000为整个批量订单受理成功，具体单条数据的处理结果，要查看成功信息或失败信息
remsg	M	返回结果描述
plat_no	O	平台编号(批量订单受理成功时，则必填)
order_no	O	订单编号(批量订单受理成功时，则必填)
finish_datetime	O	处理完成时间(批量订单受理成功时，则必填)
signdata	M	签名数据
order_status	O	订单状态(批量订单受理成功时，则必填)
order_info	O	订单处理信息(批量订单受理成功时，则必填)
total_num	O	订单请求数量(批量订单受理成功时，则必填)
success_num	O	成功数量(批量订单受理成功时，则必填)
success_data	O	JsonArray成功信息（有处理成功的数据时，则为必填参数；其中detail_no、mobile、platcust为必填信息）
success_data .detail_no	M	明细编号
success_data .mobile	M	用户手机号
success_data .platcust	M	平台客户编号
error_data	O	JsonArray失败信息（有处理失败的数据时，则为必填参数；其中error_no、error_info为必填信息）
error_data.detail_no	M	明细编号
error_data .error_no	M	错误编码
error_data. error_info	M	错误描述

.

.

.

附录

5.1返回码对照表

此对照表为绑定支付本地返回码对照表，不包含交易核心返回码对照。在一次交易请求中，当且仅当返回码为10000时表示请求成功，当返回码不为10000时，可取返回码文本介绍

返回码	返回码文本介绍	说明
10002	参数格式不匹配
20001	缺少必要参数
20002	参数错误
20003	签名错误
20004	appid为空
20005	appid错误
20014	平台编号为空
20015	平台编号错误
20016	订单号重复
20017	原订单号错误
20018	原订单未处理成功（针对确认操作时）
21000	参数长度过长
30001	未知错误
30002	数据库操作异常
30003	空指针异常
30004	IO操作异常
30005	数学运算异常
30006	数组越界
30007	方法参数错误
30008	类转换异常
30009	违背安全原则
30010	SQL操作异常
30011	运行异常
30012	方法名不存在
30013	服务器繁忙
31111	远程调用端错误
32222	远程未知状况
34401	未查询到订单信息
40001	无效的产品id
40002	用户密码错误
40003	用户名重复
40004	无效的open_id
40005	无效的邀请码
40006	实名认证失败
40007	账号无效或不存在
40008	重复的产品id
40009	无效的转让编号
40010	无效的平台编号
40011	标的已满额
40012	标的状态不许购买
40013	用户在黑名单中
40014	标的未成标
40015	请求账户与融资人提取账户信息是否一致
40016	不满足转让条件
40017	不在误差范围内
40018	出账金额不足
40019	标的未满额
40020	金额有误
40021	标的已成标
41000	还款失败
45000	已注册
45001	未注册
46000	已绑卡
47000	用户无权进行此操作
50001	充值金额不合法
50002	支付失败
50003	网络异常
50004	用户此渠道下未绑定卡
50005	bindid不存在
50006	绑卡失败
50007	解绑失败
50008	获取验证码失败
50009	没有渠道信息
50010	未知渠道
50011	已经绑过卡，不要重复绑卡
50012	实名认证失败
50013	未绑卡
50014	余额不足
50015	提现失败
50016	余额查询失败
50017	查询绑卡信息失败
50018	下载对账文件失败
50019	转账原因不合法
50020	超出转账额度
50021	超出月转账额度
50022	活期标暂不支持垫付出账

5.2数据字典

类型	编号	备注
证件类型	1	身份证
性别	0	男
性别	1	女
客户类型	1	个人客户
客户类型	2	企业客户
卡类型	1	借记卡
卡类型	2	信用卡
订单状态	0	处理中
订单状态	1	交易成功
订单状态	2	交易失败
订单状态	11	请求成功
订单状态	12	请求失败
订单状态	21	确认成功
订单状态	22	确认失败
婚姻状态	0	已婚
婚姻状态	1	未婚
有无	0	有
有无	1	无
产品类型	0	周期性产品
产品类型	1	活期产品
产品起息方式	0	满额起息
产品起息方式	1	成立起息
产品起息方式	2	投标起息
产品起息方式	3	成立审核后起息
成立方式	0	满额成立
成立方式	1	成立日成立
成立方式	2	活期方式
周期单位	1	日
周期单位	2	周
周期单位	3	月
周期单位	4	季
周期单位	5	年
还款方式	0	按月等额本金
还款方式	1	按月等额本息
还款方式	2	按季等额本金
还款方式	3	按季等额本息
还款方式	4	到期日一次性还款
还款方式	5	按期还息到期还本
分红方式	0	成立分红
分红方式	1	还款分红
是否	0	是
是否	1	否
自动出账	0	自动出账
自动出账	1	手动出账
成废标记	2	成标
成废标记	3	废标
科目优先级	0	可提优先
科目优先级	1	可投优先
科目优先级	2	均分
充值类型	0	用户充值
充值类型	1	平台充值
平台子账户	01	自有子账户
平台子账户	02	体验金子账户
交易状态	0	成功
交易状态	1	失败
冻结解冻标示	0	冻结
冻结解冻标示	1	解冻
是否预对账	0	否
是否预对账	1	是
提现审核	0	允许提现
提现审核	1	拒绝提现

5.3银行编码

参考XX

5.4支付通道

011行内代付通道；018 中金；029 连连；041 联动优势；051 易宝；061 翼支付；071 富友；072 银盈通；073 美付宝；099 行内验卡通道； 101 京东；