订单状态查询API - 商户采购API接口文档

请求参数

Body 参数application/json

app_key

string

【公共参数】系统分配给商户的秘钥

必需

sign

string

【公共参数】签名

必需

所有请求参数签名

timestamp

string

【公共参数】Unix时间戳

必需

时区为 GMT+8 允许与服务器最大误差30秒

order_id

string

平台充值订单号

可选

充值接口返回(优先使用)

third_id

string

家侧订单ID

可选

time

string

放单时间

可选

当传third_id时需要此字段传order_id时不需要
格式为时间戳，精确到秒，通过third_id查询则为必填参数

示例

{
    "app_key": "",
    "sign": "",
    "timestamp": "",
    "order_id": "25030500002251",
    "third_id": "",
    "time": ""
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://test.merchant.center.mf178.cn/api/merchant/order_info' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_key": "",
    "sign": "",
    "timestamp": "",
    "order_id": "25030500002251",
    "third_id": "",
    "time": ""
}'

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

0 成功其他失败

message

string

必需

stime

number

必需

etime

number

必需

data

object

必需

state

enum<integer>

当前订单状态

可选

枚举值:

2346

order_id

integer

充值订单号

必需

third_id

string

商家订单号

必需

time

string

订单时间

必需

状态为2 时为处理时间
状态为3时为充值到账时间

cost

string

订单费用

必需

real_amount

string

实际面值

必需

voucher

string

凭证信息或交易流水号

可选

info

string

如充值失败，对应错误信息

可选

card_no

string

如果我们是卡密充值，那么返回卡号

可选

error_code

enum<integer>

错误码

可选

失败编码，当失败是返回对应code 成功返回空

枚举值:

1234

rsp_info

string

失败原因

可选

成功时返回空

ys_cards

卡密或兑换码信息

可选

一手卡密或代下单-餐饮的时候，需要上报

示例

话费示例一手卡密示例代餐示例异常示例

{
    "code": 0,
    "message": "ok",
    "stime": 1745202771.125173,
    "etime": 1745202771.285683,
    "data": {
        "state": 4,
        "order_id": 25040400000200,
        "third_id": "20250404012135AVVILCEX-rechargeMifeng4",
        "time": "2025-04-04 01:30:46",
        "cost": "22.000",
        "real_amount": "0.000",
        "voucher": "",
        "info": "",
        "card_no": "",
        "error_code": "",
        "rsp_info": "充值失败，库存不足"
    }
}