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/createorder</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>Amount</td> <td>是</td> <td>string</td> <td>&lt;center&gt;5&lt;/center&gt;</td> <td>100</td> <td>订单金额(单位:分)</td> </tr> <tr> <td>NotifyUrl</td> <td>是</td> <td>string</td> <td>&lt;center&gt;-&lt;/center&gt;</td> <td><a href="http://test123.com">http://test123.com</a></td> <td>异步通知地址</td> </tr> <tr> <td>Source</td> <td>否</td> <td>string</td> <td>&lt;center&gt;-&lt;/center&gt;</td> <td>购买商品</td> <td>交易来源</td> </tr> <tr> <td>ExtraInfo</td> <td>否</td> <td>string</td> <td>&lt;center&gt;-&lt;/center&gt;</td> <td>apple*2</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;); requestData.Add(&quot;Amount&quot;, &quot;100&quot;); requestData.Add(&quot;NotifyUrl&quot;, _configuration[&quot;Web:Host&quot;] + &quot;/local/localhostNotify&quot;); requestData.Add(&quot;Source&quot;, &quot;MerchantSource&quot;); requestData.Add(&quot;ExtraInfo&quot;, &quot;apple *2&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/createorder&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 | 由平台发放给商户的AppId | | MerchantDetailedID | string | 由平台发放给商户的详细信息Id | | MerchantOrderNo | string | 海外商户订单号 | | SYOrderNo | string | SY订单号 | | Amount | string | 金额 | | NotifyUrl | string | 异步通知地址 | | ExtraInfo | string | 自定义扩展字段 | | PayUrl | string | 支付Url(利用其url跳转以完成支付) | | Sign | string | 签名 | ###响应示例 ```javascript { success:true, code:200, msg:&amp;quot;Success&amp;quot;, data:{ &amp;quot;appID&amp;quot;: &amp;quot;a5d3dd2f4c95db76&amp;quot;, &amp;quot;merchantDetailedID&amp;quot;: &amp;quot;3fa85f64-5717-4562-b3fc-2c963f66afa6&amp;quot;, &amp;quot;merchantOrderNo&amp;quot;: &amp;quot;T1999123456&amp;quot;, &amp;quot;syOrderNo&amp;quot;: &amp;quot;SY20240720204739002&amp;quot;, &amp;quot;amount&amp;quot;: &amp;quot;100&amp;quot;, &amp;quot;notifyUrl&amp;quot;: &amp;quot;https://local/localhostNotiy.com&amp;quot;, &amp;quot;extraInfo&amp;quot;: &amp;quot;apple *2&amp;quot;, &amp;quot;payUrl&amp;quot;: &amp;quot;https://payapiserver/payment.com&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;3777d89f699688158436881f7d7dbe18&amp;quot; } } </code></pre>

页面列表

ITEM_HTML