# 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 参数签名,详细请看“接口签名机制”