中国银联开放平台

支持中心

接口列表

区块链电子发票

区块链电子发票

商户管理

发票管理

区块链电子发票

查看产品

更新时间：2023-09-01

发票冲红

接口描述

商户调用此接口申请红票的开具,其流水号对应的数据必须是在区块链平台已经成功生成蓝票的,并且限制冲红数量,一次只能对20张发票进行冲红. 批量冲红会同步返回冲红的发票列表和原因(包含成功和失败).冲红结果以callback_url异步通知

请求方式

POST

生产调用地址

https:// bcinvoice.unionpay.com /invoice/red

测试调用地址

敬请期待

HTTP报文体参数

	中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
	银联开放平台id	accesskey	string			M-必填
	10位unixtimestamp	timestamp	string			M-必填
	随机数	nonce	string			M-必填
	摘要	digest	string			M-必填

同步应答参数

	中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
	状态码	code	string			M-必填	200 业务成功 9999系统异常 1004异常情况
	提示消息	msg	string			M-必填
	业务返回数据	data	map			M-必填

异步应答参数

	中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
	发票校验码	check_code	string	4		M-必填
	返回结果	message	string			M-必填
	通知类型	notify_type	array[map]			M-必填	invoice.blue或者invoice.red
	通知时间	notify_time	string			M-必填	开票商户的税号
	商户交易流水号(由商户维护唯一性)	order_id	string			M-必填
	pdf路径	pdf_url	string			M-必填
	发票代码	ticket_code	string			M-必填
	开票时间	ticket_date	string			M-必填
	发票号码	ticket_sn	string			M-必填
	发票状态	ticket_status	int			M-必填	1开票成功, 2开票失败, 3开票中
	发票税额	ticket_tax_amount	string			M-必填	分为单位
	发票含税总价	ticket_total_amount_has_tax	string			M-必填	分为单位
	发票去税总价	ticket_total_amount_no_tax	string			M-必填	分为单位
	区块链平台交易流水号	up_trade_no	string			M-必填	由平台维护唯一性

示例代码

Java请求代码
Java应答代码

{

"accesskey":"268e22e3-9949-4016-80f8-28298644338d",

"timestamp":"1565603347",

"nonce":"916548",

"digest":"651a6s1d56w4q81f6a31svf6a4dfq9w1d96as65d1a65s1",

"data":{

"callback_url":"http://商户接收地址",

"invoice":[

{

"taxpayer_num":"91310000536000X",

"up_trade_no":"201908091411550909"

},

{

"taxpayer_num":"9131000053600080X",

"up_trade_no":"200000001327144140800020"

}

]

}

}

复制

咨询服务