面包多Pay
搜索
K

订单查询

除调用 API 外,也可以直接在 控制台 查询订单

请求URL

  • https://api.niucodata.com/release/main/search_order

请求方式

  • POST
  • Json

请求参数

参数名
必选
类型
说明
out_trade_no
string
订单号(也支持微信/支付宝流水号)
app_id
string
你的 app_id,可在控制台查看
sign
string
请求签名,参照签名算法

返回示例

//成功
{
"order_id": "36b4272290745783269904952a40d6d1",
"charge_id": "4002110000491201231021102123",
"description": "突字幕高级版",
"share_id": null,
"share_state": "0",
"amount": "12900",
"state": "1",
"create_time": "1615479215",
"payway": "1",
"refund_state": "0",
"refund_amount": "0"
}
//失败
{
"error": "找不到该订单"
}

返回参数说明

参数名
类型
说明
order_id
string
订单号
charge_id
string
支付渠道流水号
description
string
商品描述
share_id
string
结算ID
share_state
int
结算状态
amount
int
支付金额,单位为分
state
int
支付状态,0-未支付,1-已支付,2-已结算,3-投诉中,4-投诉完结,5-投诉超时,6-投诉中(买家处理中)
create_time
int
支付时间(时间戳)
payway
int
支付渠道,1为微信支付,2为支付宝
refund_state
int
退款状态,0为无退款,1为部分退款,2为全部退款
refund_amount
int
已退款金额,单位为分
plusinfo
string
附加参数(json格式)

备注

  • 此接口用于订单的辅助查询,请勿直接使用此接口做订单状态的高频轮询,调用频率过高可能会导致IP进入黑名单
  • 正确的业务逻辑:通过接收异步通知后更新自己订单状态,用户前端轮询应放在商户侧订单状态