查询渠道同步支付订单
描述
用于 BSC 等不走收银台直接发起收款场景的查询。
路径
/optimus/core/open/cashier/queryAcquiringDetail
入参说明(JSON 格式)
入参整体结构
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|---|
| appid | 应用id | String | Y | 固定值 | 见测试参数 |
| orderID | 订单信息 | Object | Y | 前置操作后拿到 |
入参字段结构
orderID 字段明细
| 参数 | 参数名称 | 类型 | 是否必传 | 描述 |
|---|---|---|---|---|
| sn | 订单编号 | String | Y | 前置操作后拿到 |
| signature | 订单密码 | String | Y | 前置操作后拿到 |
出参说明(JSON 格式)
出参整体结构
| 参数 | 参数名称 | 类型 | 描述 | 示例 |
|---|---|---|---|---|
| success | 请求状态 | Boolean | true:成功;false:失败 | TRUE |
| code | 状态码 | String | 0000:成功;其他为异常码 | "0000" |
| msg | 状态描述 | String | 请求结果的描述信息 | "处理成功" |
| data | 订单数据 | Object | 支付下单数据 |
出参字段结构
data 字段明细
| 参数 | 参数名称 | 类型 | 描述 | 示例 |
|---|---|---|---|---|
| acquiringDetailsState | 收单状态 | Byte | 0:待处理,1:处理中,2:处理成功,3:处理失败,4:已关闭,5:临时处理失败 | 0/1 BSC 需要轮询结果 超时 60 秒,其他可等支付回调;2 成功;3/4/5/6 可以直接失败 |
| orderAmount | 支付金额 | Object | ||
| channelInfo | 通道信息 | Object | ||
| paymentVoucher | 支付参数 | Object | ||
| printShortUrl | 订单短链 | String | 支付成功才返回 |
amount 字段明细
| 参数 | 参数名称 | 类型 | 描述 |
|---|---|---|---|
| totalAmount | 收单总金额 | Long | |
| paidAmount | 实际支付金额 | Long | 可能渠道有优惠 |
channelInfo 字段明细
| 参数 | 参数名称 | 类型 | 描述 |
|---|---|---|---|
| payWay | 支付方式 | String | 2 支付宝 3 微信 17 云闪付 |
| payWayDesc | 支付方式 | String | 支付宝/微信/云闪付 |
| tsn | 收钱吧单号 | String | |
| channelFinishTime | 渠道完成时间 | String | 时间戳,毫秒 |
| channelErrMsg | 渠道错误文案 | String |
示例
{
"appid": "2025082700005615",
"orderSn": "2026032016412219191",
"orderSignature": "b4BFXQ06jrRkDCSKNgGt",
"usingPayTool": {
"id": -1,
"payTool": -1,
"amount": 1,
"identity": "oAgds7T0nw06RtwQ-08qoLyU8SGs",
"payMode": 1,
"channelExt": {
"sub_appid": "wx36e68952a60af089"
}
},
"paymentEnv": {
"clientIp": "10.12.134.48",
"clientPoi": {
"longitude": "120.710893",
"latitude": "31.345654"
}
}
}