19支付 - 文档中心

收银台支付

收银台支付是通过 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
seller_email String 支付宝结算账号 渠道类型为alipay时,seller_email必填
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.特别提醒:支付后回调函数,并不能标示实际支付状态。商户需在异步通知中完成验单逻辑

最后更新: 2020-03-07