## query_order（查询订单） | 接口地址 | 接口名称 | | --- | --- | | 平台域名/api/query_order | 查询订单 | | 请求方式 | 字符编码 | 响应数据格式 | 商户身份验证 | | --- | --- | --- | --- | | GET/POST | UTF-8 | JSON | 是 | * 请求参数 | 参数名 | 类型 | 名称 | 必填 | 示例 | 描述 | 系统版本号 | | --- | --- | --- | --- | --- | --- | --- | | out_trade_no| string | 系统订单号 | 否 | XY20210819155352820192199 | out_trade_no或api_trade_no至少传入一个 | 1.3+ | | api_trade_no | string | 接口订单号 | 否 | 4200001180202108191793854834 | out_trade_no或api_trade_no至少传入一个 | 1.3+ | * 响应参数 | 参数名 | 类型 | 名称 | 必填 | 示例 | 描述 | 系统版本号 | | --- | --- | --- | --- | --- |--- |--- | | code | int | 返回码 | 是 | 0 | 除0以外的值都为失败，详情见[公共返回码](公共返回码.md) | 1.3+ | | msg | string | 提示信息 | 是 | 成功 | 具体提示信息以实际返回为准 | 1.3+ | | data| array| 订单信息 | 是 | 具体参数见1.1表 | 订单的信息的数组数据 | 1.3+ | * 参数名：data（1.1）： | 参数名 | 类型 | 名称 | 必填 | 示例 | 描述 | 系统版本号 | | --- | --- | --- | --- | --- |--- |--- | |uid| string | 商户UID | 是 | 94001 | 订单归属商户的UID | 1.3+ | |out_trade_no| string | 系统订单号 | 是 | XY20210819155352820192199 | ... | 1.3+ | |api_trade_no| string | 接口订单号 | 是 | 4200001180202108191793854834 | ... | 1.3+ | |type| string | 支付方式 | 是 | alipay | ... | 1.3+ | |money| string |支付金额 | 是 | 1.00| ... | 1.3+ | |name| string |支付商品名称 | 是 | 聚合收银台-测试支付 | ... | 1.3+ | |creation_time| string |订单创建时间 | 是 | 2021-10-21 00:00:00 | ... | 1.3+ | |payment_time | string |订单支付时间 | 是 | 2021-10-21 00:00:00 | 未支付将为null | 1.3+ | |remarks| string |订单备注信息 | 是 | 聚合收银台 | 付款时填写的订单备注，没有备注则为null | 1.3+ | |refund_money| string |已退款金额 | 是 | 1.00 | 未退款将为0.00 | 1.3+ | |refund_time| string |退款时间 | 是 | 2021-10-21 00:00:00 | 未退款将为null | 1.3+ | |ip| string |IP地址 | 是 | 127.0.0.1 | 用户支付IP | 1.3+ | |buyer| string |用户标识 | 是 | 2088722372306754 | 如支付宝用户ID等。但因接口的多样性，部分接口没有用户标识，则可能会返回null | 1.3+ | |state| int |订单状态 | 是 | 1 | 详见[订单状态列表](订单状态列表.md) | 1.3+ |