【统一】交易订单回调
<h2>【统一】交易订单回调</h2>
<p>> 1. 回调地址:下单接口、收款码支付接口 时传入的 notifyUrl 字段值
>
> 2. 下单未传入 notify 时,则不发送回调
>
> 3. 接收回调后 响应 “OK” 大写字符串,则不再发送回调
>
> 4. 若响应 非“OK” ,则会每隔 5分钟 发送一次回调,最多发送五次</p>
<h3>主体请求参数</h3>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>类型</th>
<th>必填</th>
<th>中文名</th>
</tr>
</thead>
<tbody>
<tr>
<td>sign</td>
<td>String</td>
<td>✅</td>
<td>签名</td>
</tr>
<tr>
<td>timestamp</td>
<td>long</td>
<td>✅</td>
<td>签名时间戳(毫秒)</td>
</tr>
<tr>
<td>merchantNo</td>
<td>String</td>
<td>✅</td>
<td>商户编号</td>
</tr>
<tr>
<td>orderNo</td>
<td>String</td>
<td>✅</td>
<td>平台交易订单号</td>
</tr>
<tr>
<td>merchantOrderNo</td>
<td>String</td>
<td>✅</td>
<td>商户交易订单号</td>
</tr>
<tr>
<td>amount</td>
<td>String</td>
<td>✅</td>
<td>支付金额(分)</td>
</tr>
<tr>
<td>payState</td>
<td>String</td>
<td>✅</td>
<td>订单支付状态 0:未支付;1:已支付;2:支付失败;3:支付关闭;4:支付超时</td>
</tr>
<tr>
<td>placeTime</td>
<td>String</td>
<td>✅</td>
<td>下单时间(时间戳毫秒)</td>
</tr>
<tr>
<td>payTime</td>
<td>String</td>
<td>✅</td>
<td>支付时间(时间戳毫秒)</td>
</tr>
<tr>
<td>failedTime</td>
<td>String</td>
<td>✅</td>
<td>失败时间(时间戳毫秒)</td>
</tr>
<tr>
<td>attach</td>
<td>String</td>
<td>✅</td>
<td>附加数据,支付成功原样返回</td>
</tr>
<tr>
<td>description</td>
<td>String</td>
<td>✅</td>
<td>订单商品描述</td>
</tr>
<tr>
<td>clientIp</td>
<td>String</td>
<td>✅</td>
<td>用户IP地址</td>
</tr>
</tbody>
</table>
<p>> 请求参数示例(参数需要解密,以下是解密后的示例)</p>
<pre><code class="language-json">{
&quot;sign&quot;: &quot;B178AA585E85F99EFD66451ECEC06513&quot;,
&quot;timestamp&quot;: 1744855542737,
&quot;merchantNo&quot;: &quot;1717000000000000000&quot;,
&quot;orderNo&quot;: &quot;PY9876434376109348&quot;,
&quot;merchantOrderNo&quot;: &quot;NO1234567890&quot;,
&quot;amount&quot;: &quot;1&quot;,
&quot;payState&quot;: &quot;0&quot;,
&quot;placeTime&quot;: &quot;1743661693392&quot;,
&quot;payTime&quot;: &quot;0&quot;,
&quot;failedTime&quot;: &quot;0&quot;,
&quot;attach&quot;: &quot;附加信息&quot;,
&quot;description&quot;: &quot;商品A&quot;,
&quot;clientIp&quot;: &quot;127.0.0.1&quot;
}</code></pre>
<h3>响应数据</h3>
<p>> OK
>
> 回调响应数据只需要 【OK】大写字符串即可
>
> 返回其他结果,均会 5分钟 后再次发送回调,最多发送 5 次回调</p>
<p>> 返回示例</p>
<pre><code>OK</code></pre>