扫码交易退款退票结果查询

API说明：商家调用退款接口未收到状态返回，调用本接口查询退款结果
调用方式：HTTP协议
API编码：shdzfp.smjytktpjgcx
调用方法：POST
数据格式：json

请求报文规范

{
    "taxCode":"销方税号",
    "requestSerialNumber":"退款请求流水号"
}

字段说明

数据项	名称	类型	长度	必须	说明
taxCode	销方税号	varchar	50	是
requestSerialNumber	退款请求流水号	varchar	50	是

返回报文规范

{
    "respCode": "00000000",
    "respDesc": "交易成功",
    "requestTime": "2025-11-25 08:37:47",
    "requestSerialNumber": "退款流水号",
    "transRequestSerialNumber": "需退款交易的流水号",
    "refundFinishTime": "2025-11-25 08:37:48",
    "refundState": "S",
    "refundAmount": "1.00",
    "actualRefAmt": "1.00",
    "remark": "原样返回",
    "bankMessage": "SUCCESS",
    "unconfirmAmt": "1.00",
    "fundFreezeStat": "UNFREEZE",
    "payChannel": "T",
    "tpzt": "S",
    "tpmsg": "",
    "url": "xxxxx"    
}

返回字段说明

数据项	名称	类型	长度	必须	说明
respCode	业务响应码	varchar	8	是	00000000 交易成功 00000100 交易处理中
respDesc	业务响应信息	varchar	512	是
requestTime	请求时间	varchar	19	是	yyyy-MM-dd HH:mm:ss
requestSerialNumber	请求流水号	varchar	50	是	退款流水号，原样返回；示例值：rQ2021121311173944134649875651
transRequestSerialNumber	原交易请求流水号	varchar	50		需退款交易的流水号
refundFinishTime	退款完成时间	varchar	19		yyyy-MM-dd HH:mm:ss
refundState	退款状态	varchar	1		P：处理中、S：成功、F：失败；
refundAmount	退款金额（元）	varchar	14		需保留小数点后两位
actualRefAmt	实际退款金额（元）	varchar	14		需保留小数点后两位
remark	备注	varchar	84		原样返回；示例值：备注
bankMessage	通道返回描述	varchar	256		示例值：SUCCESS
unconfirmAmt	待确认金额	varchar	14		待确认金额；单位元。示例值：1.00
fundFreezeStat	资金冻结状态	varchar	16		FREEZE：冻结；UNFREEZE：解冻；示例值：UNFREEZE，退款发生时，对应原交易的资金冻结状态
payChannel	交易通道	varchar	1		枚举值：A-支付宝、T-微信、U-银联二维码、D-数字货币
tpzt	退票状态	varchar	1		P:退票中 S：成功 F:失败
tpmsg	退票错误信息	varchar	500
url	红票链接	varchar	500

results matching ""

No results matching ""