测试地址:http://116.228.64.55:28082/yst-service-api/tq/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tq/handle
接口代码(transCode):3002
功能说明:
1、商户通过【订单状态查询接口】获取订单终态后,需通过已完成订单的交易信息作下一步业务判断时,可调用此接口查询订单详细信息,支持查询5年内的订单详情信息。
2、增加响应字段“是否微信订单预消费”,针对订单子类型为“微信订单预消费”的,则返回1:是。
业务请求参数
字段 |
字段类型 |
必填 |
字段长度 |
字段名称 |
说明 |
respTraceNum |
String |
否 |
40 |
通联订单号 |
若上送以此为准 |
reqTraceNum |
String |
否 |
50 |
商户订单号 |
1.“通联订单号”与“商户订单号+订单创建日期”,必传其中一种 2.使用“商户订单号”查询时,必须传“订单创建日期”。 为确保订单查询效率,建议使用通联单号 |
oriTransDate |
String |
否 |
8 |
订单创建日期 格式:yyyyMMdd |
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
商户订单号 |
|
respTraceNum |
String |
40 |
是 |
通联订单号 |
|
result |
String |
1 |
否 |
订单状态 |
0:进行中 1:交易成功 2:交易失败 |
txDesc |
String |
256 |
否 |
订单状态说明 |
订单失败的错误信息 |
orgReqTraceNum |
String |
50 |
否 |
原商户订单号 |
退款时才返回 |
orgRespTraceNum |
String |
40 |
否 |
云商通原订单号 |
退款时才返回 |
orderAmount |
Long |
20 |
是 |
订单金额 |
|
payAmount |
Long |
20 |
否 |
支付金额 |
|
finishTime |
String |
20 |
否 |
订单支付完成时间 |
yyyy-MM-dd HH:mm:ss |
extendParams |
String |
200 |
否 |
扩展参数 |
订单接口信息原样返回,不可包含“|”特殊字符 |
channelparamInfo |
JSONObject |
|
否 |
渠道参数信息(支付详情) |
渠道返回时有值 |
respCode |
String |
5 |
是 |
业务返回码 |
00000:仅代表本次查询任务 订单状态请根据result 判断 |
respMsg |
String |
200 |
是 |
业务返回说明 |
|
isPreConsume |
String |
40 |
否 |
是否微信订单预消费 |
枚举值: 0:否 1:是 |