:::tip[]
请确保已经查阅接入准备-记账簿管理文档,并完成相关前置准备后查看本文档。
:::
H5管理
:::tip[]
通过接口调用H5页面进行开户、账户管理操作。开发成本低,方便快捷。开户申请前,可先了解账户属性与等级。
:::
开户
H5开户交互流程
调用[用户开户[页面接入]](apifox://link/endpoint/3477845)接口,个人用户`user_type`传`INNERUSER`,企业用户传`INNERCOMPANY`。`cust_trade_serial_type`字段可指定待激活开户`OpenActivatedUser`或者是正常开户`OpenNormalUser`。
用户跳转至开户申请接口返回`gateway_url`的地址,进入连连提供的H5开户页面流程,详细信息可看下方的图片。个人用户填写信息后,进行三要素验证,三要素验证失败则驳回开户申请。
待审核后,下发[个人用户开户结果通知](apifox://link/endpoint/3477836)或[企业用户开户结果通知](apifox://link/endpoint/3477837)至用户开户[页面接入]接口上传的`notify_url`处。
H5企业用户开户页面流程

H5个人用户开户页面流程

账户管理H5页面
调用账户管理H5页面页面,用户可通过返回的gateway_url,进入连连提供的H5页面进行账户管理、余额管理、银行卡管理等功能。
| 分类 |
具体功能 |
| 账户管理 |
修改注册手机号、修改支付密码、找回支付密码、注销账户 |
| 余额管理 |
提现、交易明细 |
| 银行卡管理 |
预留手机号页面、新增绑卡/换绑卡页面、解除绑卡 |
用户绑定卡管理H5页面
调用用户绑定卡管理接口,用户可通过返回的gateway_url,进入连连提供的H5页面进行新增绑卡或换绑卡操作。
API管理
:::tip[]
全程使用API接口,自定义程度高,流程可控。
:::
开户
API正常开户交互流程
通过[文件上传](apifox://link/endpoint/3477902)接口接上传统一社会信用代码证、法人身份证影印件等文件。
通过[绑定手机验证码申请](apifox://link/endpoint/3477814)接口向连连发起绑定手机请求,用于接收余额消费、提现代发等交易时的短信验证。
通过[绑定手机验证码验证](apifox://link/endpoint/3477815)接口,验证账户绑定手机号收到的短信验证码。
通过[随机密码因子获取](apifox://link/endpoint/3477903)接口或是[申请密码控件token](apifox://link/endpoint/3478026)接口,获取密码控件相关参数,以加密密码。
验证绑定手机后,调用[企业用户开户申请](apifox://link/endpoint/3477811)接口上传相关信息申请开户。
若为个体工商户且绑定的卡为法人银行卡时,需要调用[企业用户开户验证](apifox://link/endpoint/3477813)接口,验证绑卡验证短信(下发至银行预留手机号)和设置交易密码。
企业用户审核通过后,下发企业用户开户意愿确认短信至法人手机号或注册人手机号。企业用户开户意愿验证,有三种意愿确认方式,三种方式通过其一即开户意愿确认通过。详情可见下方企业用户开户意愿确认部分。
1、法人短验
2、法人人脸识别
3、上传[开户授权函](https://oss-mpay-static.lianlianpay.com/tps/54f05c63-889e-4ba2-8a3f-c0adbf3f65b4.docx)
待机器审核和人工审核完成后,下发[企业用户开户结果通知](https://api-doc.lianlianpay.com/openplatform/api-3477837)至企业用户开户申请接口上传的`norify_url`地址处。
通过[文件上传](apifox://link/endpoint/3477902)接口接上传二级户身份证影印件,也可选择不传。
通过[绑定手机验证码申请](apifox://link/endpoint/3477814)接口向连连发起绑定手机请求,用于接收余额消费、提现代发等交易时的短信验证。
通过[绑定手机验证码验证](apifox://link/endpoint/3477815)接口,验证账户绑定手机号收到的短信验证码。
验证绑定手机后,调用[个人用户开户申请](apifox://link/endpoint/3477810)接口上传相关信息申请开户。
通过[随机密码因子获取](apifox://link/endpoint/3477903)接口或是[申请密码控件token](apifox://link/endpoint/3478026)接口,获取密码控件相关参数,以加密密码。
调用[个人用户开户验证](apifox://link/endpoint/3477812)接口,验证绑卡验证短信(若在开户申请时上传绑卡信息)和设置交易密码。
若三要素校验不通过,则直接驳回开户申请。
待机器审核或是人工审核完成后,下发[个人用户开户结果通知](apifox://link/endpoint/3477836)至个人用户开户申请接口上传的`norify_url`地址处。
:::tip[]
短信验证码有效期10分钟,随机因子有效期30分钟,手机验证完成之后,半小时内要调开户。超过半小时,需要重新绑定手机和验证。
:::
API待激活开户交互流程
通过[文件上传](apifox://link/endpoint/3477902)接上传统一社会信用代码证、法人身份证影印件等文件。
调用[企业用户待激活开户](apifox://link/endpoint/3477817)接口,上传相关信息。
待审核后,接收[企业用户开户结果通知](apifox://link/endpoint/3477837),若开户成功,`user_status`应为`ACTIVATE_PENDING_NEW`
通过[文件上传](apifox://link/endpoint/3477902)接口接上传二级户身份证影印件,也可选择不传。
调用[个人用户待激活开户](apifox://link/endpoint/3477816)接口,上传相关信息。
待审核后,接收[个人用户开户结果通知](apifox://link/endpoint/3477836),若开户成功,`user_status`应为`ACTIVATE_PENDING_NEW`
API待激活户激活交互流程
通过[随机密码因子获取](apifox://link/endpoint/3477903)接口或是[申请密码控件token](apifox://link/endpoint/3478026)接口,获取密码控件相关参数,以加密密码。
调用[开户激活申请](apifox://link/endpoint/3477818)接口,输入密码控件加密的密码。
输入开户激活申请的token以及验证码进行[开户激活验证](apifox://link/endpoint/3477819)。验证码下发至用户注册手机号。
待审核后,接收[个人用户开户结果通知](apifox://link/endpoint/3477836)或[企业用户开户结果通知](apifox://link/endpoint/3477837)。
企业用户开户意愿确认
若未经企业用户开户意愿确认,则企业用户状态为ACTIVATE_PENDING_NEW待激活(待开户意愿确认),需要通过开户意愿确认后才可变为正常状态。
API普通开户意愿确认流程说明
在完成企业开户申请、验证等步骤,连连对企业用户完成审核后,会通过开户意愿短信的方式,要求用户完成企业用户开户意愿确认。完成意愿确认后,企业用户二级户才能正常使用。
API待激活开户意愿确认流程说明
在待激活户开户申请、验证后,会通过开户意愿短信的方式,要求用户完成企业用户开户意愿确认。完成意愿确认后,企业用户二级户才能正常使用。
开户意愿短信
下发至法人手机号、注册人手机号中。
通知内容
【连连支付】根据您本人或您授权代理人的申请,为XX(企业用户名称)开立账户,请30天内登录 %URL 进行意愿确认,若没有完成会影响使用。
开户意愿确认方法
有三种开户意愿确认的方法,通过其一即可。分别为:
1、法人短验
2、法人人脸识别
3、上传开户授权函
开户授权函
**开户意愿确认失败结果异步通知**
若用户开户意愿确认失败,会发送开户意愿确认失败结果异步通知,并返回开户意愿确认链接,平台可通知用户再次操作开户意愿确认。
若平台没有对接,用户也会再次收到短信通知,短信模板如下:
【连连支付】您本人或您授权代理人提交的企业开户意愿授权函已被审核驳回,请重新进入https://openweb.lianlianpay.com/business-platform/sign?serialId=**&tenantId=MIP_COMMON 进行意愿确认。
开户意愿链接查询
商户站可以查询用户开户意愿链接,如果用户没有收到短信,可以登录商户站查询,路径:商户站>用户管理>用户信息>详情
账户信息查询
可通过账户信息查询接口查询绑定合作银行账户、账户号、账户状态和余额等信息。
绑定银行账户管理
个人用户新增绑卡流程
:::caution[]
企业用户(包括个体工商户)只能绑定一个银行账户,只能换绑不能新增。
:::
通过[随机密码因子获取](apifox://link/endpoint/3477903)接口或是[申请密码控件token](apifox://link/endpoint/3478026)接口,获取密码控件相关参数,以加密密码。
调用[新增绑定银行账户申请](apifox://link/endpoint/3477820)接口,输入密码控件加密的密码。
输入新增绑卡申请的token以及验证码进行[新增绑定银行账户验证](apifox://link/endpoint/3477824)。接收验证码的手机号为银行卡预留手机号。
接收[绑定账户管理异步通知](apifox://link/endpoint/3477838),只有新增绑卡成功后会下发。
#### **个人用户解绑银行卡流程**
:::caution[]
企业用户绑定银行账户数量为1,无法解绑。个人用户可以绑定多张银行卡,支持解绑。只绑定一张卡时不可解绑。
:::
通过[随机密码因子获取](apifox://link/endpoint/3477903)接口或是[申请密码控件token](apifox://link/endpoint/3478026)接口,获取密码控件相关参数,以加密密码。
调用[用户解绑银行账户](apifox://link/endpoint/3477821)接口,输入需要解绑的银行卡号和用户密码。
接收[绑定账户管理异步通知](apifox://link/endpoint/3477838),获取解绑结果。
#### **更换绑定账户流程**
:::caution[]
企业用户(包括个体工商户)只能绑定一个银行账户,只能换绑不能新增。目前仅支持个人用户绑定一张卡的情况下进行更换绑定账户操作。
:::
通过[随机密码因子获取](apifox://link/endpoint/3477903)接口或是[申请密码控件token](apifox://link/endpoint/3478026)接口,获取密码控件相关参数,以加密密码。
调用[更换绑定银行账户申请](apifox://link/endpoint/3477822)接口,上传需要新绑定的银行账户相关信息和用户密码。
用户绑定账户类型是法人银行卡或个人卡时,需要调用[更换绑定银行账户验证](apifox://link/endpoint/3477825)接口验证。上传银行预留手机号收到的验证码进行验证。
用户申请换绑成功后,下发[绑定账户管理异步通知](apifox://link/endpoint/3477838)。
绑卡信息查询
可通过绑卡信息查询接口查询特定用户的绑定银行账户。
账户信息修改
用户信息修改流程
根据需要通过[文件上传](apifox://link/endpoint/3477902)接口上传相关材料。
企业用户请求[企业用户信息修改](apifox://link/endpoint/3477830)接口,个人用户请求[个人用户信息修改](apifox://link/endpoint/3477827)接口,上传相关材料和信息。
用户信息修改申请成功后,接收[用户信息修改异步通知](apifox://link/endpoint/3478233)。
用户等级修改流程
请求[用户等级修改](apifox://link/endpoint/3477828)接口,上传相关信息和需求的用户等级。
用户信息修改申请成功后,接收[用户信息修改异步通知](apifox://link/endpoint/3478233)。
用户账户等级升级后,涉及意愿验证步骤,注册手机号会收到包含意愿链接的短信,用户需打开链接完成意愿确认。
修改绑定手机流程
通过[随机密码因子获取](apifox://link/endpoint/3477903)接口或是[申请密码控件token](apifox://link/endpoint/3478026)接口,获取密码控件相关参数,以加密密码。
请求[修改绑定手机号申请](apifox://link/endpoint/3477829)接口,上传新绑定手机号等信息。
通过[修改绑定手机号验证](apifox://link/endpoint/3477831)接口验证下发至新绑定手机号的验证码。`txn_seqno`与申请的交易流水号一致。
修改绑定手机成功后,[修改绑定手机结果异步通知](apifox://link/endpoint/3477840)返回结果至修改绑定手机申请接口上传的`notify_url`处。
#### **修改预留手机流程**
请求[修改预留手机申请](apifox://link/endpoint/3477823)接口,上传新的银行预留手机号等信息。
通过[修改预留手机验证](apifox://link/endpoint/3477826)接口验证下发至新预留手机号的验证码。txn_seqno与申请的交易流水号一致。
修改预留手机成功后,[修改预留手机结果异步通知](apifox://link/endpoint/3478027)返回结果。
用户信息查询
通过用户信息查询接口,可查询用户编号、用户状态、合作银行账号和银行开户状态等信息。
密码管理
修改密码流程
通过[随机密码因子获取](apifox://link/endpoint/3477903)接口或是[申请密码控件token](apifox://link/endpoint/3478026)接口,获取密码控件相关参数,以加密密码。
调用[修改支付密码](apifox://link/endpoint/3477848)接口,输入旧的密码和新的密码。
找回密码流程
调用[找回密码申请](apifox://link/endpoint/3477850)接口,发起找回密码流程。
调用[找回密码验证](apifox://link/endpoint/3477849)接口,上传申请接口返回的token和下发的短信验证码进行验证。企业和个体工商户验证注册绑定手机号。个人验证银行预留手机号,未绑卡用户验证注册手机号。
密码校验流程
可通过支付密码校验接口校验密码。
销户
销户流程
通过[随机密码因子获取](apifox://link/endpoint/3477903)接口或是[申请密码控件token](apifox://link/endpoint/3478026)接口,获取密码控件相关参数,以加密密码。
调用[销户申请](apifox://link/endpoint/3477832)接口,发起销户流程。
销户成功后,下发[销户结果异步通知](apifox://link/endpoint/3477839)至销户申请接口上传的`notify_url`处。
委托授权
委托授权申请流程
请[协议申请](apifox://link/endpoint/3477871)接口,根据需求选择合适的免密免验协议类型,设定授权时间、单笔单日单月限额。
请求协议申请接口成功后,返回`gateway_url`,用户跳转至该地址完成签约。
下发[协议异步通知](apifox://link/endpoint/3477876)至申请接口上传的`notify_url`处。只有用户完成协议签署或协议修改后会返回。
委托授权修改流程
请求[协议修改申请](apifox://link/endpoint/3477872)接口,根据需求修改授权时间、单笔单日单月限额。
请求协议修改申请接口成功后,返回`gateway_url`,用户跳转至该地址完成协议修改签约。
接收[协议异步通知](apifox://link/endpoint/3477876)。只有用户完成协议签署或协议修改后会返回。
委托授权关闭流程
请求协议关闭接口,请求成功后即可关闭协议。
委托授权查询
行业代码
仅400代表个体工商户,其他都按企业审核标准。
| 编码 |
描述 |
| 110 |
内资-国有全资 |
| 120 |
内资-集体全资 |
| 130 |
内资-股份合作 |
| 141 |
内资-联营-国有联营 |
| 142 |
内资-联营-集体联营 |
| 143 |
内资-联营-国有与集体联营 |
| 149 |
内资-联营-其他联营 |
| 151 |
内资-有限责任(公司)-国有独资(公司) |
| 152 |
内资-有限责任(公司)-其他有限责任(公司) |
| 160 |
内资-股份有限(公司) |
| 171 |
内资-私有(私营)-独资 |
| 172 |
内资-私有(私营)-合伙 |
| 173 |
内资-私有(私营)-有限责任(公司) |
| 174 |
内资-私有(私营)-股份有限(公司) |
| 176 |
内资-其他私有 |
| 190 |
内资-其他内资 |
| 210 |
港澳台投资-内地和港澳台合资 |
| 220 |
港澳台投资-内地和港澳台合作 |
| 230 |
港澳台投资-港澳台独资 |
| 240 |
港澳台投资-港澳台投资股份有限(公司) |
| 250 |
港澳台投资-其他港澳台投资 |
| 310 |
国外投资-中外合资 |
| 320 |
国外投资-中外合作 |
| 330 |
国外投资-外资独资 |
| 340 |
国外投资-国外投资股份有限(公司) |
| 350 |
国外投资-其他国外投资 |
| 400 |
个体经营 |
| 500 |
国家党政机关 |
| 510 |
事业单位 |
| 600 |
军队 |
| 700 |
社会团体 |
| 810 |
境外公司-外资公司 |
| 820 |
境外公司-中资公司 |
| 830 |
境外公司-金融机构 |
| 900 |
外国政府 |