查询订单状态接口V2.0

跳转到: 导航, 搜索

目录

查看订单状态接口

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

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):
  • 例如:
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不存在!
文档更新时间: 2013-12-27