Pay/order status

跳转到: 导航, 搜索
(创建新页面为 '==查看订单状态接口== *用户支付成功后,开放平台通过 “回调接口”将订单支付成功信息通知给开发者;如果开…')
 
(XML示例)
 
(未显示2个用户的7个中间版本)
第1行: 第1行:
 
==查看订单状态接口==
 
==查看订单状态接口==
  
*用户支付成功后,开放平台通过 “[[微支付回调接口|回调接口]]”将订单支付成功信息通知给开发者;如果开发者没有收到任何回调信息,则可调用“查看订单状态接口”来获取订单支付状态。
+
*用户支付成功后,开放平台通过 “[[回调接口|回调接口]]”将订单支付成功信息通知给开发者;如果开发者没有收到任何回调信息,则可调用“查看订单状态接口”来获取订单支付状态。
  
  
第7行: 第7行:
 
==URL==
 
==URL==
  
* 线上接口URL:http://api.t.sina.com.cn/pay/order_status.format
+
* 为了给开发者提供“便捷的支付接入流程”,我们提供两套环境供开发者使用。
   
+
 
 +
 
 +
*'''线上环境:'''
 +
*1) 应用已通过支付审核(有“支付ID”),则调用“线上环境”调试支付接口。
 +
*2) 线上接口URL:http://pay.api.weibo.com/pay/order_status.{xml/json}
 +
 
 +
 
 +
*'''测试环境:'''
 +
*1) 应用未通过支付审核但已通过文案,可申请“模拟支付ID”;若已获得“模拟支付ID”,则可调用“测试环境”调试支付接口。
 +
*2) 测试接口URL:http://pay.api.weibo.com/test/pay/order_status.{xml/json}
  
 
==支持格式==
 
==支持格式==
第38行: 第47行:
  
 
<tr>
 
<tr>
<th width="15%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">'''order_id'''</th>
+
<th width="15%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">'''order_id'''</th>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">true</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">true</th>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">string</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">string</th>
<th width="65%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">订单号,即获取token时传递的订单号,此订单号由开发者生成,可用于对账、客服支持等。</th>
+
<th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">订单号,即获取token时传递的订单号,此订单号由开发者生成,可用于对账、客服支持等。</th>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="15%" style="text-align:left;padding-left:5px;border:1px solid#cccccc"> '''sign'''</th>
+
<th width="15%" style="text-align:left;padding-left:5px;border:1px solid #cccccc"> '''sign'''</th>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">true</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">true</th>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">string</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">string</th>
<th width="65%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">必选。签名值 sign = md5(order_id|app_secret)
+
<th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">必选。签名值 sign = md5(order_id|app_secret)
 
App_secret的查看地址</th>
 
App_secret的查看地址</th>
 
</tr>
 
</tr>
第54行: 第63行:
  
 
<tr>
 
<tr>
<th width="15%" style="text-align:left;padding-left:5px;border:1px solid#cccccc"> '''source'''</th>
+
<th width="15%" style="text-align:left;padding-left:5px;border:1px solid #cccccc"> '''source'''</th>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">true</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">true</th>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">string</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">string</th>
<th width="65%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)</th>
+
<th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)</th>
 
</tr>
 
</tr>
  
  
 
+
<tr>
  </table>
+
<th width="15%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">'''access_token'''</th>
 +
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">false</th>
 +
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">string</th>
 +
<th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。</th>
 +
</tr>
  
  
 +
  </table>
  
 
==返回结果==
 
==返回结果==
第74行: 第88行:
 
<pre>
 
<pre>
 
//支付成功
 
//支付成功
{"order_id":"***","amount":"100","order_uid":"1234455555","order_status":"0/1"}
+
{"order_id": "1109000813469171",
 +
"order_uid": 1790421285,
 +
"amount": 100,
 +
"order_status": 0,
 +
"notify_time": 1346897693795
 +
}
  
 
</pre>
 
</pre>
第82行: 第101行:
 
<pre>
 
<pre>
  
//支付成功
+
<?xml version="1.0"
 +
encoding="UTF-8"?>
 
<result>
 
<result>
<order_id>***</order_id>
+
<order_id>1109000813469171</order_id><order_uid>1790421285</order_uid>
 
<amount>100</amount>
 
<amount>100</amount>
<order_uid>1234455555</uid>
+
<order_status>0<order_status>
<order_status>0/1<order_status>
+
<notify_time>1346897693795<notify_time>
 
</result>
 
</result>
 +
  
 
</pre>
 
</pre>
  
 +
 +
*'''字段描述''':
 +
 +
*order_id:订单id,如果是退款订单,则以CO开头
 +
 +
*amount:金额
 +
 +
*order_status:订单状态,0为进行中,1已经成功支付,2为退款订单
 +
 +
*order_uid:交易人
  
 
==相关约束==
 
==相关约束==
第118行: 第149行:
 
}
 
}
 
</pre>
 
</pre>
 
  
 
==错误情况的返回码描述==
 
