SY云管家国内支付开放API

SY云管家支付开放平台接口文档


查询订单

<h3>订单查询</h3> <ul> <li><strong>接口名称</strong>:订单查询接口<br /> <strong>描述</strong>: 查询订单支付状态。<br /> <strong>请求方式</strong>: POST<br /> <strong>请求URL</strong>: <code>/api/services/app/openapi/queryoredr</code><br /> <strong>请求内容类型</strong>:<code>application/json</code> <strong>参数</strong>:</li> </ul> <table> <thead> <tr> <th>参数名</th> <th>必填</th> <th>类型</th> <th>长度</th> <th>示例</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>AppID</td> <td>是</td> <td>string</td> <td>&lt;center&gt;16&lt;/center&gt;</td> <td>a5d3dd2f4c95db76</td> <td>由平台发放给商户的AppId</td> </tr> <tr> <td>MerchantDetailedID</td> <td>是</td> <td>string</td> <td>&lt;center&gt;38&lt;/center&gt;</td> <td>3fa85f64-5717-4562-b3fc-2c963f66afa6</td> <td>由平台发放给商户的详细信息Id</td> </tr> <tr> <td>MerchantOrderNo</td> <td>是</td> <td>string</td> <td>&lt;center&gt;21&lt;/center&gt;</td> <td>T1999123456</td> <td>商户订单号</td> </tr> <tr> <td><strong>Sign</strong></td> <td><strong>是</strong></td> <td><strong>string</strong></td> <td>&lt;center&gt;-&lt;/center&gt;</td> <td><strong>3777d89f699688158436881f7d7dbe18</strong></td> <td><strong>密钥签名</strong></td> </tr> </tbody> </table> <p><strong>签名</strong>:</p> <ul> <li><strong>将参数(parameters)按字典序排序</strong>。</li> <li><strong>将排序后的参数字符串后再拼接秘钥(AppSecret),确保Key首字母是大写。</strong></li> <li><strong>使用 MD5 算法对拼接后的字符串进行哈希计算。</strong></li> <li><strong>将计算出的 MD5 哈希值转换为小写字符串形式。</strong></li> </ul> <h3>示例代码</h3> <p>以下是调用支付下单接口的基本示例:</p> <p>```c# // 1. 集合数据<br /> var requestData = new Dictionary&lt;string, object&gt;(); requestData.Add(&quot;AppID&quot;, &quot;a5d3dd2f4c95db76&quot;); requestData.Add(&quot;MerchantDetailedID&quot;, &quot;3fa85f64-5717-4562-b3fc-2c963f66afa6&quot;); requestData.Add(&quot;MerchantOrderNo&quot;, &quot;T1999123456&quot;); //签名 var sign = toSignHandle(requestData,AppSecret); requestData.Add(&quot;Sign&quot;,sign);</p> <pre><code> // 2. 发送请求 var requestUrl = &amp;quot;http://merchant.sy1999.com//api/services/app/overseasopenapi/checkorder&amp;quot;; httpClient.ContentType = &amp;quot;application/json&amp;quot;; var response = await httpClient.PostAsync(requestUrl,jsonData(requestData)); </code></pre> <p>` // 3. 获取响应<br /> var result = await response.Content.ReadAsStringAsync();<br /> Console.log(result); // { result.code,result.msg,result.data}; </p> <pre><code>###响应参数 | 参数名 | 必填 | 类型 | 长度 | 示例 | 说明 | |--|--|-----|--|--| | AppId | 是 |string|&amp;lt;center&amp;gt;16&amp;lt;/center&amp;gt;|a5d3dd2f4c95db76|由平台发放给商户的AppId| | MerchantDetailedID | 是 |string|&amp;lt;center&amp;gt;38&amp;lt;/center&amp;gt;|3fa85f64-5717-4562-b3fc-2c963f66afa6|由平台发放给商户的详细信息Id| | MerchantOrderNo | 是 |string|&amp;lt;center&amp;gt;21&amp;lt;/center&amp;gt;|T1999123456|商户订单号| | ChannelOrderNo | 是 |string|&amp;lt;center&amp;gt;38&amp;lt;/center&amp;gt;|3fa85f64-5717-4562-b3fc-2c963f66afa6|通道订单号| |SYOrderNo|是|string|&amp;lt;center&amp;gt;-&amp;lt;/center&amp;gt;|T123456789|SY订单号| | Amount | 是 |string|&amp;lt;center&amp;gt;5&amp;lt;/center&amp;gt;|100|订单金额(单位:分) | ExtraInfo | 否 |string|&amp;lt;center&amp;gt;-&amp;lt;/center&amp;gt;|apple*2|自定义扩展信息 |OrderStatus | 支付状态 |int|&amp;lt;center&amp;gt;-&amp;lt;/center&amp;gt;|1|0=未支付;1=已支付;2=已退款 |PayType | 是 |int|&amp;lt;center&amp;gt;-&amp;lt;/center&amp;gt;|1=微信 2=支付宝|支付类型| | Sign | 是 |string|&amp;lt;center&amp;gt;-&amp;lt;/center&amp;gt;|3777d89f699688158436881f7d7dbe18|密钥签名 |PayTime | 是 |DateTime|&amp;lt;center&amp;gt;-&amp;lt;/center&amp;gt;|2024-01-01 12:00:00|支付时间| ###响应示例 ```javascript { success:true, code:200, msg:&amp;quot;Success&amp;quot;, data:{ &amp;quot;appID&amp;quot;: &amp;quot;h220751g12i394b&amp;quot;, &amp;quot;MerchantDetailedID&amp;quot;: &amp;quot;3fa85f64-5717-4562-b3fc-2c963f66afa6&amp;quot;, &amp;quot;MerchantOrderNo&amp;quot;: &amp;quot;T123456789&amp;quot;, &amp;quot;ChannelOrderNo&amp;quot;: &amp;quot;3fa85f64-5717-4562-b3fc-2c963f66afa6&amp;quot;, &amp;quot;SYOrderNo&amp;quot;:&amp;quot;T123456789&amp;quot;, &amp;quot;amount&amp;quot;: &amp;quot;99&amp;quot;, &amp;quot;extraInfo&amp;quot;: &amp;quot;Extra Info&amp;quot;, &amp;quot;orderStatus&amp;quot;: 1, &amp;quot;PayType&amp;quot;:1, &amp;quot;sign&amp;quot;: &amp;quot;3777d89f699688158436881f7d7dbe18&amp;quot;, &amp;quot;payTime&amp;quot;: &amp;quot;2024-01-01 12:00:00&amp;quot; } } </code></pre>

页面列表

ITEM_HTML