订单查询

简要描述

查询提交的订单。
UETR需在订单结束5-30分钟后获取，如有需要可主动查询。

更新记录

更新日期	更新内容
2025-09-16	添加返回 fixedFee、preRatedFee 字段
2025-10-08	添加返回 chargeCode、fullPayFee 字段

请求URL

${baseUrl}/tf/v4/order/query

请求方式

Method: POST
Content-Type: application/json

请求参数

参数名	必选	类型	说明
orderNo	否	string	平台订单号，不为空则只用此字段查询
merOrderNo	否	string	渠道订单号

返回示例

{
    "data": {
        "account": "543435",
        "completeTime": "2024-08-31 15:17:56",
        "createTime": "2024-08-31 15:03:25",
        "ext": "",
        "failReason": "",
        "merOrderNo": "240831150324112064",
        "orderNo": "240831150325224032",
        "sourceAmount": 1586.150,
        "sendAmount": 0,
        "sourceCurrency": "USD",
        "status": 1,
        "targetAmount": 10000,
        "targetCurrency": "CNY",
        "fixedFee": 5,
        "preRatedFee": 0.012,
        "chargeCode": "FP",
        "fullPayFee": 20
    },
    "msg": "操作成功",
    "status": 200,
    "success": true
}

返回参数说明

参数名称	示例	参数说明
data	json	响应数据订单信息
msg	操作成功	响应消息
status	200	响应码
success	true	是否成功：成功 true，失败 false

data - 订单信息

参数名称	示例	参数说明
merOrderNo	436343534234	商家订单号
orderNo	35432346345345	平台订单号
account	6244810070000117	目标账户
sourceCurrency	USD	结算币种
sourceAmount	20.00	结算金额，最大两位小数，如果大于两位小数则取两位（如计算金额为2.123，最终为2.13）
sendAmount	20.00	发送金额
fixedFee	12	固定费用，币种与输入一致
preRatedFee	0.012	兑换手续费，例如发送金额为100，则该费用为100*0.012
merQuotes	7.3423	结算汇率
targetCurrency	CNY	目标币种
targetAmount	10000	目标金额
status	1	订单状态：1-处理中 2-成功 3-失败
failReason	信息错误	失败信息，订单失败时会返回失败原因
createTime	2023-04-02 17:07:09	订单创建时间
completeTime	2023-04-02 17:07:09	订单完成时间
ext	{“pickupCode”:“63742374673463847”}（字符串）	订单额外信息，备注：可能存在的额外信息见下方

ext - 订单额外信息

类型	示例	参数说明
cash_pickup	{“pickupCode”:“63742374673463847”}	取现凭证，现场出示
wire	{“uetr”:“63742374673463847”}	此 UETR 可提供给收款银行，用于协助交易追踪

Keyboard shortcuts

api