## 提交预支付交易订单(cashierPay) >[info] 场景说明:提交支付请求,如果是余额支付,直接完成支付请求,如果是其他线上支付,则跳转到第三方支付平台完成支付。 ### 是否需要获取用户TOKEN `是` ***** ### 请求地址 ``` POST http://api.xxx.com/cashier/pay ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | 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`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | orderId | string\[\] | 必须 | 待支付订单的交易号集合,格式如:\["20203455","20309898"\] | | payment\_code | string | 必须 | 选择的付款方式,取值可参考:[支付方式代码](payment-code.md),必须保证支付方式为【[预支付交易数据集合](cashier-build.md)】接口中返回的可用的支付类型 | | password | string | 可选 | 用户资产账户的支付密码,当payment\_code="deposit"时必传 | ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "orderId": ["20200910154201452404","20200910154251755524"], "payment_code": "deposit", "password": "111111" } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | data | array | 必须 | 返回结果,如果没有指定用返回空 | 返回`data`参数格式 | 字段 | 类型 | 是否必填 | | | --- | --- | --- | --- | | payTradeNo | string | 必须 | 支付交易号,对应各种第三方支付平台,如支付宝、微信支付等的商户订单号 | | orderInfo | string/object | 可选 | 订单信息,支付宝返回字符串类型,微信支付返回对象 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "payTradeNo": "20200831090434433638", "orderInfo": "" } } ```