融赋通平台商户API接口V1.0.3

岭世科技融赋通平台是岭世科技面向自由职业者结算报税需求的专业平台,其支持具有开发能力的企业商户通过API接口调用方式获取以下服务. PS: 第二章和第三章主要说明对接API前期所需的一些准备工作; 第四章平台服务接口规范对平台开放的API进行了详细说明; 第五章对API的签名加密规则和返回码进行详细说明; 第六章 补充说明中,对于接口开发流程做了详细描述,请注意阅读; 第七章 API账号信息[测试环境]中,提供了测试环境参数可直接拿来调试用;


1.返回码描述

<h1>1、接口返回码</h1> <table> <thead> <tr> <th>返回码</th> <th>信息</th> <th>推荐处置</th> </tr> </thead> <tbody> <tr> <td>0000</td> <td>成功</td> <td>对于非审核下发交易,返回该返回码表示操作或验证成功,对于审核下发交易,只表示受理成功</td> </tr> <tr> <td>A001</td> <td>证件格式校验失败</td> <td>检查上送的用户证件信息格式是否正确</td> </tr> <tr> <td>A002</td> <td>银行卡号校验失败</td> <td>检查上送的银行卡号信息格式是否正确</td> </tr> <tr> <td>A003</td> <td>验证失败</td> <td>上送的姓名,证件,账号关联性验证失败</td> </tr> <tr> <td>D001</td> <td>通讯中断</td> <td>由于网络传输等异常原因,未能完整接收商户调用数据,若为下发交易请查询状态</td> </tr> <tr> <td>T001</td> <td>下发请求号已存在</td> <td>不可上送重复下发请求号</td> </tr> <tr> <td>T002</td> <td>下发请求号不存在</td> <td>请检查上送下发请求号是否正确</td> </tr> <tr> <td>T003</td> <td>下发处理单号不存在</td> <td>请检查上送下发处理单号是否正确</td> </tr> <tr> <td>T004</td> <td>下发公司ID不存在</td> <td>上送的下发公司id不存在</td> </tr> <tr> <td>T005</td> <td>协议失效</td> <td>上送的下发公司与商户不具有有效的协议</td> </tr> <tr> <td>T006</td> <td>余额不足</td> <td>商户于下发公司的余额不足</td> </tr> <tr> <td>T007</td> <td>用户未签约</td> <td>用户未与下发公司完成签约,而下发公司不支持先发放后签约</td> </tr> <tr> <td>T008</td> <td>下发超限</td> <td>测试模式下单笔下发金额超出下发公司金额限制</td> </tr> <tr> <td>T009</td> <td>实名校验失败</td> <td>上送的用户姓名与证件号可能不符,请核查</td> </tr> <tr> <td>T010</td> <td>下发批次号重复</td> <td>不可上送重复下发批次号</td> </tr> <tr> <td>T011</td> <td>下发批次号不存在</td> <td>请检查上送下发批次单号是否正确</td> </tr> <tr> <td>T012</td> <td>无对应费率档位配置信息</td> <td>该用户个人于该下发公司当月累计下发金额(含当前下发金额)无对应费率档位支持</td> </tr> <tr> <td>T013</td> <td>单笔交易超限额</td> <td>该笔下发金额超出下发公司支持最大的单笔限额</td> </tr> <tr> <td>T014</td> <td>日累计交易超限额</td> <td>该用户个人于该下发公司当日累计下发金额超出下发公司支持的最大当日累计限额</td> </tr> <tr> <td>T015</td> <td>月累计交易超限额</td> <td>该用户个人于该下发公司当月累计下发金额超出下发公司支持的最大当月累计限额</td> </tr> <tr> <td>T016</td> <td>季度累计交易超限额</td> <td>该用户个人于该下发公司当季度累计下发金额超出下发公司支持的最大当季度累计限额</td> </tr> <tr> <td>T017</td> <td>商户未配置协议</td> <td>请联系客户人员联系客户人员配置对应的签约协议</td> </tr> <tr> <td>T018</td> <td>协议签署中或者正在审核中,请稍后再试</td> <td>协议正在审核中,不要频繁提交,等签署落地(成功或者失败)</td> </tr> <tr> <td>T019</td> <td>图片解析异常</td> <td>提交的图片无法解析,参照上送图片规则</td> </tr> <tr> <td>T020</td> <td>不存在需要签约的协议</td> <td>协议未配置或者已经签署完成,联系客户人员核实协议是否存在</td> </tr> <tr> <td>T021</td> <td>用户不存在</td> <td>签约或者下发前,先调用增加下发收款者,添加用户成功后,再调用其他接口</td> </tr> <tr> <td>T022</td> <td>下发公司月累计交易超限额</td> <td>下发公司月累计交易超限额</td> </tr> <tr> <td>T023</td> <td>下发公司季度累计交易超限额</td> <td>下发公司季度累计交易超限额</td> </tr> <tr> <td>T024</td> <td>请求流水号重复</td> <td>请检查是否上送已经存在的流水号</td> </tr> <tr> <td>T025</td> <td>下发可用额度计算方式未设置</td> <td>联系客户人员设置计算方式</td> </tr> <tr> <td>T026</td> <td>参数解码异常</td> <td>参数未按照约定方式进行加密</td> </tr> <tr> <td>T027</td> <td>订单已落地或订单不存在</td> <td>同步预授权下发结果时,订单已落地或订单不存在</td> </tr> <tr> <td>T028</td> <td>下发公司限额未配置</td> <td>联系客户人员配置</td> </tr> <tr> <td>T029</td> <td>身份证格式错误或年龄不符合服务公司限制</td> <td>身份证不符合18位校验或者年龄不符合打款要求</td> </tr> <tr> <td>T030</td> <td>黑名单用户</td> <td>黑名单用户</td> </tr> <tr> <td>T031</td> <td>充值类型错误</td> <td>充值类型传参错误</td> </tr> <tr> <td>T032</td> <td>服务费类型错误</td> <td>服务费类型传参错误</td> </tr> <tr> <td>T033</td> <td>服务费率错误</td> <td>服务费率传值错误或传值为空</td> </tr> <tr> <td>T034</td> <td>充值金额计算错误</td> <td>充值金额计算不符合公式</td> </tr> <tr> <td>T035</td> <td>充值到账金额计算错误</td> <td>充值到账金额计算不符合公式</td> </tr> <tr> <td>T036</td> <td>充值账户未配置</td> <td>确认商户ID,下发公司ID,支付类型传参是否正确</td> </tr> <tr> <td>T037</td> <td>充值信息错误</td> <td>收款商户名称或者收款账号或者收款银行支行名称传递错误</td> </tr> <tr> <td>T038</td> <td>服务费率未配置</td> <td>确认商户ID,下发公司ID,支付类型传参是否正确</td> </tr> <tr> <td>T039</td> <td>服务费费率档位未配置</td> <td>确认商户ID,下发公司ID,支付类型传参是否正确</td> </tr> <tr> <td>T040</td> <td>下发金额不能小于最小下发金额</td> <td>下发金额不能小于最小下发金额</td> </tr> <tr> <td>T041</td> <td>服务公司该收款账户充值限制,请联系客户经理!</td> <td>服务公司该收款账户充值限制,请联系客户经理!</td> </tr> <tr> <td>T042</td> <td>服务公司充值限制,请联系客户经理!</td> <td>服务公司充值限制,请联系客户经理!</td> </tr> <tr> <td>T043</td> <td>图片未上传</td> <td>确认图片是否为必传字段</td> </tr> <tr> <td>T044</td> <td>商户开票信息不存在</td> <td>确认开票信息id传递是否正确</td> </tr> <tr> <td>T045</td> <td>商户开票信息未审核</td> <td>确认商户开票信息是否审核通过</td> </tr> <tr> <td>T046</td> <td>收件人信息不存在</td> <td>确认开票信息id传递是否正确</td> </tr> <tr> <td>T047</td> <td>开票申请已完成,没有可开票金额</td> <td>确认这笔充值订单是否有可开票金额</td> </tr> <tr> <td>T048</td> <td>开票申请进行中,无法继续开票</td> <td>开票申请进行中,无法继续开票</td> </tr> <tr> <td>T049</td> <td>部分开票,开票类目请保持一致</td> <td>单笔充值分开开票,开票类目需要保持一致</td> </tr> <tr> <td>T050</td> <td>没有可开票金额</td> <td>确认充值订单剩余可开票金额</td> </tr> <tr> <td>T051</td> <td>申请开票金额大于可开票金额</td> <td>确认充值订单剩余可开票金额</td> </tr> <tr> <td>T052</td> <td>部分开票订单·不能合并开票</td> <td>单笔充值分开开票,不可再和其他订单合并开票</td> </tr> <tr> <td>T053</td> <td>合并开票,开票金额必须等于可开票金额</td> <td>合并开票,开票金额必须等于可开票金额</td> </tr> <tr> <td>T054</td> <td>未查询到充值订单</td> <td>未查询到充值订单</td> </tr> <tr> <td>T055</td> <td>充值订单未成功</td> <td>充值订单未成功</td> </tr> <tr> <td>T056</td> <td>不同的服务公司不能合并开票</td> <td>不同的服务公司不能合并开票</td> </tr> <tr> <td>T057</td> <td>开票类目不存在</td> <td>开票类目不存在</td> </tr> <tr> <td>T058</td> <td>服务公司未配置</td> <td>服务公司未配置</td> </tr> <tr> <td>T059</td> <td>开票类型不存在</td> <td>开票类型不存在</td> </tr> <tr> <td>T060</td> <td>实际服务公司月度累计交易超限额</td> <td>实际服务公司月度累计交易超限额</td> </tr> <tr> <td>T061</td> <td>同一证件号并发访问请间隔5秒</td> <td>同一证件号</td> <td>同一下发公司</td> <td>同一商户下发请间隔5秒</td> </tr> <tr> <td>Q001</td> <td>账期日超出可查范围</td> <td>请检查上送账期日是否在90天内</td> </tr> <tr> <td>Q002</td> <td>账期月超出可查范围</td> <td>请检查上送账期月是否在6个月内</td> </tr> <tr> <td>Q003</td> <td>数据文件不存在</td> <td>可能查询账期日早于商户签约日,或由于系统问题未能生成对应日期的数据文件,请联系服务支持</td> </tr> <tr> <td>S001</td> <td>非法请求</td> <td>商户ID不存在或未于商户服务平台开启系统对接服务</td> </tr> <tr> <td>S002</td> <td>签名验证失败</td> <td>请检查签名生成方式是否与商户服务平台配置“系统设置”中配置的安全方式是否一致;使用融赋通ITPUtil的商户请检查秘钥证书是否正确;未使用融赋通ITPUtil的商户请检查签名代码是否与融赋通Demo逻辑一致</td> </tr> <tr> <td>S003</td> <td>参数缺少</td> <td>请参考接口规范,检查必输项是否有上送</td> </tr> <tr> <td>S004</td> <td>参数格式错误</td> <td>请参考接口规范,检查必输项长度及格式是否合法</td> </tr> <tr> <td>S005</td> <td>超限访问</td> <td>请按接口规范指引降低接口访问频率</td> </tr> <tr> <td>T062</td> <td>证件识别异常或识别结果校验不通过</td> <td>证件识别异常或识别结果校验不通过</td> </tr> </tbody> </table> <h1>2、下发处理单状态码</h1> <table> <thead> <tr> <th>状态码</th> <th>信息</th> </tr> </thead> <tbody> <tr> <td>A0</td> <td>已受理</td> </tr> <tr> <td>A1</td> <td>受理失败</td> </tr> <tr> <td>B0</td> <td>下发打款中</td> </tr> <tr> <td>C1</td> <td>下发打款成功</td> </tr> <tr> <td>C2</td> <td>下发打款失败</td> </tr> </tbody> </table>

页面列表

ITEM_HTML