支付
<h5>简要描述</h5>
<ul>
<li>创建支付订单</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://55ukbzi3br.fpayfreedom.com/v1/usdtpayment/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>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">merchantid</td>
<td style="text-align: left;">202207208888</td>
<td>是</td>
<td>string</td>
<td>商户ID,由FPay统一支付分配。</td>
</tr>
<tr>
<td style="text-align: left;">orderid</td>
<td style="text-align: left;">20220720123456</td>
<td>是</td>
<td>string</td>
<td>商户系统订单号,该订单号将作为FPay 的返回数据。该值需在商户系统内唯一。</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">100.00</td>
<td>是</td>
<td>number</td>
<td>U数量 为了保证签名验证,请使用字符串接收后再转换为number类型</td>
</tr>
<tr>
<td style="text-align: left;">rate</td>
<td style="text-align: left;">汇率(U兑法币)</td>
<td>是</td>
<td>string</td>
<td>不传或者传入0,则使用FPAY的汇率</td>
</tr>
<tr>
<td style="text-align: left;">notify_url</td>
<td style="text-align: left;"><a href="http://test.com/notifyurl">http://test.com/notifyurl</a></td>
<td>是</td>
<td>string</td>
<td>异步通知的地址</td>
</tr>
<tr>
<td style="text-align: left;">return_url</td>
<td style="text-align: left;"><a href="http://test.com">http://test.com</a></td>
<td>否</td>
<td>string</td>
<td>支付成功后同步跳转地址,如果为空不参与签名</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">remark</td>
<td>否</td>
<td>string</td>
<td>商户备注,回调时原样返回 ,如果为空不参与签名</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">详见签名规则</td>
<td>是</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":"Trxxxxxxxxxxxxxxxx",//收U地址
"usdt":"10.000",//U数量
"rate":"7.200",//汇率
"amount":"72.000",//币数量
"charge":"0.400",//手续费
"remark":"test",//商户备注,回调时原样返回
"state":"0",// 0 为订单创建成功
"payurl":"https://localhost/order?id=9C48E0A5-BAAD-C3DA-A90B-22CA0DA125DD",//平台提供的支付页面,商户可直接导航用户浏览器打开该地址。
"notify_url":"https://test.com/notify",//异步回调地址
"return_url":"https://test.com/",//支付成功后,同步跳转地址
"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>
<h5>备注</h5>
<p>返回json格式</p>