queryOrder

接口说明

校验用户登录态 session_key 是否有效。开发者可以通过该接口检测用户登录态是否过期。

接口地址

国内：

POST https://cloud-miniapp.tapapis.cn/order/v1/detail

国际：

POST https://cloud-miniapp.tapapis.com/order/v1/detail

请求参数 - Query

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
signature	string		是	用户签名，参考签名验证
sig_method	string	hmac_sha256	是	签名方法，目前仅支持 hmac_sha256
pay_sig	string		是	支付请求签名（pay_sig）算法说明

请求参数 - Body

属性	类型	默认值	必填	说明
openid	string		是	用户唯一标识
offer_id	string		是	在 TapTap 侧申请的应用 MiniApp ID
ts	number		是	当前UNIX时间戳（秒级），例如：1668136271
zone_id	string		是	1
env	number		是	环境类型： 0：测试环境 1：正式环境
ord_trade_no	string		是	交易订单号
biz_id	number		是	2 道具直购

返回值

返回的 JSON 数据包

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
product_id	string	道具 id
pay_state	number	支付状态（用户是否已支付）1 未支付 2 已支付
deliver_state	number	发货状态 1 未发货 2 已发货
pay_finish_time	number	支付完成时间
out_trade_no	string	充值时传入的外部订单号
mch_order_no	string	支付商户单号
transaction_id	string	交易单号

errcode 的合法值

错误码	说明
0	请求成功
-1	系统繁忙，此时请开发者稍候再试
90010	signature 签名错误
90011	pay_sig 签名错误
90016	sessionkey fail，用户 sessionkey 过期，需要重走登录流程
90018	参数错误，具体参数见 errmsg 描述
90019	out_trade_no 未找到

正常返回

{
  "errcode": 0,
  "errmsg": "ok",
  "out_trade_no": "test_queryorderinfo_1668512806",
  "pay_finish_time": 1669364790,
  "product_id": "id_100001",
  "deliver_state": 1,
  "pay_state": 1,
  "mch_order_no": "1217752501201407033233368018",
  "transaction_id": "1217752501201407033233368018"
}

错误返回

{
  "errcode": 90018,
  "errmsg": "[openid] openid is invalid"
}