业务说明

本接口请求方为翼码系统,接收方为商家系统。

支付交易的冻结资金被解冻时,通知商户系统资金解冻结果。

报文格式:JSON

请求方式:POST

Content-Type: application/json;charset=utf-8

签名sign计算规则详见:JSON格式签名计算

注意:标准接口通知报文节点后续会根据需求而做新增,切勿以固定格式解析报文和验签,避免增加节点造成代码报错。

注意:商户接收到通知处理成功后需响应字符串“success”,其他响应翼码系统认为通知失败会继续通知。

注意:同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。

注意:可空节点数据为空时,既可能返回null也可能返回空字符串,请解析时注意兼容。

请求报文

  1. {
  2. "notify_type": "3",
  3. "isspid": "00026713",
  4. "store_id": "S20220927",
  5. "pos_seq": "C20220928X1000000015",
  6. "source": "1",
  7. "pos_id": "S20220927",
  8. "partner_id": "1503490901",
  9. "end_time": "20220928144502",
  10. "fund_freeze_stat": "02",
  11. "freeze_time": "20240915161718",
  12. "unfreeze_amt": "1000",
  13. "unfreeze_time": "20240920121314",
  14. "sign": "7A6B20F1AC3F18FBFC56F4A36CE3207F"
  15. }

请求报文说明

标准接口会因业务升级需要而新增节点,请在解析请求报文时避免新增未知节点产生的程序出错!

节点名称中文名称类型说明是否必填
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”表示接收处理成功,其他表示失败。