# API文档 1.0
# 接口标准
# 协议标准
Triplink提供的接口全部基于https协议,接入方需要根据API规范通过POST协议来调用对应的接口,Triplink接口的报文序列化/反序列化是基于json规范,因此接入方需要在http-header中加入Content-Type= application/json,以保证triplink服务能够正确的识别和处理您的请求
环境 | 服务地址 |
---|---|
测试 | https://openpci.fws.ctripqa.com/restful/soa2/18375/json |
生产-旧 | https://openpci.ctrip.com/restful/soa2/18375/json |
生产-新 | https://coordinate.trip.com/payment-switch-virtualcreditcardservice/api |
注意
生产-旧 地址将于 2023年2月5日 停止服务,请尽快替换成 生产-新 地址。
# 接口类型
接口名称 | 接口地址 | 备注 |
---|---|---|
卡管理接口 | ${服务地址}/operate | ${服务地址} 见上表 |
操作结果查询接口 | ${服务地址}/qOperateResult | ${服务地址} 见上表 |
查询卡/账户接口 | ${服务地址}/qInfo | ${服务地址} 见上表 |
查询卡交易&清算接口 | ${服务地址}/qTransInfo | ${服务地址} 见上表 |
查询卡交易&清算分页接口 | ${服务地址}/qTransInfo | ${服务地址} 见上表 |
争议 | ${服务地址}/chargeback | ${服务地址} 见上表 |
争议查询 | ${服务地址}/chargebackQuery | ${服务地址} 见上表 |
附件上传 | ${服务地址}/upload | ${服务地址} 见上表 |
# 数据标准
币种
虚拟卡产品中涉及到大量的币种,包括开卡币种、结算币种、保证金币种、交易币种等,这些币种都是基于ISO4217标准,一般情况下都是使用3位数字的编码
什么是ISO4217? (opens new window)
国家
虚拟卡产品中的国家是基于ISO3166标准,一般情况下都是3位字母的编码
什么是ISO3166? (opens new window)
# 签名验签
为了保证接口通讯的安全性,Triplink需要接入方提供一个基于RAS算法的公钥(长度可以为1024/2048),接入方在调用Triplink服务的时候需要按照规范将自己的签名传给Triplink,Triplink会通过解析签名来识别正确的商户并防止被非法使用.
签名规则
字符编码: UTF-8
各接口中,可参与签名的字段请参考各接口契约说明。
签名字段组装规则
各参与签名字段的值按接口定义顺序串联在一起,具体参考对应接口的文档说明。
参与签名字段若值为空时不参与签名。
签名算法示例
- SHA256withRSA签名后
- base64输出
- 签名密钥需要去掉(-----BEGIN PRIVATE KEY-----)和(-----END PRIVATE KEY-----)串
# 加密解密
为了保证接口通讯中涉及到PCI数据的安全性,Triplink会对传输卡号/有效期/CVV2的CardInfo字段进行加密,加密算法采用对称算法DES,因此接入方在接入之前会收到Triplink为您分配的密钥
DES算法java实现示例:
# 卡管理
卡管理主要包括虚拟卡的创建、修改、销卡功能,接入方可以根据自己业务流程的特点来使用对应的接口
# 创建卡
# 请求报文
字段名称 | 字段类型 | 必填 | 字段说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | CREATE |
subRequestType | varchar(64) | Y | 请求子类型 | CARD_EXTERNAL |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
cardInfo | CardInfo | Y | 卡信息 | 详见CardInfo参数 |
riskInfo | RiskVerifyInfo | Y | 风控数据 | 详见Riskinfo传参 |
requestSource | varchar(64) | Y | 请求来源标注 | 请求方自定义区分 |
operator | varchar(128) | Y | 操作人 | |
sign | varchar(1024) | Y | 签名信息 | |
reqExtra | Json-String | Y | 扩展域字段 | 请参考“请求扩展域”节点 |
CardInfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
cardProductCode | varchar(3) | N | 卡产品 | 举例:C01;C02;C03;C04;C05 |
sellCurrency | varchar(3) | C | 卖出币种 | 卡产品为C05时生效且必填。 刷卡授权消费时自动将卖出币种兑换为结算币种。 |
quoteId | varchar(64) | C | 汇率ID | 卡产品为C05时生效。 查询汇率接口返回的汇率ID。 若有效则以此汇率兑换,若无效则以实时汇率兑换。 |
localCurrency | varchar(3) | Y | 开卡币种 | |
billCurrency | varchar(3) | Y | 结算币种 | |
startActiveDate | varchar(10) | Y | 卡生效日期 | yyyy-MM-dd |
endCloseDate | varchar(10) | Y | 最晚关卡日期 | yyyy-MM-dd |
creditLimitAmt | decimal(18,6) | Y | 卡当前额度 | |
minAuthAmt | decimal(18,6) | Y | 最低可扣款金额 | (预付费卡,此字段不生效) |
maxAuthAmt | decimal(18,6) | Y | 最高可扣款金额 | (预付费卡,此字段不生效) |
enableMutilUse | varchar(1) | Y | 是否可多次使用 | 1:多次使用 0:单次使用 |
closePercentage | int | Y | 自动关卡百分比 | [0-100] 0=不自动销卡 (预付费卡,此字段不生效) |
merchantControlMethod | varchar(8) | N | 商户控制方式 | 0:指定商户号 4:指定商户mcc组名; |
merchantCategoryName | varchar(128) | N | MCC类别 | 由TripLink分配 |
merchantCode | varchar(128) | N | 商户号 | |
enaleCVVCheck | varchar(8) | Y | 是否检验CVV | 0:不开启(默认) 1:开启验证 |
enableCurrencyCheck | varchar(8) | Y | 是否启用交易币种验证 | 0:不限制交易币种(默认) 1:只允许使用开卡币种交易 |
allow3ds | boolean | N | 是否接受3DS交易 | 默认 true。 (仅香港万事达卡生效) |
cardLabel | varchar(10) | N | 卡组 | MasterCard:万事达 VISA:VISA |
timeZone | varchar(10) | N | 卡时区 | 卡生效与失效日期时区,格式举例: 中国标准时间 GMT+08:00, 北美东部标准时间 GMT-05:00。 |
userDefineInfo | Json-String | Y | 用户自定义字段 |
自定义字段一般用来给接入方传入自定义的数据,其中Key的名称可以联系TripLink技术设定,这些数据可以在交易流水报表中展示,这样可以方便用来对账,比较典型的案例是接入方传入订单号,在交易流水报表中就会自动关联订单号和交易。
Riskinfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
riskOrderId | varchar(64) | N | 订单号 | 携程内部使用 |
riskIssueBillId | varchar(64) | N | 出票单号 | 订单为携程订单时 传入携程出票单号 |
riskOrderType | varchar(32) | Y | 订单类型 | 见风控订单类型枚举 |
riskOrderTitle | varchar(128) | N | 产品名称 | 机票写路线 酒店写酒店名称 |
riskOrderGuestName | varchar(64) | N | 订单使用人姓名 | 机票乘机人姓名 酒店入住人姓名 |
riskOrderActiveDate | varchar(16) | N | 订单生效日期 | 机票起飞日期 酒店入住日期 |
riskOrderExpiryDate | varchar(16) | N | 订单失效日期 | 酒店离店日期 机票落地日期 |
riskOrderCNYAmount | varchar(16) | N | 订单人名币金额 | |
riskOrderSourceSys | varchar(32) | N | 订单源系统 | 服务方分配 |
riskOrderSettleTp | varchar(32) | N | 订单结算方式 | 0:单结 1:批结 |
riskOrderSupplierCd | varchar(8) | N | 订单供应商编码 | 支付系统里的MerchantNo |
riskOrderSupplierNm | varchar(64) | N | 订单供应商名称 | |
riskUID | varchar(64) | N | 调用方UID | |
riskContactName | varchar(32) | N | 调用方联系人 | 客户自定义 |
riskContactEmail | varchar(32) | N | 调用方联系邮箱 | 客户自定义 |
riskContactPhoneNo | varchar(32) | N | 调用方联系手机号 | 客户自定义 |
riskExtra | json-string | N | 风控扩展数据 | 机票航班号 |
签名生成规则
签名字段:
requestId,requestTime,requestType,subRequestType,merchantName,channelType,cardLogId,localCurrency,billCurrency,startActiveDate,endCloseDate,creditLimitAmt,minAuthAmt,maxAuthAmt
请求报文示例:
{
"requestId": "create20210803121000001",
"requestTime": "20210803121050",
"requestType": "CREATE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"localCurrency": "USD",
"billCurrency": "USD",
"startActiveDate": "2021-08-03",
"endCloseDate": "2023-08-03",
"creditLimitAmt": 1200,
"minAuthAmt": 0,
"maxAuthAmt": 1200,
"enableMutilUse": "1",
"closePercentage": 100,
"merchantCategoryName": "0011",
"enaleCVVCheck": "0",
"userDefineInfo": "{\"BookingNumber\":\"0d4a88ac-690f-7123-4930-17a831c41a49\"}"
},
"requestSource": "goldenwater",
"operator": "max",
"sign": "HPT7k0fDhaorGRuswGPylcQPujs3z3SLgnJINtm7JfTorLvMxkd3BOD+HPjaNhtCRe975CzVFi+YQ5TNt9Ms2FuvL3t/pwGYsZmqUY5Xxrq5o+hmEYboDkz/dCWkxoLj5MPqgxAuTvk3MN+Q/k5YiKLKR9p8DwSxTT5JRrutCls="
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
如上请求数据,按照各接口签名规则,组装要进行签名的数据如下:
20200211TestS0320200207122334CREATECARD_EXTERNALRTP_TESTCFNC_VCCUSDUSD2020-02-232020-12-27100.23000100.2300
SHA-256签名后的数据:
WXbw9wohLddKF9fXgI3TfBZ3pnJzKflwBHGpdU+dF/aJ1Fzq6NJxkWH+FB+7CE2tKKI43Eer9SQqGQ6sI7E8AvgoP4uEozSkJwudR/qm0xnb45hsuUuJb6RC2yTRyrTdhZBuVhRzLW3m+MOdSsbIGkfcHXPlTSNbdIFc360au9A=
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(64) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
ccOpId | varchar(64) | 服务方生成的唯一流水号 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
respExtra | json-String | 响应扩展数据 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(32) | 卡片唯一标识 | |
cardNo | varchar(32) | 卡号 | 如果使用端需要,会进行DES加密 |
cardVerifyNo | varchar(32) | 卡安全验证码CVV(3位) | 如果使用端需要,会进行DES加密 |
cardExpiryDate | varchar(32) | 卡有效期(yyyyMM) | 如果使用端需要,会进行DES加密 |
cardLabel | varchar(10) | 卡组 | MasterCard:万事达 VISA:VISA |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627963826974+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "9195148303876440602"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b392-452212-1034"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "00000",
"resultRespMsg": "SUCCESS",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"ccOpId": "CC20210803121026042021_08293188",
"requestId": "create20210803121000001",
"requestTime": "20210803121050",
"requestType": "CREATE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458",
"cardNo": "pASRBm6uMKPaaW8uioXeaNXoPvKHr39V",
"cardVerifyNo": "au7pLmVvbFE=",
"cardExpiryDate": "qX6/UOJUmbg=",
"cardLabel": "MasterCard",
"billCurrency": "USD"
},
"respExtra": "{\"CreateTransId\":\"APPD4C25C10D28E4\"}"
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# 修改卡
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | UPDATE |
subRequestType | varchar(64) | Y | 请求子类型 | CARD_EXTERNAL |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
cardInfo | CardInfo | Y | 卡信息 | |
requestSource | varchar(64) | Y | 请求来源标注 | 请求方自定义区分 |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
sign | varchar(1024) | Y | 签名 | |
reqExtra | Json-String | N | 扩展域字段 | 请参考“请求扩展域”节点 |
CardInfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
cardLogId | varchar(64) | Y | 卡片唯一标识 | 申卡后返回的唯一标识 |
startActiveDate | varchar(32) | N | 卡生效日期 | yyyy-MM-dd |
endCloseDate | varchar(32) | N | 最晚关卡日期 | yyyy-MM-dd |
creditLimitAmt | decimal(18,6) | N | 卡当前额度 | 调用更新卡不可把额度调整为0 (预付费卡,此字段不生效) |
minAuthAmt | decimal(18,6) | N | 卡最低可扣款金额 | (预付费卡,此字段不生效) |
maxAuthAmt | decimal(18,6) | N | 卡最高可扣款金额 | (预付费卡,此字段不生效) |
closePercentage | int | N | 关卡百分比 | [0-100] 0=不自动销卡 (预付费卡,此字段不生效) |
merchantControlMethod | varchar(8) | N | 商户控制方式 | 0:指定商户号 4:指定商户mcc组名; |
merchantCategoryName | varchar(128) | N | MCC类别 | |
merchantCode | varchar(128) | N | 商户号 | |
enaleCVVCheck | varchar(8) | N | 是否检验CVV | |
enableCurrencyCheck | varchar(1) | N | 是否启用交易币种验证 | 0:不限制交易币种(默认) 1:只允许使用开卡币种交易 |
allow3ds | boolean | N | 是否接受3DS交易 | (仅香港万事达卡生效) |
timeZone | varchar(10) | N | 卡时区 | 卡生效与失效日期时区,格式举例: 中国标准时间 GMT+08:00, 北美东部标准时间 GMT-05:00。 |
userDefineInfo | Json-string | N | 用户自定义字段 |
请求报文示例:
{
"requestId": "update20210803121600001",
"requestTime": "20210803121650",
"requestType": "UPDATE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458",
"startActiveDate": "2021-07-28",
"endCloseDate": "2023-07-28",
"creditLimitAmt": 3200,
"minAuthAmt": 0,
"maxAuthAmt": 3200,
"closePercentage": 90,
"merchantCategoryName": "0011",
"enaleCVVCheck": "0",
"enableCurrencyCheck": "0",
"userDefineInfo": "{\"BookingNumber\":\"0d4a88ac-690f-7123-4930-17a831c41a49\"}"
},
"requestSource": "goldenwater",
"operator": "max",
"sign": "Mq8LsGdUUC8Ym1oWNarEm9aTRkJBtvnNzYy70pXVcKNkhQGLqH0ePHuM83JVgA9k8cCE2rcxvmu+rpJwtxphcb811Q/BEWaYe7XLHMHOU5k9tZti09NM844GCEy9nt/u7GU6nM6dELm6VL4m0fs0NtIVMmq1/LWQwnxc1hTbLI8="
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(32) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
ccOpId | varchar(64) | 服务方生成的唯一流水号 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
respExtra | json-String | 响应扩展数据 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(32) | 卡片唯一标识 | |
cardNo | varchar(32) | 卡号 | 如果使用端需要,会进行DES加密 |
cardVerifyNo | varchar(32) | 卡安全验证码CVV(3位) | 如果使用端需要,会进行DES加密 |
cardExpiryDate | varchar(32) | 卡有效期(yyyyMM) | 如果使用端需要,会进行DES加密 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627964226434+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "2954030970005012173"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b392-452212-1619"
}]
},
"resultstatus": "FAILURE",
"resultRespCode": "100000",
"resultRespMsg": "Illegal activeDate, input activeDate is earlier than the present date",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"ccOpId": "CC20210803121705082021_08917719",
"requestId": "update20210803121600001",
"requestTime": "20210803121650",
"requestType": "UPDATE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI"
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 充值卡
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | RECHARGE |
subRequestType | varchar(64) | Y | 请求子类型 | CARD_EXTERNAL |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
cardInfo | CardInfo | Y | 卡信息 | |
requestSource | varchar(64) | Y | 请求来源标注 | 请求方自定义区分 |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
sign | varchar(1024) | Y | 签名 |
CardInfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
cardLogId | varchar(64) | Y | 卡片唯一标识 | 申卡后返回的唯一标识 |
willChangeAmt | decimal(18,6) | Y | 充值金额 | 必须大于0 |
请求报文示例:
{
"requestId": "recharge20210803122300001",
"requestTime": "20210803122450",
"requestType": "RECHARGE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458",
"willChangeAmt":100
},
"requestSource": "goldenwater",
"operator": "max",
"sign": "OV3NbHOUTvTqCz94GapqKMhLmtPewsynww0340PEeYlteIzt4+3aSpcoc9ntwbAwHQJDE4JtAQak61VW7GHiQ2Zk7QvxFN6xsbVbcNDULb2CO0OQE0skzP2MiUr4+xwVamZU7/C+5KE5xx9mel4k5axAEznFyVF4INrfH6cpki8="
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(32) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
ccOpId | varchar(64) | 服务方生成的唯一流水号 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
respExtra | json-String | 响应扩展数据 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(32) | 卡片唯一标识 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627964650495+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "4091085982072640217"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-2279"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "00000",
"resultRespMsg": "SUCCESS",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"ccOpId": "CC20210803122410022021_08137348",
"requestId": "recharge20210803122300001",
"requestTime": "20210803122450",
"requestType": "RECHARGE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 提现卡
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | WITHDRAW |
subRequestType | varchar(64) | Y | 请求子类型 | CARD_EXTERNAL |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
cardInfo | CardInfo | Y | 卡信息 | |
requestSource | varchar(64) | Y | 请求来源标注 | 请求方自定义区分 |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
sign | varchar(1024) | Y | 签名 |
CardInfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
cardLogId | varchar(64) | Y | 卡片唯一标识 | 申卡后返回的唯一标识 |
willChangeAmt | decimal(18,6) | Y | 提现金额 | 必须大于0 |
请求报文示例:
{
"requestId": "withdraw20210803122300001",
"requestTime": "20210803122450",
"requestType": "WITHDRAW",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458",
"willChangeAmt":100
},
"requestSource": "goldenwater",
"operator": "max",
"sign": "OV3NbHOUTvTqCz94GapqKMhLmtPewsynww0340PEeYlteIzt4+3aSpcoc9ntwbAwHQJDE4JtAQak61VW7GHiQ2Zk7QvxFN6xsbVbcNDULb2CO0OQE0skzP2MiUr4+xwVamZU7/C+5KE5xx9mel4k5axAEznFyVF4INrfH6cpki8="
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(32) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
ccOpId | varchar(64) | 服务方生成的唯一流水号 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
respExtra | json-String | 响应扩展数据 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(32) | 卡片唯一标识 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627964650495+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "4091085982072640217"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-2279"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "00000",
"resultRespMsg": "SUCCESS",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"ccOpId": "CC20210803122410022021_08137348",
"requestId": "withdraw20210803122300001",
"requestTime": "20210803122450",
"requestType": "WITHDRAW",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 锁定卡
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | SUSPEND |
subRequestType | varchar(64) | Y | 请求子类型 | CARD_EXTERNAL |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
cardInfo | CardInfo | Y | 卡信息 | |
requestSource | varchar(64) | Y | 请求来源标注 | 请求方自定义区分 |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
sign | varchar(1024) | Y | 签名 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(32) | 卡片唯一标识 |
请求报文示例:
{
"requestId": "suspend2021030201111233",
"requestTime": "20220306230850",
"requestType": "SUSPEND",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
},
"requestSource": "goldenwater",
"operator": "max",
"sign": "EW4foR+0xcXwXbSbCHLYdaUsQepKbp8JUt8mPDymtvgTmlLl/Ty1g0Os0PoIGP1AfAwJFk445jsD7LzoO04P5MOKECIaENwN7MSuKBhkfpgzvpRYJ98nnSca5fMaprqABITSlA20XfPC1Ri8jfRBhAQOYDfOAHzSvS7YHIb4lJA="
}
2
3
4
5
6
7
8
9
10
11
12
13
14
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(32) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
ccOpId | varchar(64) | 服务方生成的唯一流水号 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
respExtra | json-String | 响应扩展数据 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(32) | 卡片唯一标识 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627964650495+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "4091085982072640217"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-2279"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "00000",
"resultRespMsg": "SUCCESS",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"ccOpId": "CC20220306122410022021_08137348",
"requestId": "suspend2021030201111233",
"requestTime": "20220306230850",
"requestType": "SUSPEND",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 解锁卡
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | UNSUSPEND |
subRequestType | varchar(64) | Y | 请求子类型 | CARD_EXTERNAL |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
cardInfo | CardInfo | Y | 卡信息 | |
requestSource | varchar(64) | Y | 请求来源标注 | 请求方自定义区分 |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
sign | varchar(1024) | Y | 签名 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(32) | 卡片唯一标识 |
请求报文示例:
{
"requestId": "unsuspend2022030601111233",
"requestTime": "20220306230850",
"requestType": "UNSUSPEND",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
},
"requestSource": "goldenwater",
"operator": "max",
"sign": "o9sDTOiTbUbe5S14vYaUz9eykK46mCKZ/7jEJP3xIPp/lNu8YW2A6JrnHXZHD9wK7ZSHWozqJk515tUk+yruKlDaI787NWT4p4SbcZ7kALVY02PhW5CZ6m4UPueJlF2d5igfIOSQJ1H+3djhXZ4MLDEZwWO0wqyKg4DqmXzkSaE="
}
2
3
4
5
6
7
8
9
10
11
12
13
14
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(32) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
ccOpId | varchar(64) | 服务方生成的唯一流水号 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
respExtra | json-String | 响应扩展数据 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(32) | 卡片唯一标识 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627964650495+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "4091085982072640217"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-2279"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "00000",
"resultRespMsg": "SUCCESS",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"ccOpId": "CC20220306122410022021_08137348",
"requestId": "unsuspend2022030601111233",
"requestTime": "20220306230850",
"requestType": "UNSUSPEND",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 注销卡
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | CLOSE |
subRequestType | varchar(64) | Y | 请求子类型 | CARD_EXTERNAL |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
cardInfo | CardInfo | Y | 卡信息 | |
requestSource | varchar(64) | Y | 请求来源标注 | 请求方自定义区分 |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
sign | varchar(1024) | Y | 签名 |
CardInfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
cardLogId | varchar(64) | Y | 卡片唯一标识 | 申卡后返回的唯一标识 |
请求报文示例:
{
"requestId": "close20210803122300001",
"requestTime": "20210803122450",
"requestType": "CLOSE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
},
"requestSource": "goldenwater",
"operator": "max",
"sign": "OV3NbHOUTvTqCz94GapqKMhLmtPewsynww0340PEeYlteIzt4+3aSpcoc9ntwbAwHQJDE4JtAQak61VW7GHiQ2Zk7QvxFN6xsbVbcNDULb2CO0OQE0skzP2MiUr4+xwVamZU7/C+5KE5xx9mel4k5axAEznFyVF4INrfH6cpki8="
}
2
3
4
5
6
7
8
9
10
11
12
13
14
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(32) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
ccOpId | varchar(64) | 服务方生成的唯一流水号 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
respExtra | json-String | 响应扩展数据 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(32) | 卡片唯一标识 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627964650495+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "4091085982072640217"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-2279"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "00000",
"resultRespMsg": "SUCCESS",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"ccOpId": "CC20210803122410022021_08137348",
"requestId": "close20210803122300001",
"requestTime": "20210803122450",
"requestType": "CLOSE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 扩展域字段
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
BinFlagDrec | string | 直接传递的bin指定标签 | TripLink枚举值: GWTTP GWTTP-MBA GWTTP-MBG GWTTP-MBH GWTTP-MBI GWTTP-MBJ MCO |
BinRangeId | string | 卡bin范围标记id | 请联系TripLink运营团队 |
AcquirerId | string | 刷卡收单行Id | 如果赋值,则限制该卡片只能在指定收单行使用,其他收单行授权会被拒绝。 |
# 查询操作结果
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 原操作请求流水号 requestId |
requestTime | varchar(14) | Y | 请求时间 | 原操作请求时间 requestTime |
requestType | varchar(64) | Y | 请求类型 | 原操作请求类型 requestType |
subRequestType | varchar(64) | Y | 子请求类型 | 原操作子请求类型 subRequestType |
merchantName | varchar(32) | Y | 请求商户 | 原操作商户名称 merchantName |
sign | varchar | Y | 签名信息 | |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
签名生成规则
签名字段:requestId,requestTime,requestType,subRequestType,merchantName
请求报文示例:
{
"requestId": "create20210803121000001",
"requestTime": "20210803121050",
"requestType": "CREATE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"sign": "DMPuMQ8GmmuEbURBkqa6AnedmGZM817pa6RteTlmi9r5ovwLCJmIiavAIDKUF5FMV2ot5WQQ3ADvylHAOY2LroBmdlZt9fw7pC7Wusc4jpkEScVmm4uk6ypYVOXNJyGiMwlWoyjeZq5ZReDXdaH1eY1vvOoyS4MQWZmoz0BP22I=",
"operator": "max"
}
2
3
4
5
6
7
8
9
# 响应报文
inquireResultStatus:表示本查询接口的结果不是要查询数据的结果,要查询数据的结果由resultStatus体现,只有inquireResultStatus= SUCCEED时,resultStatus才有具体结果数据返回。
resultStatus:表示要查询的数据的结果。
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(256) | 结果状态 | PROCESS:处理中 SUCCEED:成功 FAILURE:失败 |
resultCode | varchar(64) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
ccOpId | varchar(64) | 服务方生成的唯一流水号 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
respExtra | json-String | 响应扩展数据 |
CardInfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
cardLogId | varchar(64) | Y | 卡片唯一标识 | |
cardNo | varchar(128) | Y | 卡号 | 如果使用端需要,会进行DES加密 |
cardVerifyNo | varchar(128) | Y | 卡安全验证码CVV2 | 如果使用端需要,会进行DES加密 |
cardExpiryDate | varchar(128) | Y | 卡有效期(yyyyMM) | 如果使用端需要,会进行DES加密 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627964549893+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "1507684976517647531"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-2128"
}]
},
"qResultStatus": "SUCCEED",
"qResultCode": "CCS000000",
"qResultMsg": "SUCCESS",
"resultstatus": "SUCCEED",
"resultRespCode": "00000",
"resultRespMsg": "SUCCESS",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"ccOpId": "CC20210803121026042021_08293188",
"requestId": "create20210803121000001",
"requestTime": "20210803121050",
"requestType": "CREATE",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458",
"cardNo": "pASRBm6uMKPaaW8uioXeaNXoPvKHr39V",
"cardVerifyNo": "au7pLmVvbFE=",
"cardExpiryDate": "qX6/UOJUmbg=",
"localCurrency": "USD",
"billCurrency": "USD",
"startActiveDate": "2021-08-03",
"endCloseDate": "2023-08-03",
"creditLimitAmt": 1200,
"minAuthAmt": 0,
"maxAuthAmt": 1200,
"balanceAmt": 1200,
"totalAuthAmt": 0,
"totalSettleAmt": 0,
"totalRefundAmt": 0,
"netSettleAmt": 0,
"outStandingAuthAmt": 0,
"enableMutilUse": "1",
"closePercentage": 100,
"merchantCategoryName": "0011",
"enaleCVVCheck": "0",
"enableCurrencyCheck": "0",
"cardStatus": "OPEN",
"userDefineInfo": "{\"BookingNumber\":\"0d4a88ac-690f-7123-4930-17a831c41a49\"}"
},
"respExtra": "{\"BinFlagDrec\":\"GWTTP\",\"CreateTransId\":\"APPD4C25C10D28E4\",\"NetSettleAmt\":\"0\",\"OutstandingAuthAmt\":\"0\"}"
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
# 查询卡信息
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | GET |
subRequestType | varchar(64) | Y | 请求子类型 | CARD_EXTERNAL |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
cardInfo | CardInfo | Y | 卡信息 | |
sign | varchar | Y | 签名信息 | |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
请求报文示例:
{
"requestId": "card20210803121800002",
"requestTime": "20210803121850",
"requestType": "GET",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
},
"sign": "Yxy1DS4vcR11sO5ry6OQf66tTiS51G+OqPdN4nmaWIr/ej/qTeeiKiTV8E9l9EECD3vuyT7lS3E3AuZzNsMvfyEgKUUz76QJGEYu0BDqlTq9LEpCRfVdvjxrrS6IgpF08mt83HFsxqQEcUs+0XCBic5FofIBT1wR0Y6PMAxwg4Q=",
"operator": "max"
}
2
3
4
5
6
7
8
9
10
11
12
CardInfo
字段名称 | 数据类型 | 长度 | 必填 | 说明 | 备注 |
---|---|---|---|---|---|
cardLogId | varchar | Y | 卡片唯一标识 |
签名生成规则
签名字段:requestId,requestTime,requestType,subRequestType,merchantName,channelType,cardLogId
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(64) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 |
CardInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
cardLogId | varchar(64) | 卡片唯一标识 | |
cardNo | varchar(128) | 卡号 | 如果使用端需要,会进行DES加密 |
cardVerifyNo | varchar(128) | CVV2 | 如果使用端需要,会进行DES加密 |
cardExpiryDate | varchar(128) | 卡有效期(yyyyMM) | 如果使用端需要,会进行DES加密 |
cardFullExpiryDate | varchar(6) | 卡具体失效日期 | yyyy-MM-dd |
localCurrency | varchar(3) | 开卡币种 | |
billCurrency | varchar(3) | 结算币种 | 还款币种 |
startActivateDate | varchar(32) | 卡生效日期 | yyyyMMdd |
endClosedDate | varchar(32) | 最晚关卡日期 | yyyyMMdd |
creditLimitAmt | decimal(18,6) | 卡额度 | |
minAuthAmt | decimal(18,6) | 卡最低可扣款金额 | (预付费卡,此字段不生效) |
maxAuthAmt | decimal(18,6) | 卡最高可扣款金额 | (预付费卡,此字段不生效) |
balanceAmt | decimal(18,6) | 卡余额 | |
totalAuthAmt | decimal(18,6) | 卡总授权金额 | 卡待入账金额 |
totalSettleAmt | decimal(18,6) | 卡总清算金额 | 卡已入账金额 |
totalRefundAmt | decimal(18,6) | 卡总退款金额 | |
netSettleAmt | decimal(18,6) | 减去退款金额后的实际结算金额 | 已作废 值恒为0 |
outStandingAuthAmt | decimal(18,6) | 未结算的授权金额 | 同 totalAuthAmt |
enableMutilUse | varchar(8) | 是否可多次使用 | 1:多次使用; 0:单次使用 |
closePercentage | int | 自动关卡百分数设定 | [0-100] (预付费卡,此字段不生效) |
merchantControlMethod | varchar(8) | 商户控制方式 | 0:指定商户号 4:指定商户mcc组名 |
merchantCategoryName | varchar(128) | MCC类别 | 由TripLink分配 |
merchantCode | varchar(128) | 商户号 | |
enaleCVVCheck | varchar(8) | 是否启用CVV检验 | 0:不开启 1:开启验证<默认> |
enableCurrencyCheck | varchar(8) | 是否启用交易币种验证 | 0:不限制交易币种<默认> 1:只允许开卡币种作为交易币种 |
allow3ds | boolean | 是否接受3DS交易 | 仅香港万事达卡生效 |
cardStatus | varchar(64) | 卡状态 | CLOSED:预销卡 EXPIRED:销卡 OPEN:正常 |
cardLabel | varchar(10) | 卡组 | MasterCard:万事达 VISA:VISA |
timeZone | varchar(10) | 卡时区 | 卡生效与失效日期时区,格式举例: 中国标准时间 GMT+08:00, 北美东部标准时间 GMT-05:00。 |
userDefineInfo | Json | 用户自定义信息 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627964310646+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "4171357456080389964"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b392-452212-1743"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "CCS000000",
"resultRespMsg": "SUCCESS",
"requestId": "card20210803121800002",
"requestTime": "20210803121850",
"requestType": "GET",
"subRequestType": "CARD_EXTERNAL",
"merchantName": "WANWEI",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458",
"cardNo": "pASRBm6uMKPaaW8uioXeaNXoPvKHr39V",
"cardVerifyNo": "au7pLmVvbFE=",
"cardExpiryDate": "qX6/UOJUmbg=",
"localCurrency": "USD",
"billCurrency": "USD",
"startActiveDate": "2021-08-03",
"endCloseDate": "2023-08-03",
"creditLimitAmt": 1200,
"minAuthAmt": 0,
"maxAuthAmt": 1200,
"balanceAmt": 1200,
"totalAuthAmt": 0,
"totalSettleAmt": 0,
"totalRefundAmt": 0,
"netSettleAmt": 0,
"outStandingAuthAmt": 0,
"enableMutilUse": "1",
"closePercentage": 100,
"merchantCategoryName": "0011",
"enaleCVVCheck": "0",
"enableCurrencyCheck": "0",
"allow3ds": true,
"cardStatus": "OPEN",
"cardLabel": "MasterCard",
"userDefineInfo": "{\"BookingNumber\":\"0d4a88ac-690f-7123-4930-17a831c41a49\"}"
},
"respExtra": "{\"CreateTransId\":\"APPD4C25C10D28E4\",\"BinFlagDrec\":\"GWTTP\",\"NetSettleAmt\":\"0\",\"OutstandingAuthAmt\":\"0\"}"
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# 查询账户信息(旧)
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | GET |
subRequestType | varchar(64) | Y | 请求子类型 | MERCHANT_INFO |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
cardInfo | CardInfo | Y | 卡信息 | |
sign | json-string | Y | 签名信息 | |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
CardInfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
cardLogId | varchar(64) | Y | 卡片唯一编码 | 申卡后返回的唯一标识 |
签名生成规则
签名字段:requestId,requestTime,requestType,subRequestType,merchantName,channelType,cardLogId
请求报文示例:
{
"requestId": "merchant20210803121900002",
"requestTime": "20210803121950",
"requestType": "GET",
"subRequestType": "MERCHANT_INFO",
"merchantName": "WANWEI",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
},
"sign": "jHzu1sv61KxRhe7DvpK6MuXt0qN5dJAMG7CpPyEgMLJEV8v3rQToe/hMdkHtF8IsltEvrFpl7YlflWlpvyNIC0MsNBOrSY9AQwpKfekvWV/1IWbeaCxtLyQoYdJyjdyDS89/xrIAwrTzytrCpvPy3f6EnQd9l5D9hNXkHvS2pdA=",
"operator": "max"
}
2
3
4
5
6
7
8
9
10
11
12
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(64) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
merchantInfo | json-String | 客户信息 |
MerchantInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
merchantName | varchar(64) | 商户名称 | |
channelInfos | json-String | 账户信息 |
ChannelInfos
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
channelInfos | varchar(64) | 账户信息 | |
channelType | varchar(128) | 发卡通道类型 | |
channelCardCreditLimitAmt | varchar(6) | 商户卡片总额度 | |
channelRemainCardCreditLimitAmt | varchar(32) | 商户卡片剩余总额度 | |
channelAuthLimitAmt | varchar(64) | 商户授信总额度 | 即为授信额度 |
channelRemainAuthLimitAmt | varchar(3) | 商户授信剩余总额度 | 即为剩余的授信额度 |
channelCurrencyCodeOfLimitAmt | varchar(3) | 商户授信币种 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1627964389494+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "8058371410174658946"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-1851"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "CCS000000",
"resultRespMsg": "SUCCESS",
"requestId": "merchant20210803121900002",
"requestTime": "20210803121950",
"requestType": "GET",
"subRequestType": "MERCHANT_INFO",
"merchantName": "WANWEI",
"merchantInfo": {
"merchantName": "WANWEI",
"isSaveCard": "0",
"isEncrypt": "1",
"channelInfos": [{
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"channelCardCreditLimitAmt": "9999999999999",
"channelRemainCardCreditLimitAmt": "9999999999999",
"channelAuthLimitAmt": "10000000",
"channelRemainAuthLimitAmt": "9999825.69",
"channelCurrencyCodeOfLimitAmt": "USD"
}]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# 查询账户信息(新)
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | GET |
subRequestType | varchar(64) | Y | 请求子类型 | ACCOUNT_INFO |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
sign | json-string | Y | 签名信息 | |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
签名生成规则
签名字段:requestId,requestTime,requestType,subRequestType,merchantName,channelType,cardLogId
请求报文示例:
{
"requestId": "account20220111",
"requestTime": "20220111170850",
"requestType": "GET",
"subRequestType": "ACCOUNT_INFO",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"sign": "M8ZlelAZTPYHTGLn54jVHyE9asRWmet4VGoOzXPLMpj7zlO2qOaQlAZpyvtazNezUpBaCMhbMD1xIW1U9QaggPOmUSzMtYe+X7RICzLsd/E6sgTIMduATVn9W5iSMSEFCaeyTd7Sm6GbwZE6V7b0vP//bSasMo5idI/uPkk3bwU=",
"operator": "max"
}
2
3
4
5
6
7
8
9
10
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(64) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
merchantInfo | MerchantInfo | 客户信息 |
MerchantInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
merchantName | varchar(64) | 商户名称 | |
accountInfos | list(AccountInfo) | 账户信息 |
AccountInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
accountType | varchar(8) | 账户类型 | CREDIT:贷记账户,DEBIT:借记账户,CCP_ACCT:换汇账户 |
accountCurrency | varchar(32) | 账户币种 | ISO 4217 货币代码,3位字母 |
accountAmount | varchar(32) | 账户额度 | 仅账户类型为CREDIT时有值,小数 |
remainAccountAmount | varchar(3) | 剩余账户额度 | 小数 |
响应报文示例:
{
"ResponseStatus": {
"Timestamp": "/Date(1641899612203+0800)/",
"Ack": "Success",
"Errors": []
},
"resultstatus": "SUCCEED",
"resultRespCode": "CCS000000",
"resultRespMsg": "SUCCESS",
"requestId": "account20220111",
"requestTime": "20220111170850",
"requestType": "GET",
"subRequestType": "ACCOUNT_INFO",
"merchantName": "WANWEI",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"merchantInfo": {
"merchantName": "WANWEI",
"accountInfos": [
{
"accountType": "CREDIT",
"accountCurrency": "USD",
"accountAmount": "10000000.00",
"remainAccountAmount": "9999805.69"
}
]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 查询卡交易&清算信息
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | TRANS |
subRequestType | varchar(64) | Y | 请求子类型 | AUTH: 预授权交易 SETTLEMENT: 清算交易 |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
startDate | varchar(32) | N | 开始日期 | yyyy-MM-dd |
endDate | varchar(32) | N | 结束日期 | yyyy-MM-dd |
cardInfo | CardInfo | N | 卡信息 | |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
sign | json-string | Y | 签名信息 |
CardInfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
cardLogId | varchar(64) | Y | 卡片唯一标识 | 申卡后返回的唯一标识 |
签名生成规则
签名字段:requestId,requestTime,requestType,subRequestType,merchantName,channelType,cardLogId
请求报文示例:
{
"requestId": "auth20210803122000002",
"requestTime": "20210803122050",
"requestType": "TRANS",
"subRequestType": "AUTH",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
},
"sign": "hWYdu+y6qWkRvwj+rcoReisSveC8ok2p2DyOLAMdap1bKP+in/MnfgS6vO16HAYRzE9+HyDXvQomwEod2ppK7Qu1mAfowANIUA9yQQyc++YoW1o6psCekjcfFzQpPZEIOQL0KuoDCpKXuS3ja1ZZyYPlVQikwAoqGw/XE16NMhA=",
"operator": "max"
}
2
3
4
5
6
7
8
9
10
11
12
13
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(64) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
authInfo | AuthInfoResp | 授权信息 | subRequestType=AUTH时,返回 |
settlementInfo | SettlementInfoResp | 清算信息 | subRequestType= SETTLEMENT时,返回 |
AuthInfoResp
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
totalCount | int | 返回总条数 | |
balanceAmt | varchar(3) | 可用余额 | |
authInfos | List<AuthInfo> | 授权交易记录 |
AuthInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
occurTime | varchar(20) | 交易发生时间 | 格式 yyyy-MM-dd HH:mm:ss |
localTime | varchar(20) | 交易发生本地时间 | 格式 yyyy-MM-dd HH:mm:ss |
transId | varchar(64) | 交易唯一号 | |
transCurrency | varchar(3) | 交易币种 | |
transCurrencyAmt | varchar(17) | 交易币种金额 | |
localCurrency | varchar(3) | 卡币种 | |
localCurrencyAmt | varchar(17) | 卡本币种交易金额 | |
respCode | varchar(4) | 交易响应码 | 见授权交易响应码枚举 |
respCodeDesc | varchar(40) | 交易响应码描述 | 见授权交易响应码枚举 |
approvalCode | varchar(6) | 授权码 | |
declineReason | varchar(40) | 交易拒绝原因 | |
status | varchar(17) | 交易状态 | |
countryCode | varchar(3) | 交易地国家代码 | ISO_3166 |
stateCode | varchar(2) | 交易地州代码 | 只有US区域才有 |
messageType | varchar(4) | 信息类型 | 见授权交易类型枚举 |
messageTypeDesc | varchar(40) | 信息类型描述 | 见授权交易类型枚举 |
reversalType | varchar(2) | 冲正类型 | 仅授权类型为6930或6940时有值。0:系统冲正;1:非系统冲正。 |
transactionId | varchar(128) | 交易关联ID | 关联同笔交易的关联ID |
transMerchantInfo | TransMerchantInfo | 扣款商户Pos信息 | |
transExtra | jsonString | 用于今后的扩展 |
SettlementInfoRes
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
totalCount | int | 返回总条数 | |
balanceAmt | varchar(128) | 可用余额 | |
settlementInfos | List<SettlementInfo> | 清算交易记录 |
SettlementInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
transId | varchar(64) | 交易唯一号 | |
occurTime | varchar(20) | 交易发生时间 | yyyy-MM-dd HH:mm:ss |
postDate | varchar(20) | 入账日期 | yyyy-MM-dd HH:mm:ss |
settleDate | varchar(20) | 出账日期 | yyyy-MM-dd |
transCurrency | varchar(3) | 交易币种 | |
transAmt | varchar(17) | 交易金额 | |
localCurrency | varchar(3) | 卡币种 | |
localCurrencyAmt | varchar(17) | 卡本币种交易金额 | |
billCurrency | varchar(3) | 入账币种 | |
billCurrencyAmt | varchar(17) | 入账币种对应金额 | originalFundAmt+手续费 |
originalBillCurrencyAmt | varchar(17) | 入账原金额 | |
transType | varchar(30) | 交易类型 | 见清算交易类型枚举 |
transCode | varchar(4) | 交易类型码 | 见清算交易类型枚举 |
authNo | varchar(6) | 授权码 | |
isCredit | varchar(4) | 是否是收或付标识 | 1:收;0:付 |
transMerchantInfo | TransMerchantInfo | 扣款商户信息 | |
transExtra | json-String | 扩展 | |
transactionId | varchar(128) | 交易关联ID | 关联同笔交易的关联ID |
TransMerchantInfo
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
merchantName | varchar(128) | 商户名称 | |
merchantCategoryCode | varchar(128) | 商户MCC | |
merchantCountryCode | varchar(128) | 商户所在国家码 | |
merchantCity | varchar(128) | 商户所在国家城市 | |
merchantState | varchar(128) | 商户所在国家城市区域 | |
merchantZipCode | varchar(128) | 商户所在国家邮编 | |
merchantDesc | varchar(128) | 商户描述 |
响应报文示例:
授权交易
{
"ResponseStatus": {
"Timestamp": "/Date(1627964447413+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "8307883693023833330"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-1971"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "CCS000000",
"resultRespMsg": "SUCCESS",
"requestId": "auth20210803122000002",
"requestTime": "20210803122050",
"requestType": "TRANS",
"subRequestType": "AUTH",
"merchantName": "WANWEI",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf02avhd76c73464458"
},
"authInfoResp": {
"totalCount": 19,
"balanceAmt": "55.69",
"authInfos": [{
"occurTime": "2021-06-18 16:51:26",
"localTime": "2021-06-18 08:51:26",
"transId": "e1ff0ed5-f6f3-4cf3-a89f-3cdecf2395b6",
"transCurrency": "BOB",
"transCurrencyAmt": "6.99",
"localCurrency": "USD",
"localCurrencyAmt": "1.02",
"respCode": "0000",
"respCodeDesc": "Authorization Approval",
"approveCode": "882337",
"declineReason": "Authorization Approval",
"messageType": "6810",
"messageTypeDesc": "授权批准.消费",
"reversalType": "",
"transMerchantInfo": {
"merchantName": "FBPAY BVJ6",
"merchantCategoryCode": "7999",
"merchantCountryCode": "IRL",
"merchantCity": "fb.me/cc",
"merchantExtra": "{\"AcquirerId\":\"013445\",\"MerchantCode\":\"526567000011150\"}"
}
}, {
"occurTime": "2021-06-18 20:13:43",
"localTime": "2021-06-18 20:13:43",
"transId": "294f68b8-c883-4911-832a-bbb4be0f520c",
"transCurrency": "BOB",
"transCurrencyAmt": "15",
"localCurrency": "USD",
"localCurrencyAmt": "2.19",
"respCode": "0000",
"respCodeDesc": "Authorization Approval",
"approveCode": "081577",
"declineReason": "Authorization Approval",
"messageType": "6810",
"messageTypeDesc": "授权批准.消费",
"transMerchantInfo": {
"merchantName": "FACEBK 7YLA93PB52",
"merchantCategoryCode": "7311",
"merchantCountryCode": "IRL",
"merchantCity": "fb.me/ads",
"merchantExtra": "{\"AcquirerId\":\"013445\",\"MerchantCode\":\"526567000011168\"}"
}
}]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
结算交易
{
"ResponseStatus": {
"Timestamp": "/Date(1627964509486+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "2437083963088752651"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-2073"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "CCS000000",
"resultRespMsg": "SUCCESS",
"requestId": "settle20210803122100002",
"requestTime": "20210803122150",
"requestType": "TRANS",
"subRequestType": "SETTLEMENT",
"merchantName": "WANWEI",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93012581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
},
"settlementInfoResp": {
"totalCount": 1,
"balanceAmt": "0",
"settlementInfos": [{
"transId": "c1c14234a50d4e728166d2587408a151",
"occurTime": "2021-07-16 04:48:19",
"postDate": "2021-07-18 00:01:22",
"settleDate": "2021-07-17",
"transCurrency": "HKD",
"transAmt": "420",
"localCurrency": "HKD",
"localCurrencyAmt": "420",
"billCurrency": "HKD",
"billCurrencyAmt": "420",
"originalBillCurrencyAmt": "420",
"transType": "消费",
"transCode": "2010",
"authNo": "090489",
"transNo": "575",
"isCredit": "0",
"transMerchantInfo": {
"merchantName": "ROYAL VIEW HOTEL - FO",
"merchantCategoryCode": "7011",
"merchantCity": "HONG KONG",
"merchantExtra": "{\"AcquirerId\":\"001819\",\"MerchantCode\":\"002018588020\"}"
}
}]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
# 查询卡交易&清算信息(分页)
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestTime | varchar(14) | Y | 请求时间 | yyyyMMddHHmmss |
requestType | varchar(64) | Y | 请求类型 | TRANS |
subRequestType | varchar(64) | Y | 请求子类型 | AUTH2: 预授权交易 SETTLEMENT2: 清算交易 |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
startDate | varchar(32) | Y | 开始日期 | yyyy-MM-dd |
endDate | varchar(32) | Y | 结束日期 | yyyy-MM-dd |
pageNo | Integer | N | 分页页码 | 取值范围[1,100],默认值为1 |
pageSize | Integer | N | 分页条数 | 取值范围[1,100],默认值为5 |
cardInfo | CardInfo | N | 卡信息 | |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
sign | json-string | Y | 签名信息 |
CardInfo
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
cardLogId | varchar(64) | Y | 卡片唯一标识 | 申卡后返回的唯一标识 |
签名生成规则
签名字段:requestId,requestTime,requestType,subRequestType,merchantName,channelType,cardLogId
请求报文示例:
{
"requestId": "auth20210803122000002",
"requestTime": "20210803122050",
"requestType": "TRANS",
"subRequestType": "AUTH",
"merchantName": "WANWEI",
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
},
"sign": "hWYdu+y6qWkRvwj+rcoReisSveC8ok2p2DyOLAMdap1bKP+in/MnfgS6vO16HAYRzE9+HyDXvQomwEod2ppK7Qu1mAfowANIUA9yQQyc++YoW1o6psCekjcfFzQpPZEIOQL0KuoDCpKXuS3ja1ZZyYPlVQikwAoqGw/XE16NMhA=",
"operator": "max"
}
2
3
4
5
6
7
8
9
10
11
12
13
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
ResponseStatus | ResponseStatusType | ||
resultStatus | varchar(32) | 结果状态 | SUCCEED:成功 FAILURE:失败 EXCEPTION:异常 |
resultCode | varchar(64) | 结果码 | |
resultMsg | varchar(256) | 结果码描述 | |
channelType | varchar(32) | 发卡通道类型 | |
requestId | varchar(128) | 请求流水号 | 原请求原样返回 |
requestTime | varchar(14) | 请求时间 | 原请求原样返回 |
requestType | varchar(64) | 请求类型 | 原请求原样返回 |
subRequestType | varchar(64) | 请求子类型 | 原请求原样返回 |
merchantName | varchar(32) | 请求商户 | 原请求原样返回 |
cardInfo | CardInfo | 卡信息 | |
authInfoByPage | AuthTransactionByPage | 授权信息 | subRequestType=AUTH2时,返回 |
settlementInfoByPage | SettlementTransactionByPage | 清算信息 | subRequestType= SETTLEMENT2时,返回 |
AuthTransactionByPage
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
count | int | 返回总条数 | |
more | boolean) | 更多数据 | 是否还有更多的分页数据 true表示本次请求查询条件下有更多的分页数据。 |
transactionData | List<AuthTransactionDetailByPage> | 授权交易记录 |
AuthTransactionDetailByPage
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
requestId | String | 交易唯一ID | 全局唯一。 |
cardLogId | String | 卡ID | TripLink专用卡标识。 |
transactionId | String | 交易关联ID | 授权交易与对应冲正交易的transactionID 相同。 |
orderNo | String | 订单号 | |
transactionCurrencyCode | String | 交易币种 | ISO 4217 货币编号,3 位数字。 |
transactionAmount | Number | 交易金额 | 小数,对应交易币种。 |
cardCurrencyCode | String | 卡币种 | ISO 4217 货币编号,3 位数字。 |
cardTransactionAmount | Number | 卡交易金额 | 小数,对应卡币种。 |
responseCode | String | 交易响应码 | 枚举值,4 位数字,(非0000 表示授权拒绝) |
responseDescription | String | 交易响应码描述 | |
approvalCode | String | 授权码 | 随机6 位数字。 |
transactionCode | String | 交易类型 | 枚举值,4 位数字。 |
transactionDate | String | 交易发生时间 | 格式yyyy-MM-dd HH:mm:ss 。 |
localTime | String | 交易发生本地时间 | 格式yyyy-MM-dd HH:mm:ss 。 |
merchantName | String | 商户名称 | |
mcc | String | 商户MCC | ISO 18245 商户类别,4 位数字。 |
merchantCountry | String | 商户所在国家 | (未标准化) |
isoMerchantCountryCode | String | 商户所在国家 | ISO 3166 国家代码,3 位字母。(可能为空值) |
merchantCity | String | 商户所在城市 | |
merchantId | String | 商户ID | |
acquiringBankId | String | 收单行ID | |
cardInitialBalance | Number | 卡片期初金额 | |
cardEndingBalance | Number | 卡片期末金额 | |
creditTransactionSign | String | 贷记交易标记 | 枚举值,1 -贷记交易 0 -借记交易 |
reversalType | String | 是否为授权释放交易 | 仅授权类型为6930 或6940 时该字段有意义。枚举值, 0 -授权释放交易 1 -非授权释放交易 |
SettlementTransactionByPage
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
count | Integer | 返回总条数 | |
more | Integer | 更多数据 | 是否还有更多的分页数据 true表示本次请求查询条件下有更多的分页数据。 |
settlementData | List<SettlementTransactionDetailByPage> | 清算交易记录 |
SettlementTransactionDetailByPage
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
serialNo | String | 交易唯一ID | 全局唯一。 |
occurDateTime | String | 交易发生时间 | 格式yyyy-MM-dd HH:mm:ss 。 |
postingDateTime | String | 入账处理时间 | 格式yyyy-MM-dd HH:mm:ss 。 |
postingSysTime | String | 入账系统时间 | 格式yyyy-MM-dd 。 |
transactionCode | String | 交易类型 | 枚举值,4 位数字。 |
transactionType | String | 交易类型描述 | |
approvalCode | String | 授权码 | 随机6 位数字。 |
isCredit | String | 借贷记 | DEBT :借记,CRED :贷记。 |
originalTransactionCurrency | String | 交易币种 | ISO 4217 货币编号,3 位数字。 |
originalTransactionAmount | Number | 交易金额 | 小数,对应交易币种。 |
cardTransactionCurrency | String | 卡币种 | ISO 4217 货币编号,3 位数字。 |
cardTransactionAmount | Number | 卡交易金额 | 小数,对应卡币种。 |
accountCurrency | String | 清算币种 | ISO 4217 货币编号,3 位数字。 |
billAccountAmount | Number | 清算金额 | 小数,对应账户币种。 |
posMerchantID | String | 商户ID | |
posMerchantName | String | 商户名称 | |
posMerchantClassCode | String | 商户MCC | ISO 18245 商户类别,4 位数字。 |
posMerchantCountry | String | 商户所在国家 | (未标准化) |
isoMerchantCountryCode | String | 商户所在国家 | 3 位字母(可能为空值) |
posMerchantCity | String | 商户所在城市 | |
posAcquirerID | String | 收单行ID | |
transactionId | String | 交易关联ID | 关联同笔交易的关联ID |
响应报文示例:
授权交易
{
"ResponseStatus": {
"Timestamp": "/Date(1627964447413+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "8307883693023833330"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-1971"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "CCS000000",
"resultRespMsg": "SUCCESS",
"requestId": "auth20210803122000002",
"requestTime": "20210803122050",
"requestType": "TRANS",
"subRequestType": "AUTH",
"merchantName": "WANWEI",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93074581f961e345cb6205d172f772e29494bf02avhd76c73464458"
},
"authInfoResp": {
"totalCount": 19,
"balanceAmt": "55.69",
"authInfos": [{
"occurTime": "2021-06-18 16:51:26",
"transId": "e1ff0ed5-f6f3-4cf3-a89f-3cdecf2395b6",
"transCurrency": "BOB",
"transCurrencyAmt": "6.99",
"localCurrency": "USD",
"localCurrencyAmt": "1.02",
"respCode": "0000",
"respCodeDesc": "Authorization Approval",
"approveCode": "882337",
"declineReason": "Authorization Approval",
"messageType": "6810",
"messageTypeDesc": "授权批准.消费",
"reversalType": "",
"transMerchantInfo": {
"merchantName": "FBPAY BVJ6",
"merchantCategoryCode": "7999",
"merchantCountryCode": "IRL",
"merchantCity": "fb.me/cc",
"merchantExtra": "{\"AcquirerId\":\"013445\",\"MerchantCode\":\"526567000011150\"}"
}
}, {
"occurTime": "2021-06-18 20:13:43",
"transId": "294f68b8-c883-4911-832a-bbb4be0f520c",
"transCurrency": "BOB",
"transCurrencyAmt": "15",
"localCurrency": "USD",
"localCurrencyAmt": "2.19",
"respCode": "0000",
"respCodeDesc": "Authorization Approval",
"approveCode": "081577",
"declineReason": "Authorization Approval",
"messageType": "6810",
"messageTypeDesc": "授权批准.消费",
"transMerchantInfo": {
"merchantName": "FACEBK 7YLA93PB52",
"merchantCategoryCode": "7311",
"merchantCountryCode": "IRL",
"merchantCity": "fb.me/ads",
"merchantExtra": "{\"AcquirerId\":\"013445\",\"MerchantCode\":\"526567000011168\"}"
}
}]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
结算交易
{
"ResponseStatus": {
"Timestamp": "/Date(1627964509486+0800)/",
"Ack": "Success",
"Errors": [],
"Extension": [{
"Id": "CLOGGING_TRACE_ID",
"Value": "2437083963088752651"
}, {
"Id": "RootMessageId",
"Value": "100028317-0a06b391-452212-2073"
}]
},
"resultstatus": "SUCCEED",
"resultRespCode": "CCS000000",
"resultRespMsg": "SUCCESS",
"requestId": "settle20210803122100002",
"requestTime": "20210803122150",
"requestType": "TRANS",
"subRequestType": "SETTLEMENT",
"merchantName": "WANWEI",
"channelId": 54,
"channelType": "WANWEI_CFNC_VCC",
"cardInfo": {
"cardLogId": "89a37cd93012581f961e345cb6205d172f772e29494bf023ab11d76c73464458"
},
"settlementInfoResp": {
"totalCount": 1,
"balanceAmt": "0",
"settlementInfos": [{
"transId": "c1c14234a50d4e728166d2587408a151",
"occurTime": "2021-07-16 04:48:19",
"postDate": "2021-07-18 00:01:22",
"settleDate": "2021-07-17",
"transCurrency": "HKD",
"transAmt": "420",
"localCurrency": "HKD",
"localCurrencyAmt": "420",
"billCurrency": "HKD",
"billCurrencyAmt": "420",
"originalBillCurrencyAmt": "420",
"transType": "消费",
"transCode": "2010",
"authNo": "090489",
"transNo": "575",
"isCredit": "0",
"transMerchantInfo": {
"merchantName": "ROYAL VIEW HOTEL - FO",
"merchantCategoryCode": "7011",
"merchantCity": "HONG KONG",
"merchantExtra": "{\"AcquirerId\":\"001819\",\"MerchantCode\":\"002018588020\"}"
}
}]
}
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
# 报表服务
Triplink提供开卡报表、授权交易报表、结算交易报表等多种常见的报表数据,接入方可以选择通过邮件和SFTP的方式来接收这些报表数据。
报表类型 | 报表周期 | 报表模板 |
---|---|---|
开卡报表 | 每天 | CSR54188778E6E14_DailyOpenVANs_2021-07-27.csv |
授权交易报表 | 每天 | CSR344D327079254_DailyVANsAuthReport_2021-07-27.csv |
结算交易报表 | 按结算周期 | CSR2D1A41FF46354_DailyVANsSettlement_2021-07-27.csv |
争议交易报表 | 每月 | CSRCD233F6AABBE4_MonthlyVANsNATChargebacks_2021-06-01.csv |
还款交易报表 | 每天 | CSRE8C4A6EFE31C4_DailyVANsPMT_2021-07-27.csv |
资金明细报表 | 每天 | CSR5369C27FEC174_DailyFinanceReport_2021-11-14.csv |
# 接口回调服务
Triplink可以支持在多个业务场景回调对应的接入方,接入方可以在回调接口中根据自己的业务场景实现相应的逻辑,接入方可参考准备工作中的描述来快速接入,目前Triplink可以支持以下两个场景回调:
# 授权结果通知
接入方提供接口接收授权结果,Triplink会在授权完成后以异步的方式回调接入方的接口。
接口契约
基于https/post协议,报文使用json进行反/序列化,接口契约如下:
字段名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
bizContent | json-string | Y | 报文实际内容,需要通过json反序列化 |
signature | varchar | Y | 签名内容 |
BizContent
字段名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
authId | varchar | Y | 每笔授权的唯一识别号 |
cardLogId | varchar | Y | 卡在TripLink处唯一参考号 |
transactionId | varchar | Y | 交易ID, 授权交易与对应冲正交易的transactionId 相同。 |
cardAvailableBalance | varchar | Y | 可用卡余额 |
occurTime | varchar | Y | 交易发生时间,格式yyyy-MM-dd HH :mm:ss |
transCurrency | varchar | Y | 交易币种 |
transCurrencyAmt | varchar | Y | 交易金额 |
localCurrency | varchar | Y | 开卡币种 |
localCurrencyAmt | varchar | Y | 交易转换为开卡币种金额 |
respCode | varchar | Y | 见授权交易响应码枚举 |
respCodeDesc | varchar | Y | 见授权交易响应码枚举 |
approveCode | varchar | Y | 授权码 |
messageType | varchar | Y | 见授权交易类型枚举 |
messageTypeDesc | varchar | Y | 见授权交易类型枚举 |
reversalType | varchar(2) | Y | 仅授权类型为6930或6940时有值。0:系统冲正;1:非系统冲正。 |
useRef1Txt | varchar | N | 用户自定义字段1 |
useRef2Txt | varchar | N | 用户自定义字段2 |
useRef3Txt | varchar | N | 用户自定义字段3 |
useRef4Txt | varchar | N | 用户自定义字段4 |
useRef5Txt | varchar | N | 用户自定义字段5 |
merchantName | varchar | N | 商户名称 |
merchantCategoryCode | varchar | N | 商户MCC |
merchantId | varchar | N | 商户id |
merchantCountry | varchar | N | 商户国家 |
merchantCity | varchar | N | 商户城市 |
merchantPostcode | varchar | N | 商户邮编 |
acquirerId | varchar | N | 收单行id |
crossBorderType | varchar | N | 交易是否跨境。0 :境内;1 :境外。 |
请求报文示例:
{
"signature": "kqcs8/NunJW1w9cnHQp2omNGULdDG56k6drV7RSEO5UHwVHNNNV7/1s8wL1x27t75Fh9bTacyn5se4cKrjuqvn1HEhHUGaaNomptNSK8PR95K9hY6XskxRwY0ZW9cx0+KsZES74TmorZHZK8sf+HZDdyceIPga7ynPZ3QJ4qUD0\u003d",
"bizContent": "{\"authId\":\"47c6ba35-3fa9-4b94-86e8-c3a292f42c12\",\"cardLogId\":\"ba4bbb5426df15131d4695d6466f21a236ae1c1416f07fafbd49b2fbb0f3d0f5\",\"cardAvailableBalance\":\"9.00\",\"occurTime\":\"2021-07-20 15:40:10\",\"transCurrency\":\"840\",\"transCurrencyAmt\":\"0.50\",\"localCurrency\":\"840\",\"localCurrencyAmt\":\"0.50\",\"respCode\":\"0000\",\"respCodeDesc\":\"Authorization Approval\",\"approveCode\":\"787843\",\"messageType\":\"6810\",\"messageTypeDesc\":\"Authorization Approval\",\"reversalType\":\"\",\"useRef1Txt\":\"2107201145000293125\",\"merchantName\":\"\",\"merchantCategoryCode\":\"0005\",\"merchantId\":\"87846545546\",\"merchantCountry\":\"\",\"merchantCity\":\"\",\"merchantPostcode\":\"\",\"acquirerId\":\"213457\",\"merchantCity\":\"\",\"merchantPostcode\":\"\"}"
}
2
3
4
5
响应报文
客户如接收通知成功,需要返回code和msg的json String (示例见下)。当返回的code非0时或者未收到返回时,TripLink会重新发送异步通知,如三次重试后仍未收到有效返回则不再重试。
{
"code":"0",
"msg":"success"
}
2
3
4
# 授权决策回调
Triplink在批准授权请求之前回调接入方的授权决策接口,接入方可以在该接口中实现自己的风控和交易决策。
接口契约
基于https/post协议,报文使用json进行反/序列化,接口契约如下:
字段名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
bizContent | json-string | Y | 报文实际内容,需要通过json反序列化 |
signature | varchar | Y | 签名内容 |
BizContent
字段名称 | 数据类型 | 必填 | 说明 |
---|---|---|---|
authId | varchar | Y | 每笔授权的唯一识别号 |
cardLogId | varchar | Y | 卡在TripLink处唯一参考号 |
transactionId | varchar | Y | 交易ID, 授权交易与对应冲正交易的transactionId 相同。 |
localTime | varchar | Y | 交易本地时间hhMMss |
localDate | varchar | Y | 交易本地日期MMDD |
cardAvailableBalance | varchar | Y | 可用卡余额 |
occurTime | varchar | Y | 交易发生时间,格式yyyy-MM-dd HH :mm:ss |
transCurrency | varchar | Y | 交易币种 |
transCurrencyAmt | varchar | Y | 交易金额 |
localCurrency | varchar | Y | 开卡币种 |
localCurrencyAmt | varchar | Y | 交易转换为开卡币种金额 |
messageType | varchar | Y | 见授权交易类型枚举 |
messageTypeDesc | varchar | Y | 见授权交易类型枚举 |
useRef1Txt | varchar | N | 用户自定义字段1 |
useRef2Txt | varchar | N | 用户自定义字段2 |
useRef3Txt | varchar | N | 用户自定义字段3 |
useRef4Txt | varchar | N | 用户自定义字段4 |
useRef5Txt | varchar | N | 用户自定义字段5 |
merchantName | varchar | N | 商户名称 |
merchantCategoryCode | varchar | N | 商户MCC |
merchantId | varchar | N | 商户id |
merchantCountry | varchar | N | 商户国家 |
merchantCity | varchar | N | 商户城市 |
merchantPostcode | varchar | N | 商户邮编 |
acquirerId | varchar | N | 收单行id |
transactionFees | varchar | N | 交易手续费 |
transactionFeesCurrency | varchar | N | 交易手续费币种 |
请求报文示例:
{
"signature": "OAFHsef8KshYFgxnoMWFJonjB4dhKw26oqBAJGeI+T9Ic2R3lNNqK4XOqDjBrMww2SCDaju17gCNr6Bi23MrGNSIg+vjG3sQf3+zr5ACNSMvcsdrzCmq+qrhj6dmq2icurz75fiIZMexW5o4RExPNWqb5wY2+ogObVM6SLmSaEY\u003d",
"bizContent": "{\"authId\":\"00344127-a898-4f2e-8096-9af90dc2d015\",\"cardLogId\":\"ba4bbb5426df15131d4695d6466f21a236ae1c1416f07fafbd49b2fbb0f3d0f5\",\"localTime\":\"213322\",\"localDate\":\"20211026\",\"occurTime\":\"2021-07-20 18:10:10\",\"merchantCategoryCode\":\"0005\",\"merchantName\":\"\",\"merchantCountry\":\"ARG\",\"state\":\"\",\"merchantCity\":\"\",\"messageType\":\"6810\",\"messageTypeDesc\":\"Authorization Approval\",\"acquirerId\":\"213457\",\"merchantId\":\"87846545546\",\"transCurrency\":\"840\",\"transCurrencyAmt\":\"0.51\",\"localCurrency\":\"840\",\"localCurrencyAmt\":\"0.51\",\"useRef1Txt\":\"2107201145000293125\",\"useRef2Txt\":\"\",\"useRef3Txt\":\"\",\"useRef4Txt\":\"\",\"useRef5Txt\":\"\",\"cardAvailableBalance\":\"8.47\"}"
}
2
3
4
响应报文
客户如接收通知成功,需要返回code和msg的json String (示例见下),code 为"0",认为是授权成功,非"0"认为是授权失败,msg 为相关说明。
{
"code":"0",
"msg":"success"
}
2
3
4
该接口的超时时间为500ms,如果Triplink回调授权决策接口出现超时或者异常,接入方可以告知Triplink降级方式,即默认通过/拒绝。
# 争议
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestSource | varchar | Y | 请求来源 | 请求方自定义区分 |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
channelId | varchar | Y | 通道编码id | |
sign | varchar | Y | 签名信息 | |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
reqExtra | varchar | N | 扩展域字段 | 请参考“请求扩展域”节点 |
transId | varchar | Y | 入帐交易的唯一ID | |
chargebackCurrency | varchar(3) | Y | 争议币种 | ISO 4217货币编号,字母 争议币种为结算币种或者交易币种 |
chargebackAmount | varchar | Y | 争议金额 | 含小数 |
chargebackReason | varchar | Y | 争议原因: 4834-Point of Interaction Error 4837-No Cardholder Authorization(必须未过3DS) 4849-Questionable merchant activity 4853-Consumer disputes 4808-Authorization related chargeback | |
fraudType | varchar | N | 欺诈类型 Card report lost Card report stolen Never Received Issue Card Issued on basic of fraudulent application Counterfeit Account takeover fraud Card not present Imprinting of multiple sales drafts Collusive merchant | chargebackReason=4837/4849,必传 |
subType | varchar | N | 欺诈类型补充 fraud occured on a convenience check or balance transfer PIN not used PIN used Unavailable | chargebackReason=4837/4849,必传 |
chgbkIndicator | varchar | N | 争议状态 No chargeback Member has initiated or will initiate a chargeback | chargebackReason=4837/4849,必传 |
acctStatus | varchar | N | 账户状态 ACCT_IS_OPEN ACCT_HAS_BEEN_CLOSED | chargebackReason=4837/4849,必传 |
deviceType | varchar | N | 设备类型 1、2、3、4、A、B、C、D、E、F、G、H、I、J | chargebackReason=4837/4849,必传 |
cvcInvalidIndicator | varchar | N | cvc标识 CVC 2 Valid Invalid(Not match) Unable to Process Issuer Unregister to Process CVC 1 Code not valid CVC 3 unpredictable number not valid length Response Code Unknown | chargebackReason=4837/4849,必传 |
reportDate | varchar | N | 报告日期 格式:yyyy-MM-dd | chargebackReason=4837/4849,必传 |
comment | varchar | N | 争议描述、备注 | |
fileReferenceId | varchar | Y | 文件上传返回的文件key |
请求报文示例:
{
"requestId": "card20210803121800002",
"requestSource": "20210803121850",
"channelType": "",
"merchantName": "WANWEI",
"merchantId": "",
"sign": "Yxy1DS4vcR11sO5ry6OQf66tTiS51G+OqPdN4nmaWIr/ej/qTeeiKiTV8E9l9EECD3vuyT7lS3E3AuZzNsMvfyEgKUUz76QJGEYu0BDqlTq9LEpCRfVdvjxrrS6IgpF08mt83HFsxqQEcUs+0XCBic5FofIBT1wR0Y6PMAxwg4Q=",
"operator": "max",
"reqExtra": "",
"transId": "6810202401020024488719140932542",
"chargebackCurrency": "392",
"chargebackAmount": "10",
"customerId": "CSR8C16A778B6D24",
"chargebackReason": "4837",
"fraudType": "Card report lost",
"subType": "fraud occured on a convenience check or balance transfer",
"chgbkIndicator": "No chargeback",
"acctStatus": "CCT_IS_OPEN",
"deviceType": "1",
"cvcInvalidIndicator": "CVC 2 Valid",
"reportDate": "2023-12-01",
"fileReferenceId": "AWS20231229E706A7101FB04D9A940607B916AAA995",
"comment": "test"
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
responseStatus | ResponseStatusType | ||
chargebackId | varchar | 争议案件号 | |
returnCode | varchar | 响应码 | |
errorMessage | varchar | 响应错误信息 |
# 争议查询
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestSource | varchar | Y | 请求来源标识 | 请求方自定义区分 |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
channelId | varchar | Y | 通道编码id | |
sign | varchar | Y | 签名信息 | |
operator | varchar(128) | Y | 操作人 | 调用端操作人 |
reqExtra | varchar | N | 扩展域字段 | 请参考“请求扩展域”节点 |
chargebackRequestId | varchar | Y | 发起争议请求的流水号 |
请求报文示例:
{
"requestId": "card20210803121800002",
"requestSource": "20210803121850",
"channelType": "",
"merchantName": "WANWEI",
"merchantId": "",
"sign": "Yxy1DS4vcR11sO5ry6OQf66tTiS51G+OqPdN4nmaWIr/ej/qTeeiKiTV8E9l9EECD3vuyT7lS3E3AuZzNsMvfyEgKUUz76QJGEYu0BDqlTq9LEpCRfVdvjxrrS6IgpF08mt83HFsxqQEcUs+0XCBic5FofIBT1wR0Y6PMAxwg4Q=",
"operator": "max",
"reqExtra": "",
"chargebackRequestId": "ce5ca5c5-6f55-458f-9b80-1112565d9964"
}
2
3
4
5
6
7
8
9
10
11
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
responseStatus | ResponseStatusType | ||
returnCode | varchar | 响应码 | |
errorMessage | varchar | 响应错误信息 | |
chargebackId | varchar | 争议案件ID | |
chargebackCurrency | varchar | 提交争议的币种 | ISO 4217货币编号,字母 |
chargebackAmount | varchar | 提交争议的金额 | 带小数位 |
chargebackTime | varchar | 提交争议时间 | 格式yyyy-MM-dd HH:mm:ss |
finishTime | varchar | 争议结束时间 | 格式yyyy-MM-dd HH:mm:ss |
chargebackStatus | varchar | 争议状态 | PENDING-待处理 DISPUTING-争议中 SUCCESS-争议成功 FAILED-争议失败 REJECT-争议拒绝 SUBMIT_FAILED-提交失败 |
# 附件上传
# 请求报文
字段名称 | 数据类型 | 必填 | 说明 | 备注 |
---|---|---|---|---|
requestId | varchar(128) | Y | 请求流水号 | 请求方唯一流水号 |
requestSource | varchar | Y | 请求来源 | 请求方自定义区分 |
merchantName | varchar(32) | Y | 请求商户名 | 服务方分配 |
channelType | varchar(32) | Y | 发卡通道类型 | 服务方分配 |
channelId | varchar | Y | 通道编码id | |
sign | varchar | Y | 签名信息 | |
operator | varchar(128) | Y | 操作人 | 请求方操作人 |
reqExtra | varchar | N | 请求附属信息 | |
fileName | varchar | Y | 文件名 | 带文件后缀 |
file | varchar | Y | 文件 | base64编码 |
请求报文示例:
{
"requestId": "card20210803121800002",
"requestSource": "20210803121850",
"channelType": "",
"merchantName": "WANWEI",
"channelId": "",
"sign": "Yxy1DS4vcR11sO5ry6OQf66tTiS51G+OqPdN4nmaWIr/ej/qTeeiKiTV8E9l9EECD3vuyT7lS3E3AuZzNsMvfyEgKUUz76QJGEYu0BDqlTq9LEpCRfVdvjxrrS6IgpF08mt83HFsxqQEcUs+0XCBic5FofIBT1wR0Y6PMAxwg4Q=",
"operator": "max",
"reqExtra": "",
"fileName": "test.jpg",
"file": "dhasfudhasuf222dsdsfnYbf+OqPdN4nmaWIr/ej/qTeeiKiTV8E9l9EECD3vuyT7lS3E3AuZzNsMvfyEgKUUz76QJGEYu0BDqlTq9LEpCRfVdvjxrrS6IgpF08mt83HFsxqQEcUs+0XCBic5FofIBT1wR0Y6PMAxwg1hushfua/adauhfdabbahaJiIaihdufadajd33njadnfusafaidsjadnaa/andfabudsbfaudanfnasdfbuasdniaueufbafdnbaufbuadbfajf333urbjdabfadsfbadbfha4Q="
}
2
3
4
5
6
7
8
9
10
11
12
# 响应报文
字段名称 | 数据类型 | 说明 | 备注 |
---|---|---|---|
responseStatus | ResponseStatusType | ||
returnCode | varchar | 响应码 | |
errorMessage | varchar | 响应错误信息 | |
fileReferenceId | varchar | 文件唯一key | |
fileName | varchar | 文件名 | 带文件后缀 |
# 枚举类型
# 清算交易类型枚举
transCode | transType |
---|---|
2010 | Purchase |
2110 | Refund |
4160 | Chargeback |
4060 | Chargeback Release |
# 授权交易类型枚举
messageType | messageTypeDesc |
---|---|
6810 | Authorization Approval |
6890 | Authorization Decline |
6510 | Auth Refund Approval |
6590 | Auth Refund Decline |
6930 | Authorization Reversal Approval |
6940 | Auth Refund Reversal Approval |
6950 | Authorization Auto Reversal |
6820 | Authorization Query |
# 授权交易响应码枚举
respCode | respCodeDesc |
---|---|
0000 | Authorization Approval |
1101 | Abnormal Customer Status |
1102 | Card canceled |
1103 | Authorization Amount Error |
1107 | Invalid CVV2 |
1109 | Transaction Date Error |
1108 | VAN Amount Limit Error |
1104 | VAN Amount Limit Error |
1106 | Transaction Count Over Limit |
1111 | MCC Error |
1105 | Invalid Expiry Date |
1110 | Trans Currency Not Allowed |
1003 | Invalid Acount |
1002 | High Risk Transaction |
1001 | Unauthorised Card |
2001 | Original Transaction Unmatch |
2002 | Original Transaction Unmatch |
1112 | VAN credit limit greater than max Limit |
1113 | VAN credit limit less than min Limit |
1114 | Transaction Date before card activeDate |
1115 | Transaction Date after card inactiveDate |
1116 | Auth Amount greater than available VAN credit limit |
1117 | Auth Amount greater than available account |
1118 | Limited usage with abnormal card status |
1203 | Not support 3ds |
2012 | Cardholder cancels identity verification |
2014 | Cardholder fails to complete identity verification within the specified time |
2019 | Cardholder fails to complete identity verification within the specified number of attempts |
2022 | Merchant requests invalid information |
3004 | Card Scheme network anomaly |
9000 | Unknow Error |
# 风控订单类型枚举
riskOrderType枚举-中文 | riskOrderType枚举-英文 |
---|---|
机票 | flight |
酒店 | hotel |
度假 | vacation |
广告及市场推广服务业 | Advertising |
软件和信息技术服务业 | Information technology |
教育机构 | Educational institutions |
网上零售 | Online retail |
电商平台-零售 | E-Commerce-retail |
本地速递服务 | Local courier activities |
国际物流及仓储服务 | Logistics and storage |
电商平台-批发 | E-Commerce-B2B |
# 接口响应码
resultRespCode | resultRespMsg |
---|---|
CCS000000 | Success |
CCF000003 | Request Error |
CCF000004 | Request Type Un-Know |
CCF000005 | Sub Request Type Un-Know |
CCE000006 | System Error |
200001 | ActiveDate must be greater than current date |
200002 | Both MCC, MCC groups and [acquirerId,merchantId] are all empty |
200003 | Customer info not find |
200004 | Not find the mapping between clearing currency and open card currency |
200005 | Contract expiration |
200006 | Insufficient credit limit |
200007 | Global parameter not find |
200008 | InactiveDate must be greater than activeDate |
200009 | Effective mccGroup not find |
200010 | Mcc is incorrect |
200011 | Generate cvv error |
200012 | Invoke pci error |
200013 | Not find the mapping between the cardCurrency and settlementCurrency |
200014 | AcquirerId/mid must not be empty |
200015 | Not find card |
200016 | Card status is closed or expired |
200017 | Update card : cvv2 parameter is incorrect |
200018 | Get account info error |
200019 | Update card limit is less than the amount of used card |
200022 | SeqNbrMaxTemp error |
200023 | Card not exist |
200033 | Not find requestId |
200035 | Not find cardLogId |
200036 | Card bin not support |
201000 | Card available balance exceeds the maximum limit |
300009 | transaction is out of chargeback expire |
300010 | transaction is in chargeback |
300011 | chargeback transaction not found |
300012 | upload attachment not found |
300013 | chargeback amount exceeds |
300014 | chargeback card error |
300015 | chargeback currency error |
300016 | chargeback request not found |
300017 | chargeback amount is less than or equal to 0 |
300018 | chargeback request already exits |
300019 | chargeback request is processing |
300020 | transaction is not allowed to chargeback |