聚合支付接口文档

聚合支付接口文档


【统一】查询交易订单详情

<h2>【统一】查询交易订单详情</h2> <p>&gt; /api/order/findByNo</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>String</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>平台交易订单号&lt;br/&gt;(orderNo和merchantOrderNo 二选一)</td> </tr> <tr> <td>merchantOrderNo</td> <td>String</td> <td>❌</td> <td>商户交易订单号&lt;br/&gt;(orderNo和merchantOrderNo 二选一)</td> </tr> </tbody> </table> <p>&gt; 请求参数示例(参数需要加密,以下是加密前的示例)</p> <pre><code class="language-json">{ &amp;quot;sign&amp;quot;: &amp;quot;291C70CA1DC3823C79ABA4DAD95C5D98&amp;quot;, &amp;quot;timestamp&amp;quot;: &amp;quot;1735660800000&amp;quot;, &amp;quot;merchantNo&amp;quot;: 17170000000000000000, &amp;quot;orderNo&amp;quot;: &amp;quot;PY000000001&amp;quot;, &amp;quot;merchantOrderNo&amp;quot;: &amp;quot;1234567890&amp;quot; }</code></pre> <h3>返回数据结构</h3> <table> <thead> <tr> <th>参数名称</th> <th>类型</th> <th>必填</th> <th>是否加密</th> <th>中文名</th> </tr> </thead> <tbody> <tr> <td>success</td> <td>boolean</td> <td>是</td> <td>❌</td> <td>响应状态</td> </tr> <tr> <td>code</td> <td>integer</td> <td>是</td> <td>❌</td> <td>响应编码</td> </tr> <tr> <td>msg</td> <td>string</td> <td>是</td> <td>❌</td> <td>响应信息</td> </tr> <tr> <td>data</td> <td>object</td> <td>是</td> <td>❌</td> <td>响应数据</td> </tr> <tr> <td>↳ sign</td> <td>string</td> <td>是</td> <td>❌</td> <td>签名</td> </tr> <tr> <td>↳ timestamp</td> <td>string</td> <td>是</td> <td>❌</td> <td>签名时间戳(毫秒)</td> </tr> <tr> <td>↳ merchantNo</td> <td>string</td> <td>是</td> <td>❌</td> <td>商户编号</td> </tr> <tr> <td>↳ orderNo</td> <td>string</td> <td>是</td> <td>✅</td> <td>聚合平台交易订单号</td> </tr> <tr> <td>↳ merchantOrderNo</td> <td>string</td> <td>是</td> <td>✅</td> <td>商户交易订单号</td> </tr> <tr> <td>↳ amount</td> <td>string</td> <td>是</td> <td>✅</td> <td>订单金额(分)</td> </tr> <tr> <td>↳ canRefundAmount</td> <td>string</td> <td>是</td> <td>✅</td> <td>可退款金额(分)</td> </tr> <tr> <td>↳ payState</td> <td>string</td> <td>是</td> <td>✅</td> <td>订单支付状态 0:未支付;1:已支付;2:支付失败;3:支付关闭;4:支付超时</td> </tr> <tr> <td>↳ refundState</td> <td>string</td> <td>是</td> <td>✅</td> <td>订单退款状态 0:未发起退款;1:部分金额退款中;2:已退款 3:退款失败 4:有退款订单进行中</td> </tr> <tr> <td>↳ payType</td> <td>string</td> <td>是</td> <td>✅</td> <td>支付方式 wechat:微信支付;alipay:支付宝支付;unionpay:银联支付</td> </tr> <tr> <td>↳ description</td> <td>string</td> <td>是</td> <td>✅</td> <td>订单商品描述</td> </tr> <tr> <td>↳ attach</td> <td>string</td> <td>否</td> <td>✅</td> <td>附加数据</td> </tr> <tr> <td>↳ clientIp</td> <td>string</td> <td>否</td> <td>✅</td> <td>用户IP</td> </tr> <tr> <td>↳ goodsDetail</td> <td>string</td> <td>否</td> <td>✅</td> <td>商品数据(JSON字符串)</td> </tr> <tr> <td>↳ wechatInfo</td> <td>string</td> <td>否</td> <td>✅</td> <td>微信信息(JSON字符串)</td> </tr> <tr> <td>↳ alipayInfo</td> <td>string</td> <td>否</td> <td>✅</td> <td>支付宝信息(JSON字符串)</td> </tr> <tr> <td>↳ sceneInfo</td> <td>string</td> <td>否</td> <td>✅</td> <td>场景信息(JSON字符串)</td> </tr> <tr> <td>↳ terminalInfo</td> <td>string</td> <td>否</td> <td>✅</td> <td>交易终端信息</td> </tr> <tr> <td>↳ gpsInfo</td> <td>string</td> <td>否</td> <td>✅</td> <td>gps信息</td> </tr> <tr> <td>↳ bsInfo</td> <td>string</td> <td>否</td> <td>✅</td> <td>基站信息</td> </tr> <tr> <td>↳ goodsTag</td> <td>string</td> <td>否</td> <td>✅</td> <td>订单优惠标记,,代金券或立减 优惠功能</td> </tr> <tr> <td>↳ supportFapiao</td> <td>string</td> <td>否</td> <td>✅</td> <td>电子发票入口开放标识 true:是;false:否</td> </tr> <tr> <td>↳ placeTime</td> <td>string</td> <td>是</td> <td>✅</td> <td>下单时间戳(毫秒)</td> </tr> <tr> <td>↳ payTime</td> <td>string</td> <td>否</td> <td>✅</td> <td>支付时间戳(毫秒)</td> </tr> <tr> <td>↳ refundTime</td> <td>string</td> <td>否</td> <td>✅</td> <td>退款时间戳(毫秒)</td> </tr> <tr> <td>↳ failedTime</td> <td>string</td> <td>否</td> <td>✅</td> <td>订单失败、失效、关闭 时间戳(毫秒)</td> </tr> </tbody> </table> <p>&gt; 返回示例(data参数需要解密,以下是实际响应数据示例)</p> <p>状态码 <strong>200</strong></p> <pre><code class="language-json">{ &amp;quot;success&amp;quot;: true, &amp;quot;code&amp;quot;: 200, &amp;quot;msg&amp;quot;: &amp;quot;操作成功&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;sign&amp;quot;: &amp;quot;291C70CA1DC3823C79ABA4DAD95C5D98&amp;quot;, &amp;quot;timestamp&amp;quot;: 1743582863829, &amp;quot;merchantNo&amp;quot;: &amp;quot;17170000000000000000&amp;quot;, &amp;quot;orderNo&amp;quot;: &amp;quot;23VGwJ6XVceMBV+CnKzMf+le8P9F81/HcmqYAuJW8+E=&amp;quot;, &amp;quot;merchantOrderNo&amp;quot;: &amp;quot;kxOVGcmtOpcebHmqyH9lrA==&amp;quot;, &amp;quot;amount&amp;quot;: &amp;quot;EGo+epPh5aRbLA+P0/lhtw==&amp;quot;, &amp;quot;canRefundAmount&amp;quot;: &amp;quot;voF6Gc2Mr8igD9YP+YJQJg==&amp;quot;, &amp;quot;payState&amp;quot;: &amp;quot;voF6Gc2Mr8igD9YP+YJQJg==&amp;quot;, &amp;quot;refundState&amp;quot;: &amp;quot;voF6Gc2Mr8igD9YP+YJQJg==&amp;quot;, &amp;quot;payType&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;description&amp;quot;: &amp;quot;6dRbb7nr6fyCK0cT+ntolg==&amp;quot;, &amp;quot;attach&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;clientIp&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;goodsDetail&amp;quot;: &amp;quot;WiFtdcCabgjqLqurSbG4Km00bfOraE4IFzN+e+7Y1oQOwaH3XfVxcECeJcR0xtiI3rivi227qj428oTkPJI81435kl3pto+XnjHdyqo4cxD0Xt/haQNu999VvC1DIqhIAF4XzK9xVTpMH8MdhH3HYKWzMzF5P+VEMTodXy4dtiY2Xz1qvBX8GX8z1J78yi95&amp;quot;, &amp;quot;wechatInfo&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;alipayInfo&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;sceneInfo&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;terminalInfo&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;gpsInfo&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;bsInfo&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;goodsTag&amp;quot;: &amp;quot;pT263EyasRD9OiPMjPs7ZQ==&amp;quot;, &amp;quot;supportFapiao&amp;quot;: &amp;quot;5bEVylCcdXPkdTozBgyLaQ==&amp;quot;, &amp;quot;placeTime&amp;quot;: &amp;quot;HgQn32g8wwd+/yBIFdw3kw==&amp;quot;, &amp;quot;payTime&amp;quot;: &amp;quot;voF6Gc2Mr8igD9YP+YJQJg==&amp;quot;, &amp;quot;refundTime&amp;quot;: &amp;quot;voF6Gc2Mr8igD9YP+YJQJg==&amp;quot;, &amp;quot;failedTime&amp;quot;: &amp;quot;voF6Gc2Mr8igD9YP+YJQJg==&amp;quot; } }</code></pre>

页面列表

ITEM_HTML