updateCardLimit需要签名验签
集成商可调用此接口更新万里付卡片限额,包括日最大限额、月最大限额,以及单笔交易最大限额。
报文结构
万里汇接口报文结构包括:请求头、请求体、响应体。
请求头
入参
assetId String REQUIRED
卡资产ID。
dailyLimitMax Long REQUIRED
日最大限额,为基于当前货币最小单位的数额。
monthlyLimitMax Long REQUIRED
月最大限额,为基于当前货币最小单位的数额。
perTransactionLimitMax Long REQUIRED
单笔交易最大限额,为基于当前货币最小单位的数额。
perCardLimitMax Long CONDITIONAL
单张万里付卡交易的最大限额,为基于当前货币最小单位的数额。此限额为持续累计,不会清零。
注意:
- 此字段为空时,默认对单张万里付卡不设置交易限额。
- 如您需要对单张万里付卡片进行限额管理,请在此字段中传入相应的值。
env Env REQUIRED
转账环境。
出参
result Result REQUIRED
代表API 接口的调用结果。
requestId String REQUIRED
针对本次更新请求,由集成商指定的唯一请求号。
此字段只有当 result.resultStatus =S
时才会按需返回。
更多信息:
- 最大长度:32 字符
currency String REQUIRED
币种,为符合ISO-4217规范的三字母货币代码。
此字段只有当 result.resultStatus =S
时才会按需返回。
更多信息:
- 最大长度:3 字符
status String REQUIRED
代表本次更新操作的结果。
取值范围为:
SUCCESS
:成功FAIL
:失败
此字段只有当 result.resultStatus =S
时才会按需返回。
API Explorer
请求
URL
请求体
响应
响应体
响应处理
集成商调用接口后,万里汇返回集成商API调用结果。result.resultStatus 取值范围为:
result.resultCode
结果码 | 值 | 结果码信息 | 行动建议 |
---|---|---|---|
SUCCESS | S | Success | |
PARAM_ILLEGAL | F | Illegal parameters exist. For example, a non-numeric input, or an invalid date. | 参考API文档页面,确认请求头和传参是否正确。 |
UNKNOWN_EXCEPTION | U | API failed due to unknown reason. | 服务器错误,若稍后重试问题依旧,联系万里汇技术支持以解决问题。 |
REPEAT_REQUEST | F | Repeat request. | 更换requestId,发起重试。 |
SYSTEM_ERROR | F | System error. | 请勿重试,联系万里汇技术支持了解详情。 |
CONTRACT_NOT_EXIST | F | The contract check has failed. | 联系万里汇技术支持了解合约状态后重试。 |
USER_NOT_EXIST | F | The user does not exist. | 使用正确的用户信息重试。 |
ASSET_NOT_EXIST | F | Asset not exist. | 检查资产ID后重试。 |
ASSET_STATUS_ERROR | F | Asset status error. | 检查资产状态后重试。 |
AMOUNT_EXCEED_MAX_LIMIT | F | The amount exceeds the limit. | 确认金额正确后重试。 |
ACCESS_TOKEN_EXPIRED | F | The access token expired. | 刷新token接口以重新获取访问令牌(access token),或联系万里汇技术支持以解决问题。 |
AUTHORIZATION_NOT_EXIST | F | The authorization does not exist. | 当前授权关系不存在,请联系万里汇技术支持检查授权关系。 |