中国银联开放平台

支持中心

接口列表

扫码缴税

税单查询

税单支付

缴税状态异步通知

交易状态查询

扫码缴税

查看产品

更新时间：2023-09-01

缴税状态异步通知

接口描述

银联在扣款结束会进行税单销账，并将税单销账结果异步通知给接入机构（接入机构可自行选择是否接收）。

请求方式

POST

生产调用地址

https://service.fpsd.unionpay.com/gateway/prod.do

测试调用地址

http://180.169.111.158:8081/gateway/prod.do

HTTP报文体参数

中文名称	英文名称	域类型	域长度	请求要求	备注
应答码	respCd	string	4	M-必填	平台结果码
应答描述	respMsg	string	100	M-必填	平台结果描述
签名	sign	string	1024	M-必填	报文应答签名
商户通知地址	notifyUrl	string	256	M-必填	商户的通知地址
平台流水号	seqId	string	64	M-必填	用于标识平台针对每一笔请求生成的唯一流水号，应答时返回。
版本号	version	string	10	M-必填	调用api接口的版本，默认是 "1.0.0"。如果不是，会在api接口中有特殊说明。
原始交易的api接口id	svcApi	string	100	M-必填	原始交易的api接口id
交易发起时间	timestamp	string	14	R-需要返回	格式固定是"yyyyMMddHHmmss"。
业务应答报文	respContent	string	10240	C-按条件必填	除公共参数外所有业务通知参数都放在这个参数中传递，具体请参照各业务通知参数, 整个respContent中的数据作为一个json字符串来通知。
商户订单号	orderId	string	32	R-需要返回
交易币种	currencyCode	string	3	R-需要返回
交易金额	txnAmt	string	10	R-需要返回
请求方保留域	reqReserved	string	1024	R-需要返回
保留域	reserved	string	1024	O-选填
查询流水号	queryId	string	21	C-按条件必填	供后续查询用
系统跟踪号	traceNo	string	6	C-按条件必填
交易传输时间	traceTime	string	14	C-按条件必填
清算日期	settleDate	string	8	C-按条件必填
清算币种	settleCurrencyCode	string	3	C-按条件必填
清算金额	settleAmt	string	12	C-按条件必填
清算汇率	exchangeRate	string	8	C-按条件必填	交易成功，交易币种和清算币种不一致的时候返回
兑换日期	exchangeDate	string	4	C-按条件必填	交易成功，交易币种和清算币种不一致的时候返回
账单支付状态	billStatus	string	2	M-必填	01：支付中，未销账 02：支付成功，销账成功 03：支付成功，销账中 04：支付失败，未销账 05：支付成功，销账推定成功（销账超时） 06：支付成功，销账联机失败导致支付当日冲正 07：支付成功，销账勾兑失败导致支付跨日退款(后续支持)

同步应答参数

	中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
	应答码	respCd	string	4		M-必填	0000 成功如果不返回该应答或者应答码不为0000，则认定通知受理失败，之后将尝试3次。
	应答消息	respMsg	string	64		M-必填	固定值，请返回“接收通知成功”

示例代码

Java请求代码
Java应答代码

通知请求报文

{

"notifyUrl":"http://180.169.111.158:60006/unionpay/levy/status",

"respCd":"0000",

"respMsg":"成功[0000000]",

"respContent":"{\"billStatus\":\"02\",\"orderId\":\"242004308917144108212\",\"queryId\":\"652004300949241980199\",\"settleAmt\":\"34830\",\"settleDate\":\"20200430\",\"txnAmt\":\"34830\"}",

"seqId":"0455318988205056",

"sign":"E3DLJmke8yeiGKrsRrKMfRJuU+kEUg6C8aHuloOewULdCKipxOFJUT6C4BTj7ZMBhGJwIwmZzGydkFMRZDsembalvdXt94xUrMSH2/PQIbecICMYg5mHY+syLi0rJOCsGM8Z8/tXc64+mzW909+KYgzXhcgV43bidGGm5iTYbqh174IznxDl4/w2tzyYdje45bRmoyNcm83dP5KV4urBIfjzmzxxyRy2GHQAOZ55FWpXyO6HkkOwZ7lbrUBySUYXh0usRa0e+RggPyCyfS6AqdPhDf+rrQ7QvSvKyr7pFvvIETEny2vg5DGns45Nu0Rs0saHCgPCzvl6l1iwA0Iz6w==",

"svcApi":"up.fpsd.trade.acptax.pay",

"timestamp":"20200701105437",

"version":"1.0.0"

}

复制

提示信息

提示