2.1 代理商商户进件接口

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>这里表示代理商进行子商户进件的接口，请将需要进件的商户信息按照接口规则上送。同时更新也是这个接口（只能修改审核驳回的），更新时候请上送原订单号，更改其他字段信息即可；</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://pay.test.891tech.com/website/agent/isv/reportItf.action</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST 【application/json】</li> </ul> <h5>参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> <th>长度(字符个数)</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">bizType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>请求的接口</td> <td>10</td> </tr> <tr> <td style="text-align: left;">agentNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>代理商编号</td> <td>50</td> </tr> <tr> <td style="text-align: left;">orderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单号，请保持贵司业务系统唯一</td> <td>100</td> </tr> <tr> <td style="text-align: left;">signName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户全称</td> <td>200</td> </tr> <tr> <td style="text-align: left;">showName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户简称</td> <td>50</td> </tr> <tr> <td style="text-align: left;">merchantType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>子商户类型，请查看枚举字段说明</td> <td>30</td> </tr> <tr> <td style="text-align: left;">businessMode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>子商户类型：PUTONG(默认普通商户)，而连锁商户需要调用另外接口进行进件，请查看枚举字段说明</td> <td>30</td> </tr> <tr> <td style="text-align: left;">webSite</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>网址，可以填入服务商网址或者商户网址，<a href="http://xxx.com">http://xxx.com</a></td> <td>50</td> </tr> <tr> <td style="text-align: left;">legalPerson</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>法人名称</td> <td>200</td> </tr> <tr> <td style="text-align: left;">legalPersonId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>法人证件号</td> <td>50</td> </tr> <tr> <td style="text-align: left;">legalPersonAddress</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>法人证件地址</td> <td>255</td> </tr> <tr> <td style="text-align: left;">bindMobile</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>绑定手机，优先法人手机号</td> <td>11</td> </tr> <tr> <td style="text-align: left;">idType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>证件类型，请查看枚举字段说明</td> <td>30</td> </tr> <tr> <td style="text-align: left;">idCardStartDate</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>法人身份证开始日期 (yyyy-MM-dd)</td> <td>15</td> </tr> <tr> <td style="text-align: left;">idCardEndDate</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>法人身份证结束日期(yyyy-MM-dd)，长期有效请填入：2999-12-31</td> <td>15</td> </tr> <tr> <td style="text-align: left;">businessLicense</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>营业执照，当为个人商户时候请填入证件号</td> <td>50</td> </tr> <tr> <td style="text-align: left;">businessDateStart</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>经营起始日期开始日期(yyyy-MM-dd)，非个人商户时候必填！</td> <td>50</td> </tr> <tr> <td style="text-align: left;">businessDateLimit</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>经营期限结束日期(yyyy-MM-dd)，长期有效填入:2999-12-31，非个人商户时候必填！</td> <td>50</td> </tr> <tr> <td style="text-align: left;">merchantCategory</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>经营类别，请选择合适的经营类别，查看枚举字段说明</td> <td>50</td> </tr> <tr> <td style="text-align: left;">industryTypeCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>行业类型编码，请选择合适的行业类型编码，如不上送，系统将默认根据商户类型以及经营类别搭配随机上送</td> <td>50</td> </tr> <tr> <td style="text-align: left;">province</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>省份，有区代码时候可以不上送该字段</td> <td>50</td> </tr> <tr> <td style="text-align: left;">city</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>城市，有区代码时候可以不上送该字段</td> <td>50</td> </tr> <tr> <td style="text-align: left;">regionCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>区代码，请选择合适的区代码，如果上送错误，系统记录的商户地址就会错误，我司会提供地区码（威富通标准）；比如广东省，如果使用全国标准地区码，此时为440000，接口此时应该上送：R440000，如果使用我司地区码此时传递是：190000。默认不以字母R开头为我司地区码</td> <td>50</td> </tr> <tr> <td style="text-align: left;">address</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户通讯地址详细门牌地址</td> <td>50</td> </tr> <tr> <td style="text-align: left;">postalAddress</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>商户注册地址，不同于通讯地址</td> <td>50</td> </tr> <tr> <td style="text-align: left;">linkmanType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>联系人类型，【LEGAL：法人】【SUPER：经办人】</td> <td>50</td> </tr> <tr> <td style="text-align: left;">linkman</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>联系人，用于微信认证</td> <td>50</td> </tr> <tr> <td style="text-align: left;">linkPhone</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>联系电话，用于微信认证</td> <td>50</td> </tr> <tr> <td style="text-align: left;">email</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>联系邮箱，务必上传唯一邮箱</td> <td>50</td> </tr> <tr> <td style="text-align: left;">linkManId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>联系人身份证信息，开通微信交易时候必须上送，建议全部上送</td> <td>50</td> </tr> <tr> <td style="text-align: left;">linkmanIdCardStartDate</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>联系人证件有效期开始时间，格式2022-02-02</td> <td>50</td> </tr> <tr> <td style="text-align: left;">linkmanIdCardEndDate</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>联系人证件有效期结束时间，格式2022-01-01</td> <td>50</td> </tr> <tr> <td style="text-align: left;">bankSymbol</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>结算卡联行号，对公账户必传</td> <td>50</td> </tr> <tr> <td style="text-align: left;">accountName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>结算卡开户名</td> <td>50</td> </tr> <tr> <td style="text-align: left;">accountNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>结算卡开户账号</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settleBankType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>结算卡类型，TOPUBLIC：对公，TOPRIVATE：对私</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settlementPeriod</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>结算周期，T1、D1，目前只支持T1</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settlementType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>结算方式，AUTO：自动结算（我司系统自动发起），SELF：自主结算（需要自己发起）</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settleMode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>结算模式，MERCHANT：商户结算（当前类型交易单独结算，优先选择该方式），MERGE：合并结算（平台多个交易类型合并一种结算出去）</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settlementIdCardStartDate</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>结算人身份证开始日期(yyyy-MM-dd)</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settlementIdCardEndDate</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>结算人身份证结束日期(yyyy-MM-dd)，长期有效填入:2999-12-31</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settlementIdCardNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>结算人证件号</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settlementPhoneNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>结算人手机号</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settleChangeType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>结算到账类型，目前是：NORMAL：银行卡到账</td> <td>50</td> </tr> <tr> <td style="text-align: left;">settlementRemark</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>结算备注</td> <td>50</td> </tr> <tr> <td style="text-align: left;">microBizType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>小微经营类型，个人商户时候必填 ，请查看字段说明</td> <td>50</td> </tr> <tr> <td style="text-align: left;">certType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>证书类型 ，事业单位必填！请查看字段说明</td> <td>50</td> </tr> <tr> <td style="text-align: left;">serviceCodes</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>支付宝商户服务类型</td> <td>50</td> </tr> <tr> <td style="text-align: left;">needAuthorize</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>是否需要认证授权，默认上送：true，表示需要授权，微信必须实名认证，需要商户配合。</td> <td>50</td> </tr> <tr> <td style="text-align: left;">agreeProtocol</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>是否同意协议，默认选择: true，表示同意。</td> <td>50</td> </tr> <tr> <td style="text-align: left;">needPosFunction</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>是否需要开通POS，目前默认是：false</td> <td>50</td> </tr> <tr> <td style="text-align: left;">longitude</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>地理位置-经度</td> <td>50</td> </tr> <tr> <td style="text-align: left;">latitude</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>地理位置-纬度</td> <td>50</td> </tr> <tr> <td style="text-align: left;">orderIP</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>请求IP，请上送交易的IP地址</td> <td>50</td> </tr> <tr> <td style="text-align: left;">callbackUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>回调地址，如有回调地址，进件审核后将自动向该地址回传数据</td> <td>50</td> </tr> <tr> <td style="text-align: left;">unionPayQrCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>银联二维码，需要绑定银联二维码的时候请上送，必须唯一</td> <td>50</td> </tr> <tr> <td style="text-align: left;">openLogin</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>当前商户是否需要登录我司系统，如果需要那么将会下发登录信息给当前商户，表示该商户可以登录我司【商户后台或者小程序】查看交易交易记录，如果需要请传递：true,不需要请传递：false;缺省不传默认不支持登录我司系统！</td> <td>10</td> </tr> </tbody> </table> <h5>同步返回示例</h5> <pre><code>{ &amp;quot;bizType&amp;quot;: &amp;quot;reportItf&amp;quot;, &amp;quot;data&amp;quot;: &amp;quot;ofPXbjkrxkBdFnpGOAqiqaMCzGNrrAiQ9LXPiE/ZHPC+YuVtXUkydwfyN+Iivbn8kBEBVCezz5naujXwMZMXgSTeWigyYpN4832GzirFdSk/XIzQ7h5lglyqW7RsC6f6E2AEYk59oLcfQKP+t78fwAdRHIbMAtPhzftjapCJS2b4aGRILPyBaIdwL4OPos/1jpxRLhiOWaPy1+8xIT8Dk9al8ggi2yWaSEUITxjKucTW9iSeVatz5pmpIzAZZqh8cpkbZBVCYCkBxOLNZvT8js/f2pd0ZUwxPjU8TvqeESMj+eIIZf3G84mFxEZRFkR3TxvStiPpCA9aO2Fhoo03CxzqgTh6+mir6aQWZm+JwV+iUy1kaGBxJ8B2w79/TytUcGCAYHrKSuIkZiYzEFBLn0nfdr7magJwKRzkRALnjj1IYZD6nbGM9sWLYodBT2K3ghYXx7DF643OWE5gqrs/mH5oXiUu7f6Tiuie2gBIep9anJzacgBX7C4RhzyOYf8W0Hdu5w6UEudYELyZrQW1KtwT9qjzNiiI+SzUcUhMhDtMQcd66GUfL6cGDienmPQuKJcWwMCuR84fBKICfdxbb6fiAmetsCE/MRvU094b71IWy3ZDkRMVbDcDq3FCApZXW7vynKQV2lsduHgmyDEP+lcYdpOnH3zlhfqzwwV6k2LWnFzu8sgoET/bGyplhBnDLuJxkqQPMgt6RSYN9VUhWe76ArM7DB1t0s3i+lf4g5YPUyQx9cPHxVjK6dwk6JPqBiZy0Y/4bJgOIzqa728IyahZAJ9+PzXx/WbEo5rvo4ZVPlGr3n7BwkGCe0/dUMwetF8Bqu12yx09W20GOi+aMlQGcWgtoGd+rvGqe4eCkltS1YJ6tKrNcaI367qAvW1ld1uHkyRyRhEfe7V/Y31W3PfF7nqXvACPvWB9xxgeOK0c5E5q+3thlQTZKxCA1rJLnNhi4XZLulOaKt1FGVgxeP/8NkmQ65qD5re7fcFnXriLz1TNqjlO7p8EF7wYy/+rUKPIw+ZLZwxtyADOGEUTGpw3xMJgrRbofuPOVfo31ebrouaUg1zicW7WDUdl6A9mjaiLqjKw5jc3MOyZOMhSAB8kvw7nI1vJsoB+jmbQlIF6noLdiK86dDe/Yzh/2CMi/KfynmX/zOR/dEX1duY4GPQU4CaQZAHsW0oHqopk7Cj9402vfsu4O7ILFoKWvdJI5hxjfpPqhA4dD7ABmNEthsqwRtHLGaBkvidB1Gx8XuDlA2/TFyKsbypNZqIUNe62D1nYpBkXRXrY+aPPOICfr9rh5EAHUiTo+SZ32Tt3BVokHJIOnaE6r9ZR8dM8yrjVnSHMIND66fFDqnLR3jNET2iJgvf1fenaXo5XEAc1xQv5nU3Kh+pXq6j1B+4vSzFldBvD7CPJ63cKKV8CwDcIhw5NHdoBHToalOkV0hWCK+QZrA+oMhmSM2LFSLagFpJu7RHdIztz9slMWKjMUmShPdf+B3QxopGVZgR4uGKo5xNICNBj3AhKv/722XRVCxM58LMaXB+p1MVxUE5c62gxlBfqMfIYLCSICZHp4ksO1OU1fnD0af/rK8Ok8+NJAjluyHnupTXTWozojk1fQPtOcBxmWsK2la4ffOAa1cWr86gktofxpvSJlseHn8lDnlM7aMRV62A1u2T7s8XdcSFPZDbudgsx+eli+JzdgsWvE9f7s8XdcSFPZFxCm0jcvRkA98Xuepe8AI+9YH3HGB44rUgI0GPcCEq/prOqy30iv2ZhP36I2EDZfaJSdbdsqqHdty60O1eEqkefJ75FbIYCDNTrDbF7u3wWh+jt3X6iqSEisSfSuNZ49KeV4plS6jc1wG9YlbeVQsTyom0AHJNE+1b649FkZJeNvwuWeO4LJNLCjdbinGsWKtjkIOTttQ/xw7Te4baRT/12QmFcCx++yXJ42vY7B/TZvNgKRSjR6IuMDYokL8UrY5DT68XoBzN0gnqVmjU+UtP3ER7cHVWgTch8UNJ5KjV5tc9BK/ZmESpyyTyIRF7bp9TsEfEtfN4uQ2j+ZIePDGeYHFwLnzpOs9v36Q+wEOf9rUleaccTF8U2r2DK47ScfA==&amp;quot;, &amp;quot;agentNo&amp;quot;: &amp;quot;AG00000000000012&amp;quot;, &amp;quot;signature&amp;quot;: &amp;quot;TFV3GrnNtLQZ+KlhE+pg1XSh43AQx8Ljnh2cGk/Cwjgf9b1eqSEhcNGlcLA4rX9MxLgurXBgWHNKKk2YLC+/k3+BSDw0AxYnqp95zzw+dhhVA95z7jZmNA76eBTiqslAcoxd5kP68EGs7ZZHxgbUobLyCYAJSZX4cqympUCNBBJ9dDUmdxlx3dEZQ+TzDp9Uqpni+G3B57GrWyrfxWcEwJbDJsqHWTda45zE3c5+KonEiPn44nOs/69EU4g2zQAnCuMy0eJiCeqp05DzTvgovmsVp9ZiygkgeRdErdayLU2lBdYC+xqSgffvSkriHIXOErDBL86En9tuoJQloG8bTQ==&amp;quot; }</code></pre> <h5>同步返回解密</h5> <pre><code>{ &amp;quot;auditDate&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;auditMsg&amp;quot;:&amp;quot;正在审核中&amp;quot;,&amp;quot;merchantEntryStatus&amp;quot;:&amp;quot;INIT&amp;quot;,&amp;quot;merchantNo&amp;quot;:&amp;quot;M00000000000175&amp;quot; }</code></pre> <h5>同步返回参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> <th>是否必返</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">auditDate</td> <td style="text-align: left;">string</td> <td>审核时间</td> <td>否</td> </tr> <tr> <td style="text-align: left;">auditMsg</td> <td style="text-align: left;">string</td> <td>审核消息</td> <td>否</td> </tr> <tr> <td style="text-align: left;">merchantEntryStatus</td> <td style="text-align: left;">string</td> <td>商户的审核状态，请查看后面说明，请以查询到的状态为准</td> <td>是</td> </tr> <tr> <td style="text-align: left;">merchantNo</td> <td style="text-align: left;">string</td> <td>商户编号</td> <td>是</td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li> <p>返回域非必返字段，在系统校验不符合的时候，是不会有返回字段信息的，请注意；</p> </li> <li> <p>字段说明：【merchantEntryStatus】 INIT：审核中 SUCCESS：成功 FAIL：失败</p> </li> <li> <p>结算模式： 1.商户结算：交易单独结算； 2.合并结算：所有交易，同一个商户不同交易，将合并一条结算；</p> </li> <li>结算方式： 1.自动结算：系统自动发起结算，会在第二天结算日时候发起； 2.自主结算：商户自主提现，非自动发起结算；</li> </ul>