中国银联开放平台

接口描述

税单支付可由接入机构通过后台向银联平台发起支付交易，根据税单查询得到交易金额等信息，上送支付要素进行扣款与销账，同时在扣款结束后会同步把扣款结果通知给到接入机构。

请求方式

POST

生产调用地址

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

测试调用地址

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

HTTP报文体参数

中文名称	英文名称	域类型	域长度	请求要求	备注
商户id	svcId	string	30	M-必填	接入方的商户代码
接口id	svcApi	string	64	M-必填	接入方调用的api的唯一标识，固定填写"up.fpsd.trade.acptax.pay"
服务商id	serId	string	30	O-选填	接入方的服务商代码；针对缴税业务，serId这个字段请勿上送。
报文格式	format	string	10	O-选填	报文格式，目前仅支持json
编码格式	charset	string	10	O-选填	报文使用的编码格式，目前仅支持utf-8
签名方法	signType	string	10	M-必填	接入方生成签名字符串所使用的签名算法类型，目前仅支持 RSA2、RSA和SM2，推荐使用RSA2
签名	sign	string	1024	M-必填	签名字符串
交易发起时间	timestamp	string	14	M-必填	默认填写当前时间，格式固定是"yyyyMMddHHmmss"。
api版本号	version	string	10	M-必填	调用api接口的版本，默认是 "1.0.0"。如果不是，会在api接口中有特殊说明。
后台通知地址	notifyUrl	string	256	O-选填	后台通知地址
业务请求报文	bizContent	string	10240	M-必填	除公共参数外所有请求参数都必须放在这个参数中传递，具体请参照各业务请求参数。整个bizContent中的数据作为一个json字符串来上送。
渠道类型	channelType	string	2	M-必填	08：移动
商户订单号	orderId	string	32	M-必填
交易币种	currencyCode	string	3	O-选填	交易币种可选上送，默认156
账号类型	accType	string	2	M-必填	01：银行卡 05：Token 默认取值：01
账号	accNo	string	19	M-必填
交易金额	txnAmt	string	10	M-必填	取查询返回的billDetailInfo中amount的值需要以分为单位上传
账单要素	billQueryInfo	string	1024	C-按条件必填	（“账单要素”和“原始交易流水号”至少上送一个）采用json报文，本字段中对data字符串需做BASE64处理，具体格式如下：”flag”:”02”,”data”:”BASE64*” flag： 02 表示传入的是二维码整体的字符串结构 { "flag":"02", "data": { "tips://XXX"//二维码里的全部信息 } }
银行卡验证信息及身份信息	customerInfo	string	1024	M-必填	customerNm =姓名，支持汉字
请求方保留域	reqReserved	string	1024	O-选填	商户自定义保留域，交易应答时会原样返回
保留域	reserved	string	1024	O-选填	08：移动
原始交易流水号	origQryId	string	21	C-按条件必填	上送税单查询交易应答的queryId（“账单要素”和“原始交易流水号”至少上送一个）

同步应答参数

中文名称	英文名称	域类型	域长度	请求要求	备注
应答码	respCd	string	4	M-必填	平台结果码
应答描述	respMsg	string	100	M-必填	平台结果描述
签名	sign	string	1024	M-必填	报文应答签名
平台流水号	seqId	string	64	M-必填	用于标识平台针对每一笔请求生成的唯一流水号，应答时返回。
版本号	version	string	10	R-需要返回	调用api接口的版本，默认是 "1.0.0"。如果不是，会在api接口中有特殊说明。
交易发起时间	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	R-需要返回
查询流水号	queryId	string	21	C-按条件必填
银联订单号	tn	string	21	C-按条件必填	APP商户推送订单后银联移动支付系统返回该流水号，商户调用支付控件时使用
账单支付状态	billStatus	string	2	M-必填	01：支付中，未销账 02：支付成功，销账成功 03：支付成功，销账中 04：支付失败，未销账 05：支付成功，销账推定成功（销账超时） 06：支付成功，销账联机失败导致支付当日冲正 07：支付成功，销账勾兑失败导致支付跨日退款(后续支持)

示例代码

Java请求代码
Java应答代码

请求报文参数

{

"svcId":"00000000001",

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

"timestamp":"20200701105437",

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

"version":"1.0.0",

"bizContent":"{\"accNo\":\"6226090000000048\",\"accType\":\"01\",\"channelType\":\"07\",\"currencyCode\":\"156\",\"customerInfo\":\"P6sXK2+GQmy3KjFRx1oSh5lB97HZL8FimF6Mm4vWsBcWeOzx5Xm6eUiaDAxItg1IuMC3Or8KS0kWOcibq4sxcBpGaqZlobe48yla3z8KtfAV9+qQewANodd5vpeUIctA3HIUn8N46kZxdWCEbS74BcUO5U9nPGVNqIL58SeJMLiUGYrybXgd6i0mMDJbwGUWn+T2eViiJos4Z/bXjbKOPXSZdWofLvQ12u/cftYJ1Rqq2tRD3Bcb9tzdseMfbFUetbCSuqIPBq/1TNtQ2YHpyPAoBguxwiF1sfded9lCQ9acswnXGfUC7csob67+H0X/KkfL4JLyTdTGF6/0mCQjPQ==\",\"orderId\":\"d9bf98a916b3424ca2120fee29f526b2\",\"origQryId\":\"7274050139283228\",\"txnAmt\":\"100\"}", "sign":"U4p4rw2ikPXipVe5dmJwZtdo4Li8Y+jjA8RnKagrhwQHUFDYV7Ow1XAW5hrAJalp3EAVl2DftSXbhyXNGX/2UzZI571lOnWMV8+udFooX3huJk/jK7ABR+aNWhU9CypmMBiLzgkGj6Yc9LBr1Z0mRnfcut5RcODS+oBA2RTGO4tfsXZxBDBeV+ytVIiT/tChhdH7J8PhxevjOIxFRowUoWTnJdgcRaKrBLdc5CgNbiO4lqt/tBA/8w8XaQKA5SyiM1ZgNI7wAoy5ofYGqa6ETZePtt8U/rSgKF2IihiNLTZmPnx4zdWI0+NMc27oooYBuX/YnMh5wzceCHHHv36xRw=="

}

复制

提示信息

提示