updateCardStatus

2026-03-04 14:03

POST /ams/api/v1/aba/cards/updateCardStatus

此 API 用于更新卡的状态，如冻结、解冻或取消卡，通常用于安全地管理卡的生命周期并确保根据客户请求或防欺诈需求进行适当的状态转换。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：

注意：将每个字段（除数组外）的数据类型设置为字符串。这意味字段值必须使用双引号（" "）括起来。例如：

如果字段的数据类型为整数属性，且其值为 20，设置为 "20"。
如果字段的数据类型为布尔属性，且其值为 true，设置为 "true"。

入参

requestId String REQUIRED

针对本次请求，由商户指定的唯一请求号。

更多信息：

最大长度：32 字符

assetId String REQUIRED

银行卡的唯一标识符。

更多信息：

最大长度：32 字符

operateType String REQUIRED

操作类型。有效值如下：

FREEZE：冻结卡。
UNFREEZE：解冻卡。
CANCEL：删除卡。

更多信息：

最大长度：16 字符

notifyUrl String

通知地址。

注意：如果您想要接收异步通知，请指定此参数。您还可以在 Antom Dashboard 中设置接收结果通知的 URL。如果在请求和 Antom Dashboard 中都指定了 URL，则请求中指定的值优先。

更多信息：

最大长度：256 字符

出参

result Result REQUIRED

API 调用的结果。

Show child parameters

status String

表示本次更新操作的结果。有效值如下：

SUCCESS：表示申请成功。
FAIL：表示申请失败。

注意：当且仅当 result.resultStatus 的值为 S 时，才会返回该参数。

更多信息：

最大长度：16 字符

requestId String

针对本次请求，由商户指定的唯一请求号。

更多信息：

最大长度：32 字符

API Explorer

请求

URL

Method

POST

请求体

响应

响应体

Result/Error codes

结果码	值	结果码信息	行动建议
SUCCESS	S	成功。	无需其他操作。
PARAM_ILLEGAL	F	存在非法参数。例如，非数字输入和无效的日期。	检查并验证当前接口所需的请求字段（包括头部字段和正文字段）是否正确传递并有效。各个 API 的字段详细信息请参阅具体 API 结构部分。
PROCESS_FAIL	F	发生了常见的业务失败，请勿重试。	通常需要人工干预，建议您联系 Antom 技术支持以排查问题。
UNKNOWN_EXCEPTION	U	由于未知原因，接口调用失败。	服务中断，请稍后重试。如果问题未解决，请联系 Antom 技术支持。
RISK_REJECT	F	由于风险控制，交易无法进一步处理。	请联系 Antom 技术支持。
CONTRACT_NOT_EXIST	F	合同检查失败。	请联系 Antom 技术支持以了解合同状态并重试。
USER_NOT_EXIST	F	用户不存在。	使用正确的用户信息重试。
ASSET_NOT_EXIST	F	资产不存在。	验证资产 ID 是否正确并重试。
ASSET_STATUS_ERROR	F	资产状态错误。	检查您的资产状态并重试。
ACCESS_TOKEN_EXPIRED	F	该授权不存在。	刷新令牌界面以重新获取访问令牌，或联系 Antom 技术支持处理。