updateCardLimit需要签名验签
集成商可调用此接口更新万里付卡片限额,包括日最大限额、月最大限额,以及单笔交易最大限额。
报文结构
万里汇接口报文结构包括:请求头、请求体、响应体。
请求头
入参
assetId String REQUIRED
卡资产ID。
dailyLimitMax Long REQUIRED
日最大限额,为基于当前货币最小单位的数额。
monthlyLimitMax Long REQUIRED
月最大限额,为基于当前货币最小单位的数额。
perTransactionLimitMax Long REQUIRED
单笔交易最大限额,为基于当前货币最小单位的数额。
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_EXIT | F | Asset not exit. | 检查资产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. | 当前授权关系不存在,请联系万里汇技术支持检查授权关系。 |