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

inquireCard

POST /v1/aba/cards/inquireCard

调用此接口获取指定客户或账户关联的银行卡详情列表，可通过提供卡片昵称、状态或卡号末四位等相关参数进行查询。此功能可帮助您高效管理卡片、监控状态并支持运营决策。

结构

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

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

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


入参

pageNumber Integer  REQUIRED

页码。

注意：传入低于 1 的值或非整数值时无效并返回错误码PARAM_ILLEGAL。

更多信息：

  • 值范围： [1, +∞)

pageSize Integer  REQUIRED

每页显示条目数量。

注意：传入 1-50 以外的值或非整数值时无效并返回错误码PARAM_ILLEGAL。

更多信息：

  • 值范围： [1, 50]

lastFourDigits String  

银行卡号后四位。

更多信息：

  • 最大长度：4 字符

cardStatus String  

银行卡状态。有效值为

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

更多信息：

  • 最大长度：32 字符

cardNickName String  

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

更多信息：

  • 最大长度：120 字符

出参

result Result  REQUIRED

接口调用的结果。

Show child parameters

totalCount Integer  

符合查询条件的银行卡总数。

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

totalPageNumber Integer  

总页数。

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

currentPageNumber Integer  

当前页码。

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

cardList Array<CardList>  

卡列表。

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

更多信息：

  • 最多可包含元素个数：50
Show child parameters
API Explorer

请求

URL

Method
POST
请求体

响应

响应体


结果码

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

无需进一步操作。

PARAM_ILLEGALFPageNumber 小于 1，或 pageSize 在 1-50 之外，或者这两个值的字段类型不是 Integer。

请更正分页值并重试。请勿重复发送相同的无效请求。

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

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

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

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

CONTRACT_NOT_EXISTF合同不存在。

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

USER_NOT_EXISTF用户不存在。

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

ACCESS_TOKEN_EXPIREDF访问令牌已过期。

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