Antom, leading provider of tailored payment solutions
Contact Us
登 录

updateCard

POST /v1/aba/cards/updateCard

调用此接口更新现有卡片的特定属性，包括信用额度、持卡人资料、有效期及权限设置（当前卡片状态将保持不变）。该功能可实现卡片配置的无缝定制，满足客户偏好需求，并提供持续运营维护支持。

结构

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

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

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


入参

assetId String  REQUIRED

银行卡唯一标识符。

更多信息：

  • 最大长度：32 字符

requestId String  REQUIRED

商户为本次请求指定的唯一请求 ID。

更多信息：

  • 最大长度：32 字符

cardNickName String  

由商户定义的卡昵称，帮助商户更方便地管理多张卡。

更多信息：

  • 最大长度：120 字符

note String  

备注办卡信息。

更多信息：

  • 最大长度：512 字符

purpose String  

办卡目的。有效值为：

  • AIRLINE
  • LODGING

更多信息：

  • 最大长度：32 字符

metadata Map<String, String>  

以键值对格式表示的客户元数据。

This parameter is only for customised merchants.

更多信息：

  • 最大长度：3096 字符

authorizationControl AuthorizationControl  

授权控制规则。

Show child parameters

出参

result Result  REQUIRED

接口调用的结果。

Show child parameters

requestId String  

由商户为本次请求指定的唯一请求 ID。

注意: 此字段仅在 result.resultStatus 的值为 S 时返回。

更多信息：

  • 最大长度：32 字符

status String  

表示此次更新操作的结果。有效值为：

  • ​SUCCESS​：表示更新成功。
  • ​FAIL​：表示更新失败。

注意: 此字段仅在 result.resultStatus 的值为 S 时返回。

更多信息：

  • 最大长度：16 字符
API Explorer

请求

URL

Method
POST
请求体

响应

响应体


结果码

结果码值结果码信息行动建议
SUCCESSS成功。

无需进一步操作。

PARAM_ILLEGALF缺少必需的参数，或者存在非法参数。例如，非数字输入、无效的日期，或者参数的长度和类型错误。

检查并验证当前接口所需的请求字段（包括头部字段和正文字段）是否正确传递并有效。

PROCESS_FAILF发生了常见的业务失败。

请不要重试。建议您联系 Antom 技术支持以排查问题。  

UNKNOWN_EXCEPTIONU由于未知原因，接口调用失败。

再次调用接口以解决问题。如果问题未解决，请联系 Antom 技术支持。

RISK_REJECTF由于风险控制，交易无法进一步处理。如果用户已为交易付款，交易将被退款。

请联系 Antom 技术支持。 

CONTRACT_NOT_EXISTF合同不存在。

请确保合作方已签署合同且输入信息准确无误。

USER_NOT_EXISTF用户不存在。

请使用正确的用户信息重试。如问题未解决，请联系 Antom 技术支持获取详细原因。

ASSET_NOT_EXISTF资产不存在。

请检查 assetID 后重试。

ASSET_STATUS_ERRORF资产状态错误。

请检查资产状态后重试。

ACCESS_TOKEN_EXPIREDF访问令牌已过期。

请刷新令牌以获取新访问令牌，或联系 Antom 技术团队获取帮助。

AMOUNT_EXCEED_LIMITF交易金额超出限额。

请确认金额无误后重试。