获取云闪付用户的抬头
接口描述
用于服务商或商户在用户授权的情况下获取用户保存在云闪付APP内的的发票抬头列表供用户使用。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/UPinvoice/InvoiceTitleGet
测试调用地址
https://openapi.unionpay.com/upapi/UPinvoiceTest/InvoiceTitleGet
URL请求参数
|
中文名称 |
英文名称 |
域类型 |
域长度 |
默认值 |
请求要求 |
备注 |
|
时间戳 |
ts |
long |
|
|
M-必填
|
|
|
签名信息 |
sign |
string |
|
|
M-必填
|
|
|
扫码快速开票产品token |
token |
string |
|
|
M-必填
|
|
HTTP报文体参数
|
中文名称 |
英文名称 |
域类型 |
域长度 |
默认值 |
请求要求 |
备注 |
|
用户Id |
userId |
string |
|
|
M-必填
|
用户id(页面跳转时会附带该参数,带回即可)
|
|
交易时间 |
transTime |
string |
|
|
M-必填
|
yyyyMMddHHmmss
|
|
版本号 |
version |
string |
|
|
M-必填
|
接口版本号。目前为01
|
|
字符集 |
charset |
string |
|
|
M-必填
|
字符集(UTF-8)
|
|
请求类型 |
transType |
string |
|
|
M-必填
|
请求类型。填写01
|
|
机构Id |
insId |
string |
|
|
M-必填
|
银联分配给机构的id
|
|
请求Id |
requestId |
string |
|
|
M-必填
|
请求流水号,须保证不重,可包含字母和数字
|
同步应答参数
|
中文名称 |
英文名称 |
域类型 |
域长度 |
默认值 |
请求要求 |
备注 |
|
应答报文 |
data |
map |
|
|
M-必填
|
|
|
应答消息 |
respMsg |
string |
|
|
M-必填
|
如果respCd不是0000,该字段解释了具体的出错原因。
|
|
应答码 |
respCd |
string |
|
|
M-必填
|
参考“应答码说明”
|
示例代码
{
"resptCd": "0000",
"data": {
"insId": "000002",
"transType": "01",
"requestId": "12344556",
"titles": [
{
"bankAcct": "216083851810001",
"etpName": "人",
"taxNo": "356345",
"telNo": "18558886745",
"eptAddr": "数字",
"taxPayerBank": "银行"
},
{
"bankAcct": "",
"etpName": "fdg",
"taxNo": "21342134234",
"telNo": "",
"eptAddr": "",
"taxPayerBank": ""
}
],
"version": "01"
},
"respMsg": "处理成功"
}
复制
{
"charset": "UTF-8",
"insId": "000002",
"transTime": "20200331111930",
"transType": "01",
"requestId": "12344556",
"version": "01",
"userId": "1"
}
复制