佳诺虚充业务API接口文档

代理开放接口文档


订单回调通知

<p>[TOC]</p> <h5>推送状态</h5> <p>接口用户提供接收 http post 推送的 url 地址。接收到推送数据解析成功后返回响应文本, 即为推送成功,  订单状态成功或者失败时才会推送,  其他状态不会推送。</p> <h5>参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">UserId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>帐号 ID(签名)</td> <td>注意不是登陆名</td> </tr> <tr> <td style="text-align: left;">BizType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>业务类型(签名)</td> <td>固定填写:  ECARD</td> </tr> <tr> <td style="text-align: left;">OrderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单号(签名)</td> <td>不大于 32 位的唯一订单号</td> </tr> <tr> <td style="text-align: left;">AccountVal</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>充值目标账号(签名)</td> </tr> <tr> <td style="text-align: left;">OrderStatus</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单状态(签名)</td> <td>SUCCESS:充值成功 FAILED:充值失败 UNDERWAY:  下单成功,充值中</td> </tr> <tr> <td style="text-align: left;">ProductData</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>订单产品数据(签名)</td> <td>特定产品订单才会返回,  直充都返回空,卡密产品 会返回卡密信息。<strong>卡密产品格式:  (JSON 数组列表)</strong><code>[{type: &amp;quot;0&amp;quot; ,// 0 卡密,  1 激活 URL,  2:  卡密+URL code: &amp;quot;E1327419237491&amp;quot;,// 卡号key: &amp;quot;345352&amp;quot;,// 卡密钥url: &amp;quot;&amp;quot;,// 卡激活 URL 地址effstart: &amp;quot;2020-02-20&amp;quot;,// 有效开始时间 effend: &amp;quot;2020-03-19&amp;quot;,// 有效结束时间 extinfo: null,// 其它信息}]</code></td> </tr> <tr> <td style="text-align: left;">Time</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>时间戳(签名)</td> <td>1970-1-1  ( UTC)  到现在的总秒数 10位</td> </tr> <tr> <td style="text-align: left;">Sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>签名值</td> <td>参见签名算法</td> </tr> </tbody> </table> <h5>示例格式</h5> <pre><code>{ &amp;quot;AccountVal&amp;quot;: &amp;quot;15883046208&amp;quot;, &amp;quot;BizType&amp;quot;: &amp;quot;ECARD&amp;quot;, &amp;quot;OrderNo&amp;quot;: &amp;quot;S20240124174447379502&amp;quot;, &amp;quot;OrderStatus&amp;quot;: &amp;quot;SUCCESS&amp;quot;, &amp;quot;ProductData&amp;quot;: &amp;quot;[{\&amp;quot;code\&amp;quot;:\&amp;quot;sy23121988\&amp;quot;,\&amp;quot;effend\&amp;quot;:\&amp;quot;2024-06-30\&amp;quot;,\&amp;quot;effstart\&amp;quot;:\&amp;quot;2024-01-23\&amp;quot;,\&amp;quot;key\&amp;quot;:\&amp;quot;5810QaAE167\&amp;quot;,\&amp;quot;type\&amp;quot;:0,\&amp;quot;url\&amp;quot;:null}]&amp;quot;, &amp;quot;Sign&amp;quot;: &amp;quot;d90a6ed37e1bd5a9dccd9be11b4cda89&amp;quot;, &amp;quot;Time&amp;quot;: &amp;quot;1706089710757&amp;quot;, &amp;quot;UserId&amp;quot;: &amp;quot;test&amp;quot; }</code></pre> <h5>回调响应</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> <th>备注</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">int</td> <td>消息代码</td> <td>成功返回 0,  出错返回对应的错误码</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">String</td> <td>消息文本</td> </tr> </tbody> </table> <p><strong>成功返回 JSON 文本:  {&quot;code&quot;: 0} 失败返回 JSON 文本:  {&quot;code&quot;: -1, &quot;msg&quot;:&quot;错误描述&quot;}</strong></p> <h6>注意</h6> <p><em>接口用户给我们的回调响应不是订单状态,  是服务器收到了我们的通知,  无论订单是否成功都需要返回成 功接收到的JSON文本,  避免双方服务器资源的浪费。</em></p>

页面列表

ITEM_HTML