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

inquireCardDetail

POST /v1/aba/cards/inquireCardDetail

调用此接口可通过银行卡的唯一标识符获取特定银行卡详细信息，从而使您的业务系统准确查询卡片状态、交易记录、信用额度及元数据等信息，以支持客户服务、账户管理或故障排查等场景。

结构

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

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

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


入参

assetId String  REQUIRED

银行卡唯一标识符。

更多信息：

  • 最大长度：32 字符

出参

result Result  REQUIRED

接口调用的结果。

Show child parameters

assetId String  

银行卡唯一标识符。

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

更多信息：

  • 最大长度：32 字符

cardNickName String  

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

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

更多信息：

  • 最大长度：120 字符

cardStatus String  

银行卡状态。有效值为

  • ACTIVE：该卡已激活，可正常使用。
  • FROZEN：该卡已冻结，暂时不可使用。
  • CANCEL：该卡已注销。

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

更多信息：

  • 最大长度：32 字符

maskedCardNo String  

脱敏卡号。

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

更多信息：

  • 最大长度：32 字符

cardBrand String  

卡品牌。值为 MASTERCARD。

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

更多信息：

  • 最大长度：32 字符

createdTime Datetime  

银行卡创建时间。

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

更多信息：

  • 最大长度：32 字符
  • 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

updatedTime Datetime  

银行卡更新时间。

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

更多信息：

  • 最大长度：32 字符
  • 值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

purpose String  

办卡目的。有效值为：

  • AIRLINE
  • LODGING

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

更多信息：

  • 最大长度：32 字符

note String  

备注办卡信息。

更多信息：

  • 最大长度：512 字符

metadata Map<String, String>  

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

更多信息：

  • 最大长度：3096 字符

authorizationControl AuthorizationControl  

授权控制规则。

Show child parameters

cardholderInfo CardholderInfo  REQUIRED

持卡人信息。

Show child parameters
API Explorer

请求

URL

Method
POST
请求体

响应

响应体


结果码

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

无需进一步操作。

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

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

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

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

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

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

CONTRACT_NOT_EXISTF合同不存在。

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

USER_NOT_EXISTF用户不存在。

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

ACCESS_TOKEN_EXPIREDF访问令牌已过期。

刷新令牌接口以重新获取访问令牌，或联系技术支持以解决该问题。

ASSET_NOT_EXISTF资产不存在。

请联系 Antom 技术支持获取详细原因。