代付
<h5>简要描述</h5>
<ul>
<li>普通用户 A 在商户 B 后台创建提币下发单，选择本 API 作为提币通道，商户调用本接口创建下发单，接口返回下发单数据。业务成功后，商户钱包币减少，扣除 amount 数量币，扣除手续费币；普通用户钱包增加 amount 数量币。 </li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://55ukbzi3br.fpayfreedom.com/v1/withdrawal/add</code> </li>
</ul>
<h5>请求方式</h5>
<ul>
<li>post</li>
</ul>
<h5>请求Body参数</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;">merchantid</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>商户ID，由FPAY统一支付分配。</td>
</tr>
<tr>
<td style="text-align: left;">orderid</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>商户系统订单号，该订单号将作为FPAY 的返回数据。该值需在商户系统内唯一。</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td>number</td>
<td>币数量 为了保证签名验证，请使用字符串接收后再转换为number类型</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>接收钱包地址</td>
</tr>
<tr>
<td style="text-align: left;">notify_url</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>异步通知的地址</td>
</tr>
<tr>
<td style="text-align: left;">reverse_url</td>
<td style="text-align: left;">否</td>
<td>string</td>
<td>反查api的地址，商户需要反查验证时传入，默认为空，为空时不参与签名</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">否</td>
<td>string</td>
<td>商户备注，回调时原样返回 ,如果为空不参与签名</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td>string</td>
<td>32位大写MD5签名值 ,详见签名规则</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<pre><code>{
"code":"0000",
"msg":"success",
"data":{
"id":"9C48E0A5-BAAD-C3DA-A90B-22CA0DA125DD",//平台订单号
"orderid":"20220720235026732209",//商户号号
"merchantid":"2022060100434708888",//商户号
"address":"Fabscs5sd5f4gf4g5",//收款方钱包地址
"amount":"200.000",//币数量
"charge":"0.400",//手续费
"remark":"test",//商户备注，回调时原样返回
"state":"0",// 0 为订单创建成功，2和3为入账成功
"notify_url":"https://test.com/notify",//异步回调地址
"reverse_url":"https://test.com/notify",//反查api地址，可空
"addtime":"1658332237",//订单创建时间
"sign":""// 签名
}
}
</code></pre>
<h5>成功返回示例的参数说明</h5>
<table>
<thead>
<tr>
<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;">string</td>
<td>订单结果，“0000”成功，其他失败</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td>返回失败时错误信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>成功时返回的数据，参考返回示例</td>
</tr>
</tbody>
</table>
<h5>失败返回示例</h5>
<pre><code>{
"code":"10001"
"msg":"fail"
}
</code></pre>