SY云管家国内支付开放API

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


异步通知

<h3>异步通知</h3> <h3>统一异步通知参数</h3> <table> <thead> <tr> <th>参数名称</th> <th>参数类型</th> <th>参数说明</th> </tr> </thead> <tbody> <tr> <td>AppID</td> <td>string</td> <td>商户AppID</td> </tr> <tr> <td>MerchantDetailedId</td> <td>string</td> <td>商户详细信息Id</td> </tr> <tr> <td>MerchantOrderNo</td> <td>string</td> <td>商户订单号</td> </tr> <tr> <td>ChannelOrderNo</td> <td>string</td> <td>通道订单号</td> </tr> <tr> <td>SYOrderNo</td> <td>string</td> <td>SY订单号</td> </tr> <tr> <td>Amount</td> <td>string</td> <td>金额(分)</td> </tr> <tr> <td>ExtraInfo</td> <td>string</td> <td>自定义扩展字段</td> </tr> <tr> <td>OrderStatus</td> <td>int</td> <td>订单状态(0:未支付,1:已支付 2:已退款)</td> </tr> <tr> <td>PayType</td> <td>int</td> <td>支付类型(0:默认)</td> </tr> <tr> <td>Sign</td> <td>string</td> <td>签名</td> </tr> <tr> <td>PayTime</td> <td>DateTime?</td> <td>支付时间</td> </tr> </tbody> </table> <h3>异步通知示例</h3> <pre><code class="language-json">{ &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;ChannelOrderNo&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;SYOrderNo&amp;quot;: &amp;quot;SY20240720204739002&amp;quot;, &amp;quot;Amount&amp;quot;: &amp;quot;100&amp;quot;, &amp;quot;ExtraInfo&amp;quot;: &amp;quot;apple *2&amp;quot;, &amp;quot;OrderStatus&amp;quot;: 1, &amp;quot;PayType&amp;quot;: 0, &amp;quot;Sign&amp;quot;: &amp;quot;3777d89f699688158436881f7d7dbe18&amp;quot;, &amp;quot;PayTime&amp;quot;: &amp;quot;0001-01-01 00:00:00&amp;quot; }</code></pre> <h3>异步通知响应</h3> <p>当商户系统收到异步通知后,需要以JSON格式返回响应,格式如下:</p> <pre><code class="language-json">{ errcode:0, errmsg:&amp;quot;success&amp;quot;, data:null } </code></pre> <ul> <li> <p><strong>当JSON格式数据值为此时,表示响应成功。如果出现错误,可以在 msg 字段中返回相应的错误信息。</strong></p> </li> <li><strong>若响应未包含 &quot;errmsg&quot;: &quot;success&quot; ,平台会每隔 5分钟 重发 1次,共3次 通知,直至收到 &quot;errmsg&quot;: &quot;success&quot; 。商户需及时处理并返回正确JSON,确保通知顺利接收,若 3次 重发后仍未成功,可主动联系平台确认。</strong></li> </ul> <h3>异步通知状态码</h3> <table> <thead> <tr> <th>状态码</th> <th>状态</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>-1</td> <td>Other</td> <td>其他</td> </tr> <tr> <td>0</td> <td>Success</td> <td>成功</td> </tr> <tr> <td>1</td> <td>Failure</td> <td>失败</td> </tr> <tr> <td>2</td> <td>Transaction Amount Invalid</td> <td>交易金额有误</td> </tr> <tr> <td>3</td> <td>Channel information error</td> <td>通道信息异常</td> </tr> </tbody> </table>

页面列表

ITEM_HTML