缴费系统API文档

何文月缴费系统API文档


异步通知接口

<h1>异步通知接口</h1> <h2>接口说明</h2> <ul> <li><strong>请求地址</strong>: 商户提供的回调地址,由商户提供并通知平台商务。</li> <li><strong>请求方式</strong>: <code>GET</code></li> <li><strong>接口说明</strong>: <ul> <li>回调接口用于通知商户订单的充值状态。</li> <li>如果回调参数中的 <code>state</code> 字段出现文档中未列明的值,请立即联系平台商务,切勿自行处理。</li> </ul></li> </ul> <hr /> <h2>请求参数</h2> <table> <thead> <tr> <th>参数名</th> <th>是否必填</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>userid</td> <td>是</td> <td>string</td> <td>商户编号(由平台提供)</td> </tr> <tr> <td>order_id</td> <td>是</td> <td>string</td> <td>平台方订单号</td> </tr> <tr> <td>account</td> <td>是</td> <td>string</td> <td>充值账号(电费填写手机号)</td> </tr> <tr> <td>amount</td> <td>是</td> <td>string</td> <td>充值金额,单位为元</td> </tr> <tr> <td>price</td> <td>是</td> <td>string</td> <td>平台售价</td> </tr> <tr> <td>state</td> <td>是</td> <td>string</td> <td>充值状态:<code>success</code> 表示充值成功,<code>failed</code> 表示充值失败</td> </tr> <tr> <td>user_order</td> <td>是</td> <td>string</td> <td>商户订单号</td> </tr> <tr> <td>sign</td> <td>是</td> <td>string</td> <td>签名,具体方法见签名规则</td> </tr> <tr> <td>voucher</td> <td>否</td> <td>string</td> <td>充值凭证(不参与签名)</td> </tr> </tbody> </table> <hr /> <h2>返回参数</h2> <table> <thead> <tr> <th>参数名</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>Success</td> <td>商户需返回 <code>Success</code> 以表示收到通知,通知完成</td> </tr> </tbody> </table> <hr /> <h2>状态字段说明</h2> <table> <thead> <tr> <th>状态值</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>success</td> <td>表示充值成功</td> </tr> <tr> <td>failed</td> <td>表示充值失败</td> </tr> </tbody> </table> <hr /> <h2>示例</h2> <h3>回调请求示例</h3> <pre><code class="language-http"> GET /callback?userid=10001&amp;amp;order_id=123456&amp;amp;account=13800138000&amp;amp;amount=10&amp;amp;price=9.8&amp;amp;state=success&amp;amp;user_order=ORDER123&amp;amp;sign=ABCDEF123456 HTTP/1.1 Host: 商户回调地址</code></pre>

页面列表

ITEM_HTML