# 1.场景及使用流程
# 使用场景:网页支付
生成含有商户订单信息的二维码,消费者使用微信/支付宝扫码进行支付
# 使用流程
1. 用户访问商户的网页端支付页面,触发支付控件(如点击支付按钮);
2. 支付页面向商户的后端服务器发起创建订单请求,订单创建后向支付网关发起支付请求,即参数签名之后,使用GET请求跳转至支付网关;
3. 客户端弹出支付控件,用户输入密码,确认支付;
4. 支付成功或失败后,跳转回商户参数指定的”return_url”页面,商户验证参数,修改订单状态,并展示支付结果。
5. 支付渠道异步通知至notify_url, 安全起见,建议以notify_url确定最终支付结果;
# 2.接入详解
商户的请求数据处理完成后,会将处理的结果通知给商户网站。这些处理结果数据就是页面跳转同步通知参数(当消费者付完款之后,会从付款界面跳转回return_url地址下,然后处理的数据也相应的同步到这个地址下)
参数名 | 类型 | 参数名称 | 是否必填 | 描述 |
---|---|---|---|---|
is_success | string | 成功标识 | Y | 是否成功的标识,true/false |
error_code | string | 错误码 | N | 仅is_success为false时出现 |
error_message | string | 错误描述 | N | 仅is_success为false时出现 |
our_order_id | string | 壹收银平台订单号 | Y | 壹收银平台内部唯一订单号 |
mch_no | string(24) | 商户编号 | Y | 壹收银平台的商户编号 |
mch_order_id | string(32) | 商户订单 | Y | 商户订单id |
status | string | 订单状态 | N | 订单状态:SUCCESS |
body | string(64) | 商品概述 | Y | 商品概述,32个字符以内 |
amount | int | 交易总金额 | Y | 交易总金额, 以分为单位 |
pay_channel | int | 支付渠道 | Y | 1:微信;2:支付宝; |
open_id | string(64) | 支付平台open id | Y | 返回支付宝或微信的购买者的唯一标识码 |
return_url | string(256) | 回跳地址 | Y | 页面跳转同步通知页面url |
notify_url | string(256) | 通知地址 | Y | 服务器异步回调 url |
attach | string(128) | 附加参数 | Y | 附加参数,平台将原样返回的信息 |
sign | string(32) | 签名 | Y | 参数签名,详细请看“接口签名机制” |