### 网关
       接口接入域名地址(api_domian):https://pay.youyi.io
       网关地址:{api_domain}/web_api/gateway
~~~[api]
POST:https://pay.youyi.io/web_api/gateway
*string:method=接口名称#请求接口的标识:固定为shouqian.web.placeorder
*string:mch_no=商户编号#壹收银平台的商户编号
*string:mch_order_id=商户订单#商户订单id
*string:body=商品概述#商品概述,32个字符以内
*string:fee=交易总金额#交易总金额, 以分为单位
*string:pay_channel=支付渠道#支付渠道,1、微信;2、支付宝;
*string:return_url=回跳地址#页面跳转同步通知页面url
*string:notify_url=通知地址#服务器异步回调 url
*string:attach=附加参数#附加参数,平台将原样返回的信息
*string:request_time=发起时间#时间格式为
*string:sign=签名#’2017-05-07 12:30:34’
<<<
success
<<<
error
~~~
签名生成方法详见:[参数签名说明](https://www.kancloud.cn/book/cattong/youyisdk/preview/%E5%8F%82%E6%95%B0%E7%AD%BE%E5%90%8D%E8%AF%B4%E6%98%8E.md)
<br/>
<br/>
##
### 同步跳转及通知参数说明
       商户的请求数据处理完成后,会将处理的结果通知给商户网站。这些处理结果数据就是页面跳转同步通知参数(当消费者付完款之后,会从付款界面跳转回return_url地址下,然后处理的数据也相应的同步到这个地址下)
| 参数名 | 类型 | 参数名称 | 是否必填 | 描述 |
| --- | --- | --- | --- | --- |
| is_success | bool | 成功标识 | Y | 是否成功的标识,true/false |
| error_code | string | 错误码 | N | 仅is_success为false时出现 |
| error_message | string | 错误描述 | N | 仅is_success为false时出现 |
当成功标识is_success 为true时,返回下列数据:
| 参数名 | 类型 | 参数名称 | 是否必填 | 描述 |
| --- | --- | --- | --- | --- |
| our_order_id | string | 聚合平台订单号 | Y | 聚合平台内部唯一订单号 |
| mch_no | string(24) | 商户编号 | Y | 聚合平台的商户编号 |
| mch_order_id | string(32) | 商户订单 | Y | 商户订单id |
| status | int | 订单状态 | N | 订单状态:1.申请;2.取消;3.支付失败;4.支付成功;7.退款申请;8.退款失败;9退款心成功 |
| body | string(64) | 商品概述 | Y | 商品概述,32个字符以内 |
| fee | int | 交易总金额 | Y | 交易总金额, 以分为单位 |
| pay_channel | int | 支付渠道 | Y | 支付渠道,1、微信;2、支付宝; |
| app_id | string | 支付平台应用id | Y | 支付平台应用id |
| partner_id | string | 支付平台商户id | Y | 支付平台的商户id, |
| sign_type | string | 签名类型 | N | 签名类型 |
| pay_sign | string | 签名串 | N | 签名串 |
| wxpay_prepay_id | string(64) | 预支付id | N | 微信支付特有:预支付id |
| wxpay_timestamp | int | 时间戳 | N | 微信支付特有:时间戳 |
| wxpay_nonce_str | string | 一次性串 | N | 微信支付特有:一次性串 |
| alipay_response | string | 支付宝响应串 | N | 支付宝特有:响应串,直接返回给客户端用 |
| alipay_charset | string | 编码 | N | 支付宝特有:编码类型 |
| notify_url | string(256) | 通知地址 | Y | 服务器异步回调 url |
| attach | string(128) | 附加参数 | Y | 附加参数,平台将原样返回的信息 |
| sign | string(32) | 签名 | Y | 参数签名,详细请看“接口签名机制” |