### 网关 &ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;接口接入域名地址(api_domian):https://pay.youyi.io &ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;网关地址:{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/> ## ### 同步跳转及通知参数说明 &ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;商户的请求数据处理完成后,会将处理的结果通知给商户网站。这些处理结果数据就是页面跳转同步通知参数(当消费者付完款之后,会从付款界面跳转回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 | 参数签名,详细请看“接口签名机制” |