查询订单状态接口V2.0
(→请求参数) |
(→请求参数) |
||
第34行: | 第34行: | ||
<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"> | + | <th width="65%" style="text-align:left;padding-left:5px;border:1px solid #cccccc">订单号,此订单号由应用开发者生成(可称为“应用订单号”)。为 了避免重复,需要以orderid_pre开 头即支付ID(7位), 总长 度必须为16位,用于对账,客服支持等。</th> |
</tr> | </tr> | ||
2013年12月27日 (五) 15:49的版本
目录 |
查看订单状态接口
- 用户支付成功后,开放平台通过 “回调接口”将订单支付成功信息通知给开发者;如果开发者没有收到任何回调信息,则可调用“订单状态接口”来获取订单支付状态。
URL
URL:http://pay.api.weibo.com/pay/show_order.format (json/xml)
支持格式
JSON/XML
HTTP请求方式
GET/POST
是否需要登录
否
请求参数
参数名 | 必填 | 类型及范围 | 说明 |
---|---|---|---|
order_id | true | string | 订单号,此订单号由应用开发者生成(可称为“应用订单号”)。为 了避免重复,需要以orderid_pre开 头即支付ID(7位), 总长 度必须为16位,用于对账,客服支持等。 |
sign | true | string | 签名值sign = md5(order_id|app_secret)。
查询app_secrect,请访问“开放平台-应用信息(基本信息)页面” |
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。 |
返回结果
订单状态信息说明: 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:交易人
错误情况的返回码描述
- 在参数验证错误,或请求非法时,根据不同的情况,会返回不同的错误码(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不存在! |