Pay/order status
(→PHP调用示例) |
|||
第1行: | 第1行: | ||
==查看订单状态接口== | ==查看订单状态接口== | ||
− | *用户支付成功后,开放平台通过 “[[ | + | *用户支付成功后,开放平台通过 “[[回调接口|回调接口]]”将订单支付成功信息通知给开发者;如果开发者没有收到任何回调信息,则可调用“查看订单状态接口”来获取订单支付状态。 |
第38行: | 第38行: | ||
<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行: | 第54行: | ||
<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> | ||
第137行: | 第137行: | ||
<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> | ||
第199行: | 第199行: | ||
<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> | ||
2011年11月8日 (二) 12:29的版本
查看订单状态接口
- 用户支付成功后,开放平台通过 “回调接口”将订单支付成功信息通知给开发者;如果开发者没有收到任何回调信息,则可调用“查看订单状态接口”来获取订单支付状态。
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授权方式不需要此参数) |
返回结果
订单状态信息说明: 0—表示进行中,1—表示付款成功 (订单不存在将抛出异常)
JSON示例
//支付成功 {"order_id":"***","amount":"100","order_uid":"1234455555","order_status":"0/1"}
XML示例
//支付成功 <result> <order_id>***</order_id> <amount>100</amount> <order_uid>1234455555</uid> <order_status>0/1<order_status> </result>
相关约束
- 无
注意事项
- 请求参数只需要 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):
- 例如:
- {"request":"http://10.73.14.130/pay/get_token.json","error_code":23610,"error":"sign is invalid!"}
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不存在! |
其他
- 无