## 获取预支付交易数据集合(cashierBuild) >[info] 场景说明:进入收银台页面后,获取收银台的交易数据集合,包含可用的支付方式列表,交易商品信息。 ### 是否需要获取用户TOKEN `是` ***** ### 请求地址 ``` POST http://api.xxx.com/cashier/build ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 用户TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | bizOrderId | string\[\] | 必须 | 商户业务订单号,格式如:\["15000","15098"\],多个业务订单号说明是合并付款的情况 | | bizIdentity | string | 必须 | 订单业务类型,具体参考:[订单业务类型代码](order-code.md) | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "bizOrderId": ["15996949217652572", "15996949213277484"], "bizIdentity": "trade10001" } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有指定用返回空 | | └ orderId | string\[\] | 必须 | 预支付的交易号集合,合并付款时会有多个交易号,格式如:\["20203455","20309898"\] | | └ orderInfo | array | 必须 | 交易数据信息 | | └ payments | list | 必须 | 支持的支付方式列表 | 返回`data->orderInfo`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | amount | decimal | 必须 | 支付金额 | | payType | string | 必须 | 支付类型,固定为:SHIELD | | bizIdentity | string | 必须 | 订单业务类型 | | title | string | 必须 | 支付标题 | | mergePay | integer | 可选 | 合并付款标识,1=表示有多笔订单合并付款、0或空表示单笔支付 | | \+ tradeList | list | 必须 | 订单按店铺归类数据列表,注:数组键值为每个店家的店铺ID | | └ tradeNo | string | 必须 | 交易号 | | └ bizOrderId | string | 必须 | 商户业务订单号 | | └ seller\_id | integer | 必须 | 卖家ID | | └ store\_name | string | 必须 | 店铺名称 | | └ goods\_name | string | 必须 | 商品名称 | 返回`data->payments`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | string | 必须 | 支付方式代码 | | name | string | 必须 | 支付方式名称 | | desc | string | 可选 | 支付方式简介 | | selected | integer | 必须 | 默认支付方式,1=是、0=否 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "orderId": ["20200910154201452404","20200910154251755524"], "orderInfo": { "amount": 3032.70, "payType": "SHIELD", "bizIdentity": "trade10001", "title": "合并付款 | 2笔订单", "mergePay": 1, "tradeList": [ { "trade_id": 7, "tradeNo": "20200910154201452404", "bizOrderId": "15996949217652572", "bizIdentity": "trade10001", "seller_id": 2, "amount": 2961.60, "store_name": "演示店铺", "goods_name": "【以旧换新 门店现货】Samsung/三星 Galaxy S9 SM-G9600曲屏手机等多件" }, { "trade_id": 8, "tradeNo": "20200910154251755524", "bizOrderId": "15996949213277484", "bizIdentity": "trade10001", "seller_id": 4, "amount": 71.10, "store_name": "华为旗舰店", "goods_name": "华为G9600曲屏手机壳" } ] }, "payments": [ { "code": "deposit", "name": "预存款", "desc": "预存款是您在网站上的虚拟资金帐户", "selected": 1 } ] } } ```