接口描述
银行使用银行卡信息向银联TSP申请绑卡Token
请求方式
POST
生产调用地址
敬请期待
测试调用地址
敬请期待
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 交易发起方流水号 | transNoSource | string | 26 | M-必填 |
|
||
| 发起方交易时间 | transTimeSource | string | 14 | M-必填 |
|
||
| 绑卡Token期望的域控属性 | tokenDomainControlParams | string | O-选填 |
|
|||
| 持卡人身份信息 | cardHolderInfo | string | O-选填 |
|
|||
| 主账号有效期 | panExpiry | string | 4 | C-按条件必填 |
|
||
| 主账号 | pan | string | 19 | C-按条件必填 |
|
||
| 发卡行的TRID | issuerTrid | string | 11 | M-必填 |
|
||
| 银行入网机构标识码 | issuerId | string | 8 | M-必填 |
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答消息 | resultMessage | string | 200 | M-必填 |
|
||
| 应答码 | resultCode | string | 4 | M-必填 |
|
||
| 交易接收方流水号 | transNoDestination | string | 26 | M-必填 |
|
||
| 交易发起方流水号 | transNoSource | string | 26 | M-必填 |
|
||
| 接收方交易时间 | transTimeDestination | string | 14 | M-必填 |
|
||
| 发起方交易时间 | transTimeSource | string | 14 | M-必填 |
|
||
| Token有效期 | tokenExpiry | string | 4 | C-按条件必填 |
|
||
| Token号 | token | string | 19 | C-按条件必填 |
|
||
| 银行作为银联入网机构的唯一标识码 | issuerId | string | 8 | M-必填 |
|
示例代码
public void tokenApply() {
TokenApplyRequest request = new TokenApplyRequest();
// 交易时间 M
request.setTransTimeSource(new DateTime(System.currentTimeMillis()).toString("yyyyMMddHHmmss"));
// 交易序列号 M
request.setTransNoSource("ABCDEFGHIJKLMNOPQRSTUVWXYZ");
// 接入机构代码 M
request.setIssuerId("03060000");
// 主账号 C 用卡申请Token时上送
request.setPan("6225551640154140");
// 主账号有效期 C 用卡申请Token时上送 4位 YYMM
request.setPanExpiry("3012");
// 机构Trid M
request.setIssuerTrid("62008000004");
// 持卡人身份信息 O
CardHolderInfo cardHolderInfo = new CardHolderInfo();
// 持卡人姓名 O
cardHolderInfo.setCardHolderName("xiaoming");
// 持卡人证件类型 O
cardHolderInfo.setCardHolderIdType("01");
// 持卡人证件号 O
cardHolderInfo.setCardHolderIdNo("230405199003180093");
// 持卡人手机号 O
cardHolderInfo.setMsisdn("18516667788");
request.setCardHolderInfo(cardHolderInfo);
// Token域空参数 O
TokenControlParam tokenControlParam = new TokenControlParam();
// Token有效期 C Token域空参数中必填 4位YYMM
tokenControlParam.setTokenExpiry("2912");
// Token可用次数 C Token域空参数中必填 4位 不足补0
tokenControlParam.setAvailCount("0099");
// Token单笔限额 C Token域空参数中必填 12位 不足补0 精确到分
tokenControlParam.setMaxTransAmount("000000009999");
// Token日累计限额 C Token域空参数中必填 12位 不足补0 精确到分
tokenControlParam.setTotalTransAmount("000000999999");
request.setTokenDomainControlParams(tokenControlParam);
request.validate();
try {
HttpRes httpRes = HttpHelper.post(JsonUtil.serialize(request), "http://172.21.131.120:57049/token_push/issuer/tokenApply");
if (httpRes.getHttpCode() == 200) {
TokenApplyResponse response = JsonUtil.deserialize(httpRes.getHttpBody(), TokenApplyResponse.class);
}
} catch (Exception e) {
e.printStackTrace();
}
}