文档中心

# 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

各接口中，可参与签名的字段请参考各接口契约说明。

签名字段组装规则

各参与签名字段的值按接口定义顺序串联在一起，具体参考对应接口的文档说明。

参与签名字段若值为空时不参与签名。

签名算法示例

  1. SHA256withRSA签名后
  2. base64输出
  3. 签名密钥需要去掉(-----BEGIN PRIVATE KEY-----)和（-----END PRIVATE KEY-----）串

    # 加密解密

    为了保证接口通讯中涉及到PCI数据的安全性，Triplink会对传输卡号/有效期/CVV2的CardInfo字段进行加密，加密算法采用对称算法DES，因此接入方在接入之前会收到Triplink为您分配的密钥

    什么是DES算法？ (opens new window)

    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="
}
      1
      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\"}"
}
      1
      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="
}
      1
      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"
}
      1
      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="
}
      1
      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"
	}
}
      1
      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="
}
      1
      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"
	}
}
      1
      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="
}
      1
      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"
	}
}
      1
      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="
}
      1
      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"
	}
}
      1
      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="
}
      1
      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"
	}
}
      1
      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"
}
      1
      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\"}"
}
      1
      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"
}
      1
      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:只允许开卡币种作为交易币种
      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",
		"cardStatus": "OPEN",
        "cardLabel": "MasterCard",
		"userDefineInfo": "{\"BookingNumber\":\"0d4a88ac-690f-7123-4930-17a831c41a49\"}"
	},
	"respExtra": "{\"CreateTransId\":\"APPD4C25C10D28E4\",\"BinFlagDrec\":\"GWTTP\",\"NetSettleAmt\":\"0\",\"OutstandingAuthAmt\":\"0\"}"
}
      1
      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

      # 查询账户信息（旧）

      # 请求报文

      字段名称 数据类型 必填 说明 备注
      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"
}
      1
      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"
		}]
	}
}
      1
      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"
}
      1
      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"
            }
        ]
    }
}
      1
      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"
}
      1
      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
      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",
			"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\"}"
			}
		}]
	}
}
      1
      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\"}"
			}
		}]
	}
}
      1
      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"
}
      1
      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。
      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\"}"
			}
		}]
	}
}
      1
      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\"}"
			}
		}]
	}
}
      1
      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\":\"\"}"
}
      1
      2
      3
      4
      5

      响应报文

      客户如接收通知成功，需要返回code和msg的json String （示例见下）。当返回的code非0时或者未收到返回时，TripLink会重新发送异步通知，如三次重试后仍未收到有效返回则不再重试。

      {
	"code":"0",
	"msg":"success"
}
      1
      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\"}"
}
      1
      2
      3
      4

      响应报文

      客户如接收通知成功，需要返回code和msg的json String （示例见下），code 为"0",认为是授权成功，非"0"认为是授权失败，msg 为相关说明。

      {
	"code":"0",
	"msg":"success"
}
      1
      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"
}
      1
      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"
}
      1
      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="
}
      1
      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

      # 风控订单类型枚举

      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
      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