14.1预授权条码收款

优质

小牛编辑

126浏览

2023-12-01

预授权扫码枪收款，支持随行付通道

经营要求：

1、进件住宿服务、汽车租赁；
2、且营业执照的经营内容也要包含该经营内容

注：用户被扫码付款，此时会冻结对应金额的资金【30天】，如30天之内不做处理，即解冻原路退回至用户账户

此协议的返回有两种情况：一是扫码后无需密码直接完成交易，则协议马上返回。二是需要用户输入密码，返回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

请求示例

{
    "action":{
        "action":"pre_code_pay"
    },
    "get":{
        "biz_id":"20191125001",
        "amt":"8.88",
        "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

响应示例

{
  "status": "1",
  "info": "预授权成功",
  "payid": "186210020001140661",
  "biz_id": "20210424",
  "transaction_id": "4200000928202104215623609195",
  "freeze_amount": "0.02",
  "unfreeze_amount": 0,
  "pay_amount": 0,
  "state":"WAIT",
  "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"
}