API 文档
公共参数
请求头
| 名称 | 必填 | 描述 | 备注 | 示例值 |
|---|---|---|---|---|
customerId | Y | 客户 ID | 预先配置。 | ASR3F1B4Z5 |
service | Y | API 名称 | 详见API 列表。 | createCard |
version | Y | API 版本 | 当前版本2.0。 | 2.0 |
requestId | Y | 请求流水号 | 每个请求唯一，建议使用UUID。 | 472f37e3-a803-47ed-b9b6-32632895b466 |
timestamp | Y | 请求时间 | UNIX 时间戳（毫秒）。 | 1642747436113 |
sign | Y | 请求数据签名 | 详见签名机制。 | +Ue0BiWsCOxbYD39Ldd（部分数据） |
响应头
| 名称 | 描述 | 备注 | 示例值 |
|---|---|---|---|
customerId | 客户 ID | 请求头原样返回。 | ASR3F1B4Z5 |
service | API 名称 | 请求头原样返回。 | createCard |
version | API 版本 | 请求头原样返回。 | 2.0 |
requestId | 请求流水号 | 请求头原样返回。 | 472f37e3-a803-47ed-b9b6-32632895b466 |
timestamp | 响应时间 | UNIX 时间戳（毫秒）。 | 1642747437393 |
code | 响应码 | 枚举值，3位数字，详见响应码下拉框。 | 200（非200表示 API 调用失败） |
message | 响应码详情 | 详见响应码下拉框。 | succeed |
sign | 响应数据签名 | 详见签名机制。 | WO8waUZ30bYlKp/+s9m（部分数据） |
📋响应码▶
API 列表
| 名称 | 方法 | 请求头 service 参数 |
|---|---|---|
| 创建卡 | POST | createCard |
| 修改卡 | POST | updateCard |
| 充值卡 | POST | rechargeCard |
| 提现卡 | POST | withdrawCard |
| 锁定卡 | POST | suspendCard |
| 解锁卡 | POST | unSuspendCard |
| 注销卡 | POST | closeCard |
| 查询卡 | POST | queryCardDetail |
| 查询账户额度 | POST | queryCustomerCredit |
| 查询授权交易 | POST | queryAuthTransactionByPage |
| 查询清算交易 | POST | settlementTransactionQuery |
| 发起账户提现 | POST | payoutCreate |
| 查询账户 提现 | POST | payoutQuery |
| 查询汇率 | POST | fxQuote |
| 发起换汇订单 | POST | fxCreate |
| 查询换汇订单 | POST | fxQuery |
加密机制
为保证数据的安全性，TripLink 会对每个请求和响应进行加密。
接入方与 TripLink 需使用对称加密算法AES/ECB/PKCS5Padding，对请求体和响应体进行加密与解密，结果采用Base64 编码。
TripLink 需要接入方提前提供128位AES密钥（Base64 编码格式），参考准备工作。
请求体
原始请求体各字段含义详见下方各 API 说明。
接入方：对原始请求体先使用AES密钥加密，再进行Base64编码。结果作为实际请求体中payload字段的值。发送实际请求体。
TripLink：对收到的实际请求体的payload字段的值先进行Base64解码，再使用AES密钥解密。结果即为原始请求体。
- 原始
- 实际
{
"key_1": "value_1",
"key_2": "value_2",
"key_3": "value_3"
}
{
"payload": "8YryQ8hYkTL3UzzEdvlUGGrL/5rABcclaP9NZt9GAMRVR9ehvJv9aJHfM3XqPlRIk9lvPN+U0iERGz9wpHtxvA=="
}
响应体
原始响应体各字段含义详见下方各 API 说明。
TripLink：对原始响应体先使用AES密钥加密，再进行Base64编码。结果作为实际响应体中payload字段的值。发送实际响应体。
接入方：对收到的实际响应体中payload字段的值先进行Base64解码，再使用AES密钥解密。结果即为原始响应体。
- 原始
- 实际
{
"key_1": "value_1",
"key_2": "value_2",
"key_3": "value_3"
}
{
"payload": "8YryQ8hYkTL3UzzEdvlUGGrL/5rABcclaP9NZt9GAMRVR9ehvJv9aJHfM3XqPlRIk9lvPN+U0iERGz9wpHtxvA=="
}
📋Java 工具类示例▶
📋C#工具类示例▶
📋PHP 工具类示例▶
签名机制
为保证 API 的安全调用，TripLink 会对每个请求和响应通过签名进行身份验证。
接入方与 TripLink 需使用签名算法SHA256withRSA，对请求待签字符串和响应待签字符串进行签名，签名结果采用Base64 编码，对应请求头和响应头的sign字段。
接入方会提前收到 TripLink 为您分配的2048位RSA公钥 T（Base64 编码格式），同时 TripLink 需要接入方提前提供2048位RSA公钥 U（Base64 编码格式），参考准备工作。
整个请求与响应流程涉及2对RSA密钥：属于 TripLink 的公钥 T与私钥 T，属于接入方的公钥 U与私钥 U。公钥用于验证签名，私钥用于生成签名。
请求待签字符串
所有字段按如下顺序依次使用|符号连接。
customerId|service|version|requestId|timestamp|payload
customerId，service，version，requestId和timestamp来自请求头中对应字段。
payload来自实际请求体中加密过的payload字段。
接入方：对请求待签字符串先使用私钥 U生成签名，再进行Base64编码。结果作为请求头中sign字段的值。
TripLink：对收 到的请求头中sign字段的值先进行Base64解码，再使用公钥 U验证签名。
响应待签字符串
所有字段按如下顺序依次使用|符号连接。
customerId|service|version|requestId|timestamp|code|message|payload
customerId，service，version，requestId，timestamp，code和message来自响应头中对应字段。
payload来自实际响应体中payload字段。
TripLink：对响应待签字符串先使用私钥 T生成签名，再进行Base64编码。结果作为响应头中sign字段的值。
接入方：对收到的响应头中sign字段的值先进行Base64解码，再使用公钥 T验证签名。
📋Java 工具类示例▶
📋C#工具类示例▶
📋PHP 工具类示例▶
创建卡
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardCurrencyCode | String | N | 卡币种 | 默认与结算币种相同。 ISO 4217 货币编号， 3位数字。 |
settlementCurrencyCode | String | Y | 结算币种 | ISO 4217 货币编号，3位数字。 |
exchangeCurrencyCode | String | N | 卖出币种 | ISO 4217 货币编号，3位数字。卡产品为 C05 时生效且必填。刷卡授权消费时自动将卖出币种兑换为结算币种。 |
activeDate | String | Y | 生效日期 | 格式 yyyy-MM-dd。 |
inactiveDate | String | Y | 失效日期 | 格式 yyyy-MM-dd。 |
activeTime | String | N | 生效时间 | 格式 HH:mm:ss，不传默认 00:00:00。（仅对香港万事达卡，新加坡 VISA 卡及银联卡有效） |
inactiveTime | String | N | 失效时间 | 格式 HH:mm:ss，不传默认 23:59:59。（仅对香港万事达卡，新加坡 VISA 卡及银联卡有效） |
cardLimit | Number | Y | 额度 | 小数，对应卡币种。 |
minAuthAmount | Number | Y | 单次授权金额下限 | 小数， 对应卡币种。 （预付费卡，此字段不生效） |
maxAuthAmount | Number | Y | 单次授权金额上限 | 小数，对应卡币种。 （预付费卡，此字段不生效） |
maxAuthTimes | Number | Y | 授权次数上限 | 整数。1：单次卡，-1：不限次数。 |
cardCloseUsage | Number | N | 自动注销百分比 | 整数，范围0-100，默认0。当已清算金额占额度比大于等于此值，卡会被自动注销。 特殊值 0：卡片不会自动注销。（预付费卡，此字段不生效） |
supportedMccGroup | String | Y | 接受的 MCC 组 | 接受的商户类别组名，由 TripLink 定义。 非此商户类别组请求的交易会被拒绝。 |
supportedMid | String | N | 接受的商户 ID | 非此商户请求的交易会被拒绝。 |
supportedAcquirerId | String | N | 接受的收单行 ID | 非此收单行请求的交易会被拒绝。 |
multipleCurrencyCard | Boolean | N | 是否允许非卡币种交易 | 默认true。 |
allow3ds | Boolean | N | 是否接受 3DS 交易 | 默认true。（仅香港万事达卡生效） |
cardProductCode | String | Y | 卡产品 | 枚举值，详见卡分类层次下拉框。 |
cardType | String | Y | 卡类型 | 枚举值，详见卡分类层次下拉框。 |
cardLabel | String | Y | 卡组织 | 枚举值，详见卡分类层次下拉框。 |
cardBin | String | N | 发卡机构识别号 | 可指定开卡卡 BIN 段，请联系 TripLink 提供。 |
quoteId | String | N | 汇率 ID | 查询汇率 返回的汇率 ID。 若有效则以此汇率兑换，若无效则以实时汇率兑换。 （仅卡产品为 C05 时生效） |
timeZone | string | N | 卡时区 | 卡生效与失效日期时区，格式举例： 中国标准时间 GMT+08:00，北美东部标准时间 GMT-05:00。默认值可在商户系统/设置/全局参数处配置。 |
userReferenceMap | Object | N | 用户自定义字段 | String键值对，共20个键可选。范围 useRef1Txt-useRef20Txt。 |
TripLink 仅会保存和展示用户自定义字段，没有业务逻辑与此相关。
📋卡分类层次▶
📋卡分类层次详情▶
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
cardLogId | String | 卡 ID | TripLink 专用卡标识。 |
cardNum | String | 卡号 | 16位卡号。 |
cardExpirationDate | String | 有效期 | 格式 yyMM。 |
cvv2 | String | 卡 CVV2 | 安全码。 |
cardType | String | 卡品牌 | |
cardLabel | String | 卡组织 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
修改卡
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardLogId | String | Y | 卡 ID | TripLink 专用卡标识。 |
activeDate | String | N | 生效日期 | 格式 yyyy-MM-dd。 |
inactiveDate | String | N | 失效日期 | 格式 yyyy-MM-dd。 |
activeTime | String | N | 生效时间 | 格式 HH:mm:ss。（仅对香港万事达卡，新加坡 VISA 卡及银联卡有效） |
inactiveTime | String | N | 失效时间 | 格式 HH:mm:ss。（仅对香港万事达卡，新加坡 VISA 卡及银联卡有效） |
cardLimit | Number | N | 额度 | 小数，对应卡币种。 （预付费卡，此字段不生效） |
minAuthAmount | Number | N | 单次授权金额下限 | 小数，对应卡币种。 （预付费卡，此字段不生效） |
maxAuthAmount | Number | N | 单次授权金额上限 | 小数，对应卡币种。 （预付费卡，此字段不生效） |
cardCloseUsage | Number | N | 自动注销百分比 | 整数，范围0-100，默认0。当已清算金额占额度比大于等于此值，卡会被自动注销。 特殊值 0：卡片不会自动注销。（预付费卡，此字段不生效） |
supportedMccGroup | String | N | 接受的 MCC 组 | 接受的商户类别组名，由 TripLink 定义。 非此商户类别组请求的交易会被拒绝。 |
supportedMid | String | N | 接受的商户 ID | 非此商户请求的交易会被拒绝。 |
supportedAcquirerId | String | N | 接受的收单行 ID | 非此收单行请求的交易会被拒绝。 |
multipleCurrencyCard | Boolean | N | 是否允许非卡币种交易 | |
allow3ds | Boolean | N | 是否接受 3DS 交易 | （仅香港万事达卡生效） |
timeZone | string | N | 卡时区 | 卡生效与失效日期时区，格式举例： 中国标准时间 GMT+08:00，北美东部标准时间 GMT-05:00。默认值可在商户系统/设置/全局参数处配置。 |
userReferenceMap | Object | N | 用户自定义字段 | String键值对，共20个键可选。范围 useRef1Txt-useRef20Txt。 |
TripLink 仅会保存和展示用户自定义字段，没有业务逻辑与此相关。
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
cardLogId | String | 卡 ID | TripLink 专用卡标识。 |
cardNum | String | 卡号 | 16位卡号。 |
cardExpirationDate | String | 卡有效期 | 格式yyMM。 |
cvv2 | String | 卡 CVV2 | 安全码。 |
userReferenceMap | Object | 用户自定义字段 | String键值对，共20个键可选。范围 useRef1Txt-useRef20Txt。 |
TripLink 仅会保存和展示用户自定义字段，没有业务逻辑与此相关。
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
充值卡
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardLogId | String | Y | 卡 ID | TripLink 专用卡标识。 |
rechargeAmount | Number | Y | 充值金额 | 小数，对应卡币种。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
提现卡
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardLogId | String | Y | 卡 ID | TripLink 专用卡标识。 |
withdrawAmount | Number | Y | 提现金额 | 小数，对应卡币种。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
锁定卡
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardLogId | String | Y | 卡 ID | TripLink 专用卡标识。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
解锁卡
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardLogId | String | Y | 卡 ID | TripLink 专用卡标识。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
注销卡
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardLogId | String | Y | 卡 ID | TripLink 专用卡标识。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
查询卡
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardLogId | String | Y | 卡 ID | TripLink 专用卡标识。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
customerId | String | 客户 ID | 同请求头。 |
cardLogId | String | 卡 ID | TripLink 专用卡标识。 |
cardCurrencyCode | String | 卡币种 | ISO 4217 货币编号，3位数字。 |
settlementCurrencyCode | String | 结算币种 | ISO 4217 货币编号，3位数字。 |
activeDate | String | 生效日期 | 格式yyyy-MM-dd。 |
inactiveDate | String | 失效日期 | 格式yyyy-MM-dd。 |
activeTime | String | 生效时间 | 格式 HH:mm:ss。 |
inactiveTime | String | 失效时间 | 格式 HH:mm:ss。 |
cardLimit | Number | 额度 | 小数 ，对应卡币种。 |
minAuthAmount | Number | 单次授权金额下限 | 小数，对应卡币种。 （预付费卡，此字段不生效） |
maxAuthAmount | Number | 单次授权金额上限 | 小数，对应卡币种。 （预付费卡，此字段不生效） |
maxAuthTimes | Number | 授权次数上限 | 整数。1：单次卡，-1：不限次数。 |
cardCloseUsage | Number | 自动注销百分比 | 整数，范围0-100，默认0。当已清算金额占额度比大于等于此值，卡会被自动注销。 特殊值 0：卡片不会自动注销。（预付费卡，此字段不生效） |
supportedMccGroup | String | 接受的 MCC 组 | 接受的商户类别组名，由 TripLink 定义。 非此商户类别组请求的交易会被拒绝。 |
supportedMid | String | 接受的商户 ID | 非此商户请求的交易会被拒绝。 |
supportedAcquirerId | String | 接受的收单行 ID | 非此收单行请求的交易会被拒绝。 |
multipleCurrencyCard | Boolean | 是否允许非卡币种交易 | |
allow3ds | Boolean | 是否接受 3DS 交易 | 仅香港万事达卡生效 |
applyTime | String | 申请日期 | 格式yyyy-MM-dd。 |
status | String | 卡状态 | NORM：正常，SUSP：锁定，CLOP：预销卡，CLOS：销卡。 |
cardNum | String | 卡号 | 16位卡号。 |
cardExpirationDate | String | 卡有效期 | 格式yyMM。 |
cvv2 | String | 卡 CVV2 | 安全码。 |
availableBalance | Number | 可用余额 | 小数，对应卡币种。 |
authorizeAmount | Number | 待入账金额 | 小数，对应卡币种。 |
settlementAmount | Number | 已入账金额 | 小数，对应卡币种。 |
cardLabel | String | 卡组织 | 枚举值，范围MasterCard，VISA。 |
cardType | String | 卡类型 | 枚举值，范围GWTTP，MCO，USDVCC等。 |
timeZone | string | 卡时区 | 卡生效与失效日期时区，格式举例： 中国标准时间 GMT+08:00，北美东部标准时间 GMT-05:00。默认值可在商户系统/设置/全局参数处配置。 |
userReferenceMap | Object | 用户自定义字段 | String键值对，共20个键可选。范围 useRef1Txt-useRef20Txt。 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
查询账户额度
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
customerId | String | 客户 ID | 同请求头。 |
list | Array | 账户信息 | 详见Account。 |
Account
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
accountType | String | 账户类型 | CREDIT：贷记账户；DEBIT：借记账户；CCP_ACCT：换汇账户。 |
accountCurrency | String | 账户币种 | ISO 4217 货币编号，3位数字。 |
accountAmount | Number | 账户额度 | 仅账户类型为CREDIT时有值。小数，对应账户币种。 |
remainAccountAmount | Number | 剩余账户额度 | 小数，对应账户币种。 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
查询授权交易
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardLogId | String | Y | 卡 ID | TripLink 专用卡标识。 |
orderNo | String | N | 订单号 | |
transactionStatus | String | N | 交易状态 | 枚举值：1-交易成功 2-交易失败。 |
transactionCode | String | N | 交易类型 | 枚举值：6810-消费授权 6820-授权查询 6510-退款授权 6930-消费授权冲正 6940-退款授权冲正。 |
transactionStartTime | String | N | 起始时间 | 格式：yyyy-MM-dd HH:mm:ss。 |
transactionEndTime | String | N | 截止时间 | 格式：yyyy-MM-dd HH:mm:ss。 |
pageNo | Number | N | 分页页码 | 整数，取值范围[1,100],默认值为1。 |
pageSize | Number | N | 分页条数 | 整数，取值范围[1,100],默认值为5。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
cardLogId | String | 卡 ID | TripLink 专用卡标识。 |
count | Number | 交易数量 | 整数，本次查询返回的交易数据量。 |
more | Boolean | 更多数据 | 是否还有更多的分页数据 true表示本次请求查询条件下有更多的分页数据。 |
transactionData | Array | 授权交易 | 详见AuthTransaction。 |
📋结果码▶
AuthTransaction
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
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-非授权释放交易 |
📋授权类型▶
📋授权响应码（6810 消费授权）▶
📋授权响应码（6510 退款授权）▶
📋授权响应码（6930 消费授权冲正）▶
📋授权响应码（6940 退款授权冲正）▶
📋授权响应码（6820 授权查询）▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
查询清算交易
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
cardLogId | String | Y | 卡 ID | TripLink 专用卡标识。 |
settlementStartTime | String | Y | 起始日期 | 格式yyyy-MM-dd HH:mm:ss。 |
settlementEndTime | String | Y | 截止日期 | 格式yyyy-MM-dd HH:mm:ss。 |
pageNo | Number | N | 分页页码 | 整数，取值范围[1,100],默认值为1。 |
pageSize | Number | N | 分页条数 | 整数，取值范围[1,100],默认值为5。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
cardLogId | String | 卡 ID | TripLink 专用卡标识。 |
count | Number | 交易数量 | 整数，本次查询返回的交易数据量。 |
more | Boolean | 更多数据 | 是否还有更多的分页数据 true表示本次请求查询条件下有更多的分页数据。 |
settlementData | Array | 清算交易 | 详见SettlementTransaction。 |
📋结果码▶
SettlementTransaction
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
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 | 商户所在国家 | ISO 3166 国家代码，3位字母。（可能为空值） |
posMerchantCity | String | 商户所在城市 | |
posAcquirerID | String | 收单行 ID | |
transactionId | String | 交易关联 ID | 关联同笔交易的关联 ID |
📋清算类型▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
发起账户提现
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
paymentCurrency | String | Y | 提现币种 | ISO 4217 货币编号，3位数字。 |
paymentAmount | Number | Y | 提现金额 | 小数，对应提现币种。 |
beneficiaryAccountNo | String | Y | 收款账号 | 账户须在 TripLink 备案。 详情请联系您的客户经理。 |
beneficiaryAccountName | String | Y | 收款账户名称 | |
beneficiaryBankName | String | Y | 收款银行名称 | |
beneficiaryBankCountryCode | String | Y | 收款银行所在国家 | ISO 3166 国家代码，2位字母。 |
reference | String | Y | 附言 | 将直接传递给收款银行，长度不多于 90 字符。 仅允许英文，数字，空格和部分特殊字符 , - ()./ |
clientOrderId | String | N | 客户订单号 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
orderId | String | 订单号 | 全局唯一。 |
paymentCurrency | String | 提现币种 | ISO 4217 货币编号，3位数字。 |
paymentAmount | Number | 提现金额 | 小数，对应提现币种。 |
acceptTime | String | 受理时间 | 格式：yyyy-MM-dd HH:mm:ss。 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
查询账户提现
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
oriRequestId | String | Y | 原始请求流水号 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
orderId | String | 订单号 | 全局唯一。 |
status | String | 订单状态 | 1：处理中，2：已汇出，3审核拒绝4：汇款拒绝，5：汇款异常，6：已退票 |
paymentCurrency | String | 提现币种 | ISO 4217 货币编号，3位数字。 |
paymentAmount | Number | 提现金额 | 小数，对应提现币种。 |
beneficiaryAccountNo | String | 收款人账号 | |
beneficiaryAccountName | String | 收款人账户名称 | |
acceptTime | String | 受理时间 | 格式：yyyy-MM-dd HH:mm:ss。 |
clientOrderId | String | 客户订单号 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
查询汇率
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
sellCurrency | String | Y | 卖出币种 | ISO 4217 货币编号，3位数字。 |
buyCurrency | String | Y | 买入币种 | ISO 4217 货币编号，3位数字。 |
fxDirection | Number | Y | 交易方向 | 0：指定卖出，此时fxAmount为卖出金额；1：指定买入，此时fxAmount为买入金额。 |
fxAmount | Number | Y | 交易金额 | 小数，对应交易币种 。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
quoteId | String | 汇率 ID | 汇率唯一 ID。 |
sellCurrency | String | 卖出币种 | ISO 4217 货币编号，3位数字。 |
sellAmount | Number | 卖出金额 | 小数，对应卖出币种。 |
buyCurrency | String | 买入币种 | ISO 4217 货币编号，3位数字。 |
buyAmount | Number | 买入金额 | 小数，对应买入币种。 |
rate | Number | 汇率 | 小数。 |
expireTime | String | 失效时间 | 格式yyyy-MM-dd HH:mm:ss（时区 UTC+08:00） 。 |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
发起换汇订单
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
sellCurrency | String | Y | 卖出币种 | ISO 4217 货币编号，3位数字。 |
buyCurrency | String | Y | 买入币种 | ISO 4217 货币编号，3位数字。 |
fxDirection | Number | Y | 交易方向 | 0：指定卖出，此时fxAmount为卖出金额；1：指定买入，此时fxAmount为买入金额。 |
fxAmount | Number | Y | 交易金额 | 对应交易币种。 |
quoteId | String | N | 汇率 ID | 查询汇率 返回的汇率 ID。 若不传，则以实时汇率成交。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
orderId | String | 交易订单号 | TripLink 返回的唯一订单号。 |
acceptTime | String | 受理时间 | 格式yyyy-MM-dd HH:mm:ss。 |
sellCurrency | String | 卖出币种 | ISO 4217 货币编号，3位数字。 |
sellAmount | Number | 卖出金额 | 对应卖出币种。 |
buyCurrency | String | 买入币种 | ISO 4217 货币编号，3位数字。 |
buyAmount | Number | 买入金额 | 对应买入币种。 |
rate | Number | 汇率 | 小数。 |
quoteId | String | 汇率 ID |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。
查询换汇订单
请求体
| 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|
requestId | String | Y | 请求流水号 | 同请求头。 |
customerId | String | Y | 客户 ID | 同请求头。 |
oriRequestId | String | N | 原始请求流水号 | oriRequestId 与 orderId 其中一者必填。 |
orderId | String | N | 订单号 | oriRequestId 与 orderId 其中一者必填。 |
📋请求体示例▶
响应体
| 名称 | 类型 | 描述 | 备注 |
|---|---|---|---|
returnCode | String | 结果码 | 枚举值，6位数字，详见结果码下拉框。（非 000000表示请求处理失败） |
errorMessage | String | 结果码描述 | 详见结果码下拉框。 |
orderId | String | 交易订单号 | TripLink 返回的唯一订单号。 |
status | Number | 状态 | 0：创建中，1：成功，2：失败。 |
acceptTime | String | 受理时间 | 格式yyyy-MM-dd HH:mm:ss。 |
sellCurrency | String | 卖出币种 | ISO 4217 货币编号，3位数字。 |
sellAmount | Number | 卖出金额 | 对应卖出币种。 |
buyCurrency | String | 买入币种 | ISO 4217 货币编号，3位数字。 |
buyAmount | Number | 买入金额 | 对应买入币种。 |
rate | Number | 汇率 | 小数。 |
quoteId | String | 汇率 ID |
📋结果码▶
📋响应体示例▶
SDK 示例
📋Java SDK▶
📋PHP SDK▶
BASE_URL：API 地址；CARD_LOG_ID：卡 ID。
CUSTOMER_ID：客户 ID；CUSTOMER_PRIVATE_KEY：客户 RSA 私钥。
AES_KEY：AES 密钥；TRIPLINK_PUBLIC_KEY：TripLink RSA 公钥。