通企付-账户

通企付账户版接口文档


提现

<p><strong>请求URL:</strong></p> <ul> <li><code>/pay/withdrawApply</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST</li> </ul> <p><strong>请求类型:</strong></p> <ul> <li>application /json</li> </ul> <p><strong>参数:</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">mchNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>商户号</td> </tr> <tr> <td style="text-align: left;">appId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(24)</td> <td>应用ID</td> </tr> <tr> <td style="text-align: left;">reqTime</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(13)</td> <td>请求时间,13位时间戳</td> </tr> <tr> <td style="text-align: left;">version</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(3)</td> <td>接口版本,固定:1.0</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td>签名</td> </tr> <tr> <td style="text-align: left;">signType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td>签名类型,MD5/RSA/SM2</td> </tr> <tr> <td style="text-align: left;">mchOrderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>商户订单号</td> </tr> <tr> <td style="text-align: left;">bizUserId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(64)</td> <td>收款方:&lt;br&gt;支持个人会员、企业会员、平台。&lt;br&gt;若平台,上送固定值:#yunBizUserId_B2C#</td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>提现金额,单位分</td> </tr> <tr> <td style="text-align: left;">fee</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>手续费,内扣,默认0。单位:分。&lt;br&gt;如amount为100,fee为2,实际到账金额为 98,平台手续费收入为2。</td> </tr> <tr> <td style="text-align: left;">bankCardNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(50</td> <td>绑定的银行卡号/账号 AES加密,密钥见Demo</td> </tr> <tr> <td style="text-align: left;">bankCardPro</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>银行卡/账户属性 &lt;br&gt;0:个人银行卡 &lt;br&gt;1:企业对公账户 &lt;br&gt;如果不传默认为0 &lt;br&gt;平台提现,必填1</td> </tr> <tr> <td style="text-align: left;">withdrawType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(10)</td> <td>提现方式D0:&lt;br&gt;D+0到账 &lt;br&gt;D1:D+1到账 &lt;br&gt;T1customized:T+1到账,仅工作日代付 &lt;br&gt;D0customized:D+0到账,根据平台资金头寸付款 &lt;br&gt;默认为D0</td> </tr> <tr> <td style="text-align: left;">notifyUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(128)</td> <td>支付结果异步回调URL,只有传了该值才会发起回调</td> </tr> <tr> <td style="text-align: left;">summary</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(50)</td> <td>摘要,不可包含换行符+,空格,/,?,%, #,&amp;,=等特殊字符,最多50个字符</td> </tr> <tr> <td style="text-align: left;">expiredTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(256)</td> <td>失效时间</td> </tr> <tr> <td style="text-align: left;">extParam</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(50)</td> <td>商户扩展参数,回调时会原样返回,不可包含 换行符+,空格, /,?,%,#,&amp;,=等特殊字符,最多50个字符</td> </tr> </tbody> </table> <p><strong>返回参数</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>返回状态:0-处理成功,其他-处理有误,具体错误详见msg字段</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(128)</td> <td>返回信息:具体错误原因,例如:签名失败、参数格式校验错误</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(32)</td> <td>签名信息:对data内数据签名,如data为空则不返回</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">否</td> <td style="text-align: left;">Json</td> <td>返回数据:json格式数据</td> </tr> </tbody> </table> <p><strong>data数据格式</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">withdrawOrderId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>支付订单号</td> </tr> <tr> <td style="text-align: left;">mchOrderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(30)</td> <td>商户订单号</td> </tr> <tr> <td style="text-align: left;">orderState</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>订单状态&lt;br&gt; 0-订单生成&lt;br&gt; 1-提现中&lt;br&gt; 2-提现成功&lt;br&gt; 3-提现失败&lt;br&gt; 6-订单关闭</td> </tr> <tr> <td style="text-align: left;">errCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>渠道错误码</td> </tr> <tr> <td style="text-align: left;">errMsg</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>渠道错误描述</td> </tr> </tbody> </table>

页面列表

ITEM_HTML