查询收银台

描述

查询收银台，仅支持在微信/支付宝小程序里使用。

路径

/optimus/core/cashier/queryCashierPage

入参说明（JSON 格式）

入参整体结构

参数 参数名称 类型 是否必传 描述 示例
appid 应用id String Y 固定值 见测试参数
seller 商户信息 Object Y 固定值 见测试参数
paymentMode 支付模式代码 Integer Y 固定值 4
paymentEnv 支付环境 Object Y 支付环境
payer 付款人信息 Object N
acquiringInfo 收单信息 Object Y 前置操作获取

入参字段结构

seller 字段明细

参数 参数名称 类型 是否必传 描述 示例
merchantId 商户Id String Y 固定值 见测试参数
merchantUserId 商户userId String Y 固定值 见测试参数
role 角色 String Y 固定值 见测试参数

paymentEnv 字段明细

参数 参数名称 类型 是否必传 描述 示例
ip ip地址 String N 最大40位
client 支付客户端 String Y 最大32位 wechat/alipay
device 设备号 String N 最大64位
version 版本号 String N 1.4

payer 字段明细

参数 参数名称 类型 是否必传 描述 示例
userId 付款人Id String Y 固定值 见测试参数 merchantUserId

acquiringInfo 字段明细

参数 参数名称 类型 是否必传 描述 示例
acquiringSn 收单编号 String Y 前置操作后拿到
signature 收单签名 String Y 前置操作后拿到

出参说明（JSON 格式）

出参整体结构

参数 参数名称 类型 描述 示例
success 请求状态 Boolean true：成功；false：失败 TRUE
code 状态码 String 0000：成功；其他为异常码 "0000"
msg 状态描述 String 请求结果的描述信息 "处理成功"
data 订单数据 Object 收银台数据

出参字段结构

data 字段明细

参数 参数名称 类型 描述
payTools 支付工具 List\
selectedSignature 已选中的支付工具签名 String
globalTips 全局提示 List\
seq 序列号 String 响应唯一序列号
amount 收单金额 Long
payee 收款方信息 Object
bizInfo 业务信息 Object
cashierAmount 金额模型 Object

payTools 字段明细

参数 参数名称 类型 描述
id 支付工具id Long
code 支付工具代码 String
name 支付工具名称 String
type 支付工具类型 Integer 0 表示微信
selectable 是否可选 boolean
selected 是否选中 boolean
showAmount 展示金额 Long
tips 提示 List\
amountComposition 金额构成 Object 下方的接口要用

payTools.amountComposition 字段明细

参数 参数名称 类型 是否必传
compositionItems 金额构成项列表 List\ Y

payTools.amountComposition.compositionItems 字段明细

参数 参数名称 类型 是否必传
category 构成项类目 String Y
amount 构成项金额 Long Y

payee 字段明细

参数 参数名称 类型
merchantId 商户id String
merchantName 商户名称 String
storeId 门店id String
storeName 门店名称 String
terminalSn 终端号 String

bizInfo 字段明细

参数 参数名称 类型
bizParty 业务方 String
tradeApp 交易应用 String

cashierAmount 字段明细

参数 参数名称 类型
oriPaymentAmount 原始支付金额 Long
discPaymentAmount 实际支付金额 Long
discAmount 优惠金额 Long

示例

{
    "appid": "2025082700005615",
    "seller": {
        "merchantId": "1c904b2d-f056-4afa-a819-0328a4774320",
        "merchantUserId": "6ce169d1-1289-4e98-b4a3-ea8b6145046f",
        "role": "super_admin"
    },
    "acquiringInfo": {
        "acquiringSn": "2026032016412219191",
        "signature": "b4BFXQ06jrRkDCSKNgGt"
    },
    "paymentMode": 4,
    "paymentEnv": {
        "ip": "",
        "client": "wechat",
        "device": "",
        "version": "1.4"
    }
}

返回

{
    "success": true,
    "code": "0000",
    "msg": "处理成功",
    "data": {
        "payTools": [
            {
                "id": 1,
                "code": 105,
                "name": "储值余额",
                "type": 1,
                "selectable": true,
                "selected": null,
                "showAmount": null,
                "tips": null,
                "amountComposition": null
            },
            {
                "id": 3,
                "code": 3,
                "name": "微信",
                "type": 0,
                "selectable": true,
                "selected": true,
                "showAmount": 1,
                "tips": null,
                "amountComposition": {
                    "compositionItems": [
                        {
                            "category": "default",
                            "amount": 1
                        }
                    ]
                }
            }
        ],
        "selectedSignature": "RXVTu8uS-yfafq4UeepL",
        "seq": "b4cd8afbc4384bf499e090e02e3f3a7e",
        "amount": 1,
        "payee": {
            "merchantId": "fd567f94-9a44-4ae5-879f-9acc919d0f89",
            "merchantName": "商户0423JEoC",
            "storeId": "d8379cc0-cff7-42f7-8f30-378cfbd527cd",
            "storeName": "edu首家门店（可开发票）",
            "terminalSn": "2101056320290950707"
        },
        "bizInfo": {
            "bizParty": "optimus",
            "tradeApp": "7224"
        }
    }
}

results matching ""

    No results matching ""