业务说明
本接口请求方为翼码系统,接收方为商家系统。
支付交易的冻结资金被解冻时,通知商户系统资金解冻结果。
报文格式:JSON
请求方式:POST
Content-Type: application/json;charset=utf-8
签名sign计算规则详见:JSON格式签名计算。
注意:标准接口通知报文节点后续会根据需求而做新增,切勿以固定格式解析报文和验签,避免增加节点造成代码报错。
注意:商户接收到通知处理成功后需响应字符串“success”,其他响应翼码系统认为通知失败会继续通知。
注意:同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。
注意:可空节点数据为空时,既可能返回null也可能返回空字符串,请解析时注意兼容。
请求报文
{"notify_type": "3","isspid": "00026713","store_id": "S20220927","pos_seq": "C20220928X1000000015","source": "1","pos_id": "S20220927","partner_id": "1503490901","end_time": "20220928144502","fund_freeze_stat": "02","freeze_time": "20240915161718","unfreeze_amt": "1000","unfreeze_time": "20240920121314","sign": "7A6B20F1AC3F18FBFC56F4A36CE3207F"}
请求报文说明
标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!
| 节点名称 | 中文名称 | 类型 | 说明 | 是否必填 |
|---|---|---|---|---|
| sign | 签名 | String(32) | 计算签名方式请看2.1章节 | 必填 |
| notify_type | 通知类型 | String(1) | 3:资金解冻通知 | 必填 |
| isspid | 商户号 | String(8) | 交易的翼码商户号 | 必填 |
| store_id | 门店号 | String(20) | 商户自定义的门店号 | 必填 |
| pos_seq | 支付请求流水号 | String(32) | 请求支付类接口的流水号(pos_seq) | 必填 |
| source | 订单来源 | String(1) | 1:接口接入 2:收款码牌 | 必填 |
| pos_id | 终端号 | String(20) | source=1时,商户自定义终端号 source=2时,收款码编号 | 必填 |
| partner_id | 商户收款帐号 | String(64) | 支付宝PID/微信商户号/间联通道商户号 | 可空 |
| end_time | 交易完成时间 | String(14) | 格式:YYYYMMDDHH24MISS | 可空 |
| fund_freeze_stat | 资金冻结状态 | String(2) | 02:解冻 | 必填 |
| freeze_time | 冻结时间 | String(14) | 格式:yyyyMMddHHmmss | 必填 |
| unfreeze_amt | 解冻金额 | String(9) | 单位:分 | 必填 |
| unfreeze_time | 解冻时间 | String(14) | 格式:yyyyMMddHHmmss | 必填 |
标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!
返回报文
success
返回报文说明
固定字符串“success”表示接收处理成功,其他表示失败。


