当前位置: 产品API > 增值 > B2B电子回单
产品介绍
  • 服务对象
    已接入使用银联B2B企业网银支付的收单机构及商户
  • 产品详情

    资费详情: 

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

  • 应用场景

    B2B电子回单可用于B2B商户财务管理、规避交易风险等场景。B2B电子回单不但记载了易详细信息,还加盖了银联电子回单专用章,以确保电子回单的真实性以及可认证性。

应答码参照
应答码列表
  • 应答码 描述 解决方案
    0000 处理成功
    0001 处理成功,但联机报文中未上送二级商户号
    0002 处理成功,但银联系统未配置二级商户收款方信息
    1001 请求参数校验不通过
    1002 商户代码必须是用户关联的
    1003 请求的交易信息不存在
    1004 请求的交易信息不唯一
    1005 系统异常,请稍后再试 展开详情
    1006 无效的电子回单编号
    1007 电子回单生成中,请稍后再试
    1008 该笔交易暂不支持获取电子回单
    1009 暂不支持该交易类型的电子回单
    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.如需申请该API,请点击右上角“业务申请”,并认真填写相关内容;

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

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


报文举例

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指南—“快速接入”测试工具


API接口
获取token
接口描述
产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。
请求方式
GET
生产地址
https://openapi.unionpay.com/upapi/b2bReceiptProd/token
测试地址
https://openapi.unionpay.com/upapi/b2bReceiptProdtest/token
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥 app_secret string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 获取到的凭证; 凭证是字符串
过期时间 expire_in string M-必填 凭证有效时间,单位:秒
电子回单生成接口
接口描述
输入交易信息发起电子回单生成请求
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/b2bReceiptProd/generateElecReceipt
测试地址
https://openapi.unionpay.com/upapi/b2bReceiptProdtest/generateElecReceipt
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“接入指南”板块第3条。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
用户名 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-必填 获取电子回单的唯一标识,调用成功时会返回
电子回单获取接口
接口描述
查询电子回单是否已生成,如已生成则可下载电子回单
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/b2bReceiptProd/getElecReceipt
测试地址
https://openapi.unionpay.com/upapi/b2bReceiptProdtest/getElecReceipt
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“接入指南”板块第3条。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
用户名 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范围内
联系我们

业务咨询: 倪德中

021-20631629

dzni@unionpay.com

技术咨询: 张昊

021-20633521

zhanghao1@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号