预授权扫码枪收款,支持随行付通道,易宝通道执照进件商户(随行付:满足下方条件进件时会自动开通;易宝满足下方条件,还需提供易宝商户号发群内运营申请开通)
开通要求:
1、执照进件时选择经营类别:住宿服务、汽车租赁;
2、且营业执照的经营内容也要包含该经营内容
注:随行付通道:用户被扫码付款,此时会冻结对应金额的资金【30天】,如30天之内不做处理,即解冻原路退回至用户账户(交易时间算第一天 ,上游会在第三十一天早上3点开始批量自动解冻)
易宝通道:31天内可操作预授权完成,过期上游会自动解冻。
此协议的返回有两种情况:一是扫码后无需密码直接完成交易,则协议马上返回。二是需要用户输入密码,返回status=0,请根据state的内容分别进行后续处理。
如果为WAIT表示用户正在输入密码,请调用协议14.3继续查询支付状态。
如果state为RETRY为服务器未能返回结果,也请继续调用14.3继续查询支付状态。
请求参数说明
| 参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
| action | 接口参数组 | 是 | object | ||
| └action | 需要调用的接口名称 | 是 | pre_code_pay | string | |
| get | GET参数组,本组参数需要参与签名 | 是 | object | ||
| └biz_id | 业务单号(确保线下唯一) | 是 | 20191125001 | number | |
| └amt | 预收款金额 | 是 | 8.88 | number | |
| └auth_code | 微信/支付宝付款码/会员卡号/会员动态码 | 是 | 134575377168574118 | number | |
| └table | 房台号 | 否 | 1001 | number |
请求示例
{
"action":{
"action":"pre_code_pay"
},
"get":{
"biz_id":"20191125001",
"amt":"8.88",
"table":"1001",
"auth_code":"134575377168574118"
}
}响应参数说明
| 参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
| status | 返回状态。接口成功时为1,出错为0 | 是 | 1 | number | |
| info | 错误时会返回相应的错误信息 | 是 | 预授权成功 | string | |
| msid | 门店编号 | 是 | 10021 | number | |
| payid | 果盘支付流水号 | 否 | 186210020001140661 | number | |
| biz_id | 线下业务单号 | 否 | 20210424 | number | |
| transaction_id | 官方订单号 | 否 | 4200000928202104215623609195 | number | |
| freeze_amount | 冻结金额 | 否 | 0.02 | number | |
| unfreeze_amount | 解冻金额 | 否 | 0 | number | |
| pay_amount | 转商家收款金额 | 否 | 0 | number | |
| merchant_no | 收款账号 | 否 | 399210315123949 | number | |
| pay_time | 冻结或解冻成功时间 | 否 | 2021-04-21 10:38:27 | string | |
| state | 支付状态 | 否 | WAIT | string | |
| table | 房台号 | 否 | 1001 | number | |
| type | 类型, wx=微信,ali=支付宝 ,yl=银联 ,mc=会员 | 否 | ali | string |
响应示例
{
"status": "1",
"info": "预授权成功",
"payid": "186210020001140661",
"biz_id": "20210424",
"transaction_id": "4200000928202104215623609195",
"freeze_amount": "0.02",
"unfreeze_amount": 0,
"pay_amount": 0,
"state":"WAIT",
"type":"ali",
"table":"1001",
"merchant_no": "399210315123949",
"pay_time": "2021-04-21 10:38:27",
"server_timestamp": 1618972707,
"server_time": "2021-04-21 10:38:27",
"server_name": "wx-task2.hz",
"msid": "6786"
}