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（部分数据） |
📋响应码
| code | message | 备注 |
|---|---|---|
200 | succeed | 成功。 |
400 | payload decrypt failed | 无法解密数据。 |
403 | the ip is not whitelisted | 请求 IP 不在白名单。 |
405 | unsupported method | 请求方法不支持。（仅支持POST） |
406 | too many requests | 请求过于频繁。 |
407 | verify sign failed | 无法验证签名。 |
417 | the parameter is null or invalid | 请求头必填参数为空。 |
500 | （不固定） | 系统错误。 |
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 | 卡组织 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect（不固定） | 请求参数错误。 |
100001 | Reduplicative requestid | requestId重复。 |
200002 | Both MCC, MCC groups and [acquirerId,merchantId] are all empty | supportedMccGroup与（supportedMid或supportedAccquirerId）都为空。 |
200003 | Customer info not find | 客户信息不存在。 |
200007 | Global parameter not find | 客户全局配置不存在。 |
200008 | InactiveDate must be greater than activeDate | 不可交易日必须晚于可交易日。 |
200013 | Not find the mapping between the cardCurrency and settlementCurrency | 结算账户不存在。 |
200014 | AcquirerId/mid must not be empty | 收单行 ID 与商户 ID 必须同时存在。 |
200022 | Not find active pan number config | 卡号生成失败。 |
200029 | Card exists pending request | 其他操作执 行中。 |
200036 | card bin not support | 卡品牌不支持。 |
200037 | InactiveDate must submit | 卡不可交易日生成失败。 |
200038 | cardCloseUsage not be null | cardCloseUsage格式不正确。 |
200040 | Invalid global parameter (indate) | 卡有效期配置不存在。 |
200043 | mcc group is empty | supportedMccGroup为空。 |
200044 | mcc group all is not supported | supportedMccGroup不可为all。 |
200048 | （不固定） | 发卡行处理失败。 |
200060 | （不固定） | 发卡行请求参数错误。 |
201000 | Card available balance exceeds the maximum limit | 卡可用额度超过限额。 |
300004 | mcc link channel group is empty | 发卡行 MCC 组为空。 |
300005 | Trading is risky | 高风险请求。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 仅会保存和展示用户自定义字段，没有业务逻辑与此相关。
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect（不固定） | 请求参数错误。 |
100001 | Reduplicative requestid | requestId重复。 |
200001 | ActiveDate must be greater than current date（不固定） | 卡有效期错误。 |
200003 | Customer info not find | 客户信息不存在。 |
200007 | Global parameter not find | 客户全局配置不存在。 |
200009 | Effective mccGroup not find | 有效 MCC 组不存在。 |
200014 | AcquirerId/mid must not be empty | 收单行 ID 与商户 ID 必须同时存在。 |
200015 | Not find card | 卡不存在。 |
200016 | Card status is clop or clos | 卡已注销。 |
200019 | Update card limit is less than the amount of used card | 更新额度小于已用额度。 |
200029 | Card exists pending request | 其他操作执行中。 |
200032 | Not find customer global setting | 客户全局参数不存在。 |
200036 | card bin not support | 卡品牌不支持。 |
200048 | （不固定） | 发卡行处理失败。 |
200060 | （不固定） | 发卡行请求参数错误。 |
201000 | Card available balance exceeds the maximum limit | 卡可用额度超过限额。 |
300004 | mcc link channel group is empty | 发卡行 MCC 组为空。 |
300005 | Trading is risky | 高风险请求。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 | 结果码描述 | 详见结果码下拉框。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect（不固定） | 请求参数错误。 |
200003 | Customer info not find | 客户信息不存在。 |
200015 | Not find card | 卡不存在。 |
200016 | Card status is clop or clos | 卡已注销。 |
201000 | Card available balance exceeds the maximum limit | 卡可用额度超过限额。 |
300003 | Call JPM gateway error | 发卡行返回错误。 |
300004 | mcc link channel group is empty | 发卡行 MCC 组为空。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 | 结果码描述 | 详见结果码下拉框。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect（不固定） | 请求参数错误。 |
200003 | Customer info not find | 客户信息不存在。 |
200015 | Not find card | 卡不存在。 |
200016 | Card status is clop or clos | 卡已注销。 |
200019 | Update card limit is less than the amount of used card | 更新额度小于已用额度。 |
200029 | Card exists pending request | 其他操作执行中。 |
200048 | card issuer failed | 发卡行返回错误。 |
300004 | mcc link channel group is empty | 发卡行 MCC 组为空。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 | 结果码描述 | 详见结果码下拉框。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect（不固定） | 请求参数错误。 |
200003 | Customer info not find | 客户信息不存在。 |
200015 | Not find card | 卡不存在。 |
200016 | Card status is clop or clos | 卡已注销。 |
300006 | Not support suspend the card | 发卡行不支持锁定卡。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 | 结果码描述 | 详见结果码下拉框。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect（不固定） | 请求参数错误。 |
200003 | Customer info not find | 客户信息不存在。 |
200015 | Not find card | 卡不存在。 |
200016 | Card status is clop or clos | 卡已注销。 |
300007 | Not support unsuspend the card | 发卡行不支持解锁卡 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 | 结果码描述 | 详见结果码下拉框。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect（不固定） | 请求参数错误。 |
200003 | Customer info not find | 客户信息不存在。 |
200015 | Not find card | 卡不存在。 |
200016 | Card status is clop or clos | 卡已注销。 |
200025 | card status pre cancel not allow | 不允许注销卡。 |
200051 | card cancel exception | 发卡行注销卡失败。 |
200053 | Incorrect card status | 卡不在正常状态。 |
300005 | Trading is risky | 高风险请求。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect（不固定） | 请求参数错误。 |
200015 | Not find card | 卡不存在。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 | 剩余账户额度 | 小数，对应账户币种。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | input parameter is incorrect | 请求参数错误。 |
200007 | not find the account credit | 未找到账户。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 消费授权）
| responseCode | responseCodeDescription | 备注 |
|---|---|---|
0000 | Authorization Approval | 授权成功。 |
1002 | High Risk Transaction | 高风险的交易。 |
1003 | Invalid Account | 无效账号。 |
1101 | Abnormal Customer Status | 客户状态异常。 |
1102 | Card canceled | 卡片已注销。 |
1103 | Authorization Amount Error | 授权金额错误。 |
1104 | VAN Amount Limit Error | 账户余额不足。 |
1105 | Invalid Expiry Date | 无效的有效期。 |
1106 | Transaction Count Over Limit | 交易次数超过上限。 |
1107 | Invalid CVV2 | 无效的 CVV2 安全码。 |
1108 | VAN Amount Limit Error | 账户余额不足。 |
1110 | Trans Currency Not Allowed | 交易币种不支持。 |
1111 | MCC Error | MCC 商户类别错误。 |
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 credit limit | 授权金额超出账户可用余额。 |
1118 | Limited usage with abnormal card status | 卡片状态异常暂不可用。 |
1201 | Authorization already in process, please wait until the last authorization completed | 授权过于频繁。 |
1203 | Not support 3ds | 卡不支持 3DS 交易。 |
2012 | Cardholder cancels identity verification | 持卡人取消身份验证。 |
2014 | Cardholder fails to complete identity verification within the specified time | 持卡人未能在规定时间内完成身份验证。 |
2019 | Cardholder fails to complete identity verification within the specified number of attempts | 持卡人未能在规定的尝试次数内完成身份验证。 |
2022 | Merchant requests invalid information | 商户请求信息不合法。 |
2222 | Authorization decision reject | 授权决策拒绝。 |
2299 | Authorization decision downgrade reject | 授权决策降级后拒绝。 |
3004 | Abnormal Card Scheme Network | 卡组网络异常。 |
9000 | Unknow Error | 未知的错误。 |
📋授权响应码（6510 退款授权）
| responseCode | responseCodeDescription | 备注 |
|---|---|---|
0000 | Authorization Approval | 授权成功。 |
1002 | High Risk Transaction | 高风险的交易。 |
1003 | Invalid Account | 无效账号。 |
1101 | Abnormal Customer Status | 客户状态异常。 |
1107 | Invalid CVV2 | 无效的 CVV2 安全码。 |
1110 | Trans Currency Not Allowed | 交易币种不支持。 |
1111 | MCC Error | MCC 商户类别错误。 |
📋授权响应码（6930 消费授权冲正）
| responseCode | responseCodeDescription | 备注 |
|---|---|---|
0000 | Authorization Approval | 授权成功。 |
1002 | High Risk Transaction | 高风险的交易。 |
1003 | Invalid Account | 无效账号。 |
1101 | Abnormal Customer Status | 客户状态异常。 |
1105 | Invalid Expiry Date | 无效的有效期。 |
2001 | Original Transaction Unmatch | 未匹配到原始的授权交易（有冲正通知）。 |
2002 | Original Transaction Unmatch | 未匹配到原始的授权交易（无冲正通知）。 |
📋授权响应码（6940 退款授权冲正）
| responseCode | responseCodeDescription | 备注 |
|---|---|---|
0000 | Authorization Approval | 授权成功。 |
1002 | High Risk Transaction | 高风险的交易。 |
1003 | Invalid Account | 无效账号。 |
2001 | Original Transaction Unmatch | 未匹配到原始的授权交易（有冲正通知）。 |
2002 | Original Transaction Unmatch | 未匹配到原始的授权交易（无冲正通知）。 |
📋授权响应码（6820 授权查询）
| responseCode | responseCodeDescription | 备注 |
|---|---|---|
0000 | Authorization Approval | 授权成功。 |
1002 | High Risk Transaction | 高风险的交易。 |
1003 | Invalid Account | 无效账号。 |
1102 | Card canceled | 卡片已注销。 |
1118 | Limited usage with abnormal card status | 卡片状态异常暂不可用。 |
📋响应体示例▶
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。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect | 请求参数错误。 |
100007 | NOT_FIND_CARD | 卡不存在。 |
9XXXXX | （不固定） | 系统错误。 |
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 |
📋清算类型
| transactionCode | transactionType | 描述 | 借贷记 | 金额数值 |
|---|---|---|---|---|
2010 | Purchase | 消费 | DEBT | 正 |
2110 | Refund | 消费退款 | CRED | 负 |
4060 | Chargeback Release | 争议释放 | DEBT | 正 |
4160 | Chargeback | 消费争议 | CRED | 负 |
4170 | Dispute Claim | 争议请款 | DEBT | 正 |
4260 | Dispute Refund | 争议退款 | CRED | 负 |
📋响应体示例▶
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。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect | 请求参数错误。 |
150016 | RequestId is exists | 请求 ID 已存在。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 | 客户订单号 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect | 请求参数错误。 |
150017 | Order is not exists | 订单不存在。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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）。 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect | 请求参数错误。 |
100006 | No rate | 汇率不存在。 |
100010 | account currency not enough | 账户余额不足。 |
100017 | customer product is not support | 产品不支持。 |
120034 | RequestId is exists | 请求id已存在。 |
120035 | Fx info not match quote info | 换汇信息与询价信息不匹配。 |
120037 | The exchange amount is not within the limit | 换汇金额不在限制范围内。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 |
📋结果码
| returnCode | errorMessage | 备注 |
|---|---|---|
000000 | Success | 成功。 |
100000 | Input parameter is incorrect | 请求参数错误。 |
120036 | Fx order not found | 换汇订单不存在。 |
9XXXXX | （不固定） | 系统错误。 |
📋响应体示例▶
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 公钥。