B2B电子回单

增值 收单机构 商户 发卡机构 快速接入
为满足B2B商户财务管理等需要,证明相关交易通过银联B2B网银支付完成,银联提供了B2B网银支付交易电子回单功能,并加盖了银联B2B电子回单专用章,供收单机构及商户查询下载。本接口支持收单机构及商户通过后台接口方式,查询及下载获取银联B2B电子回单(PDF文件)。

接入服务商:银联技术开放平台

API ID:376

接口状态:正常

业务申请
暂不支持测试

接口名称

获取token

接口描述

产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。

接口地址

测试地址: https://openapi.unionpay.com/upapi/b2bReceiptProdtest/token


生产地址: https://openapi.unionpay.com/upapi/b2bReceiptProd/token

请求方式

HTTP GET

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥 app_secret string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 获取到的凭证; 凭证是字符串
过期时间 expire_in string M-必填 凭证有效时间,单位:秒

接口名称

电子回单生成接口

接口描述

输入交易信息发起电子回单生成请求

接口地址

测试地址: https://openapi.unionpay.com/upapi/b2bReceiptProdtest/generateElecReceipt


生产地址: https://openapi.unionpay.com/upapi/b2bReceiptProd/generateElecReceipt

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 调用接口凭证
签名信息 sign string M-必填 签名密钥secret
时间戳 ts string M-必填 请求时间戳

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户名 userNm string 40 M-必填 开放平台登陆用户名(必须使用商户服务网站注册的用户名登录开放平台)
商户代码 mchntCd string 15 M-必填 银联分配的15位商户代码,且商户代码与用户名相关联
交易日期 transDt string 8 M-必填 交易日期(yyyyMMdd) 支持下载近一年交易的电子回单
商户订单号 mchntOrderId string 60 M-必填 商户订单号

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填 0000
响应信息 respMsg string 128 M-必填
电子回单编号 receiptId string 32 M-必填 获取电子回单的唯一标识,调用成功时会返回

接口名称

电子回单获取接口

接口描述

查询电子回单是否已生成,如已生成则可下载电子回单

接口地址

测试地址: https://openapi.unionpay.com/upapi/b2bReceiptProdtest/getElecReceipt


生产地址: https://openapi.unionpay.com/upapi/b2bReceiptProd/getElecReceipt

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 调用接口凭证
签名信息 sign string M-必填 签名密钥secret
时间戳 ts string M-必填 请求时间戳

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户名 userNm string 40 M-必填 开放平台登陆用户名(必须使用商户服务网站注册的用户名登录开放平台)
商户代码 mchntCd string 15 M-必填 银联分配的15位商户代码,且商户代码与用户名相关联
电子回单编号 receiptId string 32 M-必填 由电子回单生成接口返回

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填 0000
响应信息 respMsg string 128 M-必填
电子回单文件 receiptPdfFile string 3145728 M-必填 生成的B2B电子回单pdf文件,文件流转化为base64编码的字符串,文件大小控制在3M范围内
产品详情

资费详情: 

本产品推广期内可免费使用。推广期过后的收费标准将提前30个工作日在本平台另行公示。

应用对象

已接入使用银联B2B企业网银支付的收单机构及商户

接入流程

1.如需申请该API,请点击右上角“业务申请”,并认真填写相关内容;

2.待业务接口人审核通过后即可调用该API,审核周期约为2-3个工作日;

3.技术联调,可参照《“快速接入”产品API技术文档—接入指南》


应答码参照:
应答码 描述
0000 处理成功
0001 处理成功,但联机报文中未上送二级商户号
0002 处理成功,但银联系统未配置二级商户收款方信息
1001 请求参数校验不通过
1002 商户代码必须是用户关联的
1003 请求的交易信息不存在
1004 请求的交易信息不唯一
1005 系统异常,请稍后再试
1006 无效的电子回单编号
1007 电子回单生成中,请稍后再试
1008 该笔交易暂不支持获取电子回单
9906 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试
9907 app_id与app_secret验证失败
9908 您的Token已过期,请重新获取Token
9909 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值。
9910 您的签名密钥未设置,请登录银联技术开放平台(open.unionpay.com)确认相关配置
9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联技术开放平台(open.unionpay.com)提供的签名规则。
9912 您的报文格式有误,要求报文符合JSON数据格式
9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求
9914 您的报文无法解密,请检查您在银联技术开放平台(open.unionpay.com)上提供的RSA公钥是否正确。
9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人
9991 银联技术开放平台系统内部错误:产品服务调用失败
9992 银联技术开放平台系统内部错误:产品服务系统未知错误
9993 银联技术开放平台系统内部错误:产品服务未注册至服务中心
9994 银联技术开放平台系统内部错误:产品服务参数错误

1.报文举例-获取产品调用token信息:


请求URL:

 

https://openapi.unionpay.com/upapi/respcode/token?app_id=[value]&app_secret=[value]

 

应答JSON报文体

{
    "token": "",
    "expire_in": 7200
}


2.报文举-电子回单生产接口


请求URL:


https://openapi.unionpay.com/upapi/b2bReceiptProd/generateElecReceipt?token=[token]&sign=[sign]&ts=[ts]


请求报文参数:


{
    "userNm": "test001",
    "mchntCd":"898340183980105",
    "transDt":"20180808",
    "mchntOrderId":"201808080940038782129214114215"
}


应答JSON报文体:


{
    "respCd": "0000",
    "respMsg": "Success",
    "receiptId": "4ad3ff6933cf4f9bb7c6cd1ebc4bfd8b"
}


3.报文举例-电子回单获取接口


请求URL:


https://openapi.unionpay.com/upapi/b2bReceiptProd/getElecReceipt?token=[token]&sign=[sign]&ts=[ts]


请求报文参数:


{
    "userNm": "test001",
    "mchntCd": "898340183980105",  
    "receiptId": "4ad3ff6933cf4f9bb7c6cd1ebc4bfd8b"
}


应答JSON报文体:


{
    "respCd": "0000",
    "respMsg": "Success",
    "receiptPdfFile": "ABCD1234ABCD1234……"
}


1. “快速接入”产品API使用教程请参考在线文档:

“快速接入”产品API指南—接入指南


2. “快速接入”产品API安全调用过程请参考在线文档:

2.1“快速接入”产品API指南—获取产品token

2.2快速接入”产品API指南—产品功能接口调用


3. “快速接入”产品API接口调用报文签名样例请参考在线文档:

“快速接入”产品API指南—报文签名样例代码


4. “快速接入”产品API测试工具使用说明请参考在线文档:

“快速接入”产品API指南—“快速接入”测试工具


咨询我们
业务咨询
姓名: 倪德中
电话: 021-20631629
邮箱: dzni@unionpay.com
技术咨询
姓名: 张昊
电话: 021-20633521
邮箱: zhanghao1@unionpay.com
热门推荐