FPay钱包USDT支付代付对接文档

FPayUSDT对接Api文档


支付通知

<h5>简要描述</h5> <ul> <li>用户支付完成后,立即向向商户提交的notify_url发送一次通知,商户收到通知需判断本地订单状态防止重复上分,处理完业务逻辑之后需返回&quot;success&quot;,如果未返回“success”,则每隔30秒发送1次通知,重复两次后停止回调。</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://www.test.com/notify_url(商户方在发起支付请求时提供)</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;">id</td> <td style="text-align: left;">9C48E0A5-BAAD-C3DA-A90B-22CA0DA12</td> <td>是</td> <td>string</td> <td>平台订单号</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.000</td> <td>是</td> <td>string</td> <td>币数量</td> </tr> <tr> <td style="text-align: left;">usdt</td> <td style="text-align: left;">U数量</td> <td>是</td> <td>string</td> <td>U数量</td> </tr> <tr> <td style="text-align: left;">state</td> <td style="text-align: left;">2</td> <td>是</td> <td>string</td> <td>支付状态 ,2和 3代表支付成功</td> </tr> <tr> <td style="text-align: left;">rate</td> <td style="text-align: left;">汇率</td> <td>是</td> <td>string</td> <td>汇率</td> </tr> <tr> <td style="text-align: left;">charge</td> <td style="text-align: left;">0.400</td> <td>是</td> <td>string</td> <td>手续费</td> </tr> <tr> <td style="text-align: left;">addtime</td> <td style="text-align: left;">时间戳 (秒)</td> <td>是</td> <td>string</td> <td>订单创建时间</td> </tr> <tr> <td style="text-align: left;">endtime</td> <td style="text-align: left;">时间戳 (秒)</td> <td>是</td> <td>string</td> <td>订单完成时间</td> </tr> <tr> <td style="text-align: left;">remark</td> <td style="text-align: left;">商户备注,原样返回</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>success </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>订单结果&quot;0000&quot;为成功,其他失败</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>

页面列表

ITEM_HTML