查询订单状态 - 探鸽开放平台API文档

请求参数

Query 参数

merchant_number

string

必需

平台订单号，订单id、订单号二选一

示例值:

20190520160646984088060

order_id

integer

必需

平台订单id，订单id、订单号二选一

示例值:

1939979

Header 参数

X-Tg-Signed-Headers

string

必需

参与预算签名的header

示例值:

x-tg-app-id;x-tg-date

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

Accept-Language

string

必需

请求端的本地语言（zh-cn, zh-tw, en-us, ja, ko, vi, es, pt, ru, tr, de, it, fr, pl, th, ar）

默认值:

Authorization

string

必需

服务端接口时传入签名计算后的字符串。客户端APP传入用户登陆态数据access_token。两者不要混用。

默认值:

X-Tg-Date

string

必需

当前请求的UTC+0时间（注意时区，不是本地时区）

默认值:

20060102T150405Z

X-Tg-Content-Sha256

string

必需

将BODY数据进行SHA256计算后的值

X-Tg-Algorithm

string

必需

目前服务端接口使用的签名算法的版本号和哈希算法

默认值:

TGV1-HMAC-SHA256

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://openapi-cn01.tange365.com/v2/cloud-payment/order?merchant_number=20190520160646984088060&order_id=1939979' \
--header 'X-Tg-Signed-Headers: x-tg-app-id;x-tg-date' \
--header 'X-Tg-Signed-Headers;' \
--header 'X-Tg-App-Id;' \
--header 'Accept-Language;' \
--header 'Authorization;' \
--header 'X-Tg-Date;' \
--header 'X-Tg-Content-Sha256;' \
--header 'X-Tg-Algorithm;'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

非200表示出错

msg

string

错误描述

必需

data

object

数据

必需

merchant_number

string

平台订单号

必需

payment_method

string

支付方式

必需

预付款余额支付：Balance

status

string

订单状态

必需

0待支付、1支付处理中、2支付完成、3支付失败、4退款中、5退款失败、6已退款

create_at

integer

下单时间

必需

unix时间戳，如1675785868

device_id

string

设备ID

必需

iccid

string

物联网卡号

必需

user_id

integer

用户账号ID

必需

fee_amount

number

服务费金额

必需

currency_code

string

货币单位

必需

amount

string

订单金额

可选

平台代收款的项目有意义

示例

{
  "code": 200,
  "msg": "ok",
  "data": {
    "merchant_number": "20190520160646984088060",
    "create_at": 1558339606,
    "payment_method": "Balance",
    "status": "2",
    "currency_code": "CNY",
    "device_id": "1702D8OBYWWQ",
    "iccid": "89861122241045896497",
    "user_id": 34,
    "fee_amount": 28,
    "amount": "99.99"
  }
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误