业务说明
本接口请求方为翼码系统,接收方为商家系统。
支付交易的冻结资金被解冻时,通知商户系统资金解冻结果。
报文格式: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”表示接收处理成功,其他表示失败。