收银台支付
收银台支付是通过 JSAPI 方式发起的支付,只是简化了开发步骤和流程。适用于微信webview环境
接口请求步骤
1.构建请求参数
2.使用浏览器携带参数跳转至收银台地址
3.用户在收银台界面点击按钮发起支付
4.服务端接收异步通知
请求地址
环境 | HTTPS请求地址 | 请求方式 |
正式环境 | https://19zf.cn/api/cashier.html | POST,GET都支持 |
请求参数
参数 | 类型 | 是否必填 | 描述 | 示例值 |
app_id | String | 是 | 19支付平台分配和商户的APPID,19开头 | 191008821006 |
mch_id | String | 是 | 合作商户的商户号 | 1575500091 |
total_fee | int | 是 | 订单总金额 | 单位:分 |
out_trade_no | String | 是 | 商户订单号,需保证在商户端不重复 | 20150320010101001 |
body | String | 是 | 订单标题 | Iphone8 16G |
type | String | 否 | 渠道类型 | 留空表示微信支付。支付宝交易传值:alipay |
attach | String | 否 | 商户自定义数据包,在查询API和异步通知中原样返回 | 主要用于商户携带订单的自定义数据 |
notify_url | String | 否 | 接收支付成功后异步通知的回调地址。必须为可直接访问的URL,不能带参数、session验证、csrf验证。留空则不通知 | http://商户自定义地址/notify_url.html |
callback_url | String | 否 | 用户支付成功后,前端跳转地址。留空则支付后关闭webview | http://商户自定义地址/callback_url.html |
index_url | String | 否 | 用户取消支付后,前端跳转地址。留空则取消支付后关闭webview | http://商户自定义地址/index_url.html |
sign_type | String | 否 | 商户生成签名字符串所使用的签名算法类型,默认支持MD5 | MD5 |
auto | int | 否 | 收银台支付页面是否自动发起支付,默认auto = 0 | auto=0:手动点击发起支付 auto=1:自动发起支付 |
logo | String | 否 | 收银台显示的logo图片url | logo图片url |
sign | String | 是 | 数据签名,详见 签名算法 | 95AD5686E715127AA03F8324079673F0 |
请求返回
请求成功无返回。请求失败返回:
参数 | 类型 | 是否必填 | 描述 | 示例值 |
result_code | String | 是 | 接口响应结果 | SUCCESS:请求成功,FAIL:请求失败 |
result_msg | String | 是 | 接口响应结果描述 | 请求成功、请求失败、签名验证失败等 |
支付及成功返回说明
1.收银台模式下,请求直接发起收银台支付。
2.用户支付成功后,前台收银台页面自动关闭或跳转至自定义的 callback_url,后台系统会异步通知
3.特别提醒:支付后回调函数,并不能标示实际支付状态。商户需在异步通知中完成验单逻辑