==错误情况的返回码描述==
第138行: 第168行:
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23601</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23601</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">appkey has no privilege for pay!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">appkey has no privilege for pay!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">应用没有开通支付权限!</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">应用没有开通支付权限!</th>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23602</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23602</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id is null!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">order_id is null!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id参数为空!</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">order_id参数为空!</th>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23603</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23603</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">orderid_pre is null!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">orderid_pre is null!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">orderid_pre为空,没有获取到支付应用ID!</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">orderid_pre为空,没有获取到支付应用ID!</th>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23604</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23604</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id is invalid!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">order_id is invalid!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id格式非法! order_id必须为16位长,由两部分组成:支付应用ID (7位)+第三方订单号(9位)。</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">order_id格式非法! order_id必须为16位长,由两部分组成:支付应用ID (7位)+第三方订单号(9位)。</th>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23605</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23605</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id is invalid!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">order_id is invalid!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order_id非法! 例如,使用一个已存在的订单号,但传递不同的amount、或不同的uid来请求token。</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">order_id非法! 例如,使用一个已存在的订单号,但传递不同的amount、或不同的uid来请求token。</th>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23606</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23606</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">amount is invalid!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">amount is invalid!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">amount必须为1~500000分!
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">amount必须为1~500000分!
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23607</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23607</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">desc is null!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">desc is null!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">desc不能为空!</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">desc不能为空!</th>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23608</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23608</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">length of desc can't more 100!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">length of desc can't more 100!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">desc长度必须小于100个字节(即50个汉字)!</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">desc长度必须小于100个字节(即50个汉字)!</th>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23609</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23609</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">sign is null!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">sign is null!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">sign不能为空!</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">sign不能为空!</th>
 
</tr>
 
</tr>
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23610</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23610</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">sign is invalid!</th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">sign is invalid!</th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">sign经过md5计算后,不匹配!</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">sign经过md5计算后,不匹配!</th>
 
</tr>
 
</tr>
  
第200行: 第230行:
  
 
<tr>
 
<tr>
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">23611</th>
+
<th width="10%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">23611</th>
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">order not exists! </th>
+
<th width="30%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">order not exists! </th>
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid#cccccc">此order_id不存在!</th>
+
<th width="50%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">此order_id不存在!</th>
 
</tr>
 
</tr>
  

2012年9月6日 (四) 18:51的最后版本

查看订单状态接口

  • 用户支付成功后,开放平台通过 “回调接口”将订单支付成功信息通知给开发者;如果开发者没有收到任何回调信息,则可调用“查看订单状态接口”来获取订单支付状态。


URL

  • 为了给开发者提供“便捷的支付接入流程”,我们提供两套环境供开发者使用。



支持格式

  • JSON/XML


HTTP请求方式

  • GET/POST


是否需要登录

  • true (支持cookies、Oauth认证)


请求参数

参数名 必填 类型及范围 说明
order_id true string 订单号,即获取token时传递的订单号,此订单号由开发者生成,可用于对账、客服支持等。
sign true string 必选。签名值 sign = md5(order_id|app_secret) App_secret的查看地址
source true string 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数)
access_token false string 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。

返回结果

订单状态信息说明: 0—表示进行中,1—表示付款成功 (订单不存在将抛出异常)

JSON示例

//支付成功
{"order_id": "1109000813469171",
"order_uid": 1790421285,
"amount": 100,
"order_status": 0,
"notify_time": 1346897693795
}

XML示例


<?xml version="1.0" 
encoding="UTF-8"?>
<result>
<order_id>1109000813469171</order_id><order_uid>1790421285</order_uid>
<amount>100</amount>
<order_status>0<order_status>
<notify_time>1346897693795<notify_time>
</result>



  • 字段描述
  • order_id:订单id,如果是退款订单,则以CO开头
  • amount:金额
  • order_status:订单状态,0为进行中,1已经成功支付,2为退款订单
  • order_uid:交易人

相关约束


注意事项

  • 请求参数只需要 order_id sign source三个参数


PHP调用示例

try
{
        $c = new SaeTClient( WB_AKEY , WB_SKEY ,$_SESSION['oauth2']['oauth_token'] ,'' );
        $order_id = 1234567891234567;//订单id(需要以order_id_pre开头(7位)即为支付ID(汇总信息页面) ) + (后9位id不能重复,以免订单号重复) 。)总长度必须为16位
    
        $data= $c->pay_order_status( $order_id )
         
        var_dump( $data );
}
catch( Exception $e )
{
        var_dump($e);
}

错误情况的返回码描述

  • 在参数验证错误,或请求非法时,根据不同的情况,会返回不同的错误码(error_code):
  • 例如:
error_code error 中文含义
23601 appkey has no privilege for pay! 应用没有开通支付权限!
23602 order_id is null! order_id参数为空!
23603 orderid_pre is null! orderid_pre为空,没有获取到支付应用ID!
23604 order_id is invalid! order_id格式非法! order_id必须为16位长,由两部分组成:支付应用ID (7位)+第三方订单号(9位)。
23605 order_id is invalid! order_id非法! 例如,使用一个已存在的订单号,但传递不同的amount、或不同的uid来请求token。
23606 amount is invalid! amount必须为1~500000分!
23607 desc is null! desc不能为空!
23608 length of desc can't more 100! desc长度必须小于100个字节(即50个汉字)!
23609 sign is null! sign不能为空!
23610 sign is invalid! sign经过md5计算后,不匹配!
23611 order not exists! 此order_id不存在!




其他


文档更新时间: 2012-09-06