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

applyCard

POST /v1/aba/cards/applyCard

调用此接口提供必要信息（例如客户信息、卡片类型、消费限额和关联的元数据）来申请新卡。Antom 将处理这些信息并为您生成交付新卡。

结构

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

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

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


入参

requestId String  REQUIRED

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

更多信息：

  • 最大长度：32 字符

cardNickName String  

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

更多信息：

  • 最大长度：120 字符

note String  

备注办卡信息。

更多信息：

  • 最大长度：512 字符

cardBinRule String  

指定卡 BIN 规则。针对高交易量的特定商户进行定制，商户可以选择 Antom 指定的特定 binId。Antom 为商户提供选择卡 BIN 规则的能力。

更多信息：

  • 最大长度：32 字符

purpose String  

办卡目的。有效值为：

  • AIRLINE
  • LODGING

更多信息：

  • 最大长度：32 字符

metadata Map<String, String>  

以键值对格式表示的客户元数据。每个键的最大长度为 20 个字符，每个值的最大长度为 150 个字符，最多可包含 20 个键。

注意：此参数仅适用于定制化商户。

更多信息：

  • 最大长度：3096 字符

authorizationControl AuthorizationControl  

授权控制规则。

Show child parameters

出参

result Result  REQUIRED

接口调用的结果。

Show child parameters

requestId String  

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

注意：此参数仅当 result.resultStatus 为 S 时才会返回。

更多信息：

  • 最大长度：32 字符

status String  

卡申请状态。有效值为：

  • SUCCESS：申请成功。
  • PROCESSING：已申请，受理中。
  • FAIL：申请失败。

注意：此参数仅当 result.resultStatus 为 S 时才会返回。

更多信息：

  • 最大长度：32 字符

assetId String  

银行卡唯一标识符。

注意：此参数仅当 result.resultStatus 为 S 时才会返回。

更多信息：

  • 最大长度：32 字符
API Explorer

请求

URL

Method
POST
请求体

响应

响应体


结果码

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

无需进一步操作。

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

发送数值 ​1​ 或省略 allowedAuthTimes，然后使用正确的请求重试。

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

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

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

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

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

请联系 Antom 技术支持。 

CONTRACT_NOT_EXISTF合同不存在。

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

USER_NOT_EXISTF用户不存在。

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

APPLY_CARD_NUMBER_LIMITF申请卡片数量限制。

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

ACCESS_TOKEN_EXPIREDF访问令牌已过期。

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

AMOUNT_EXCEED_LIMITF交易金额超出限额。

请确认金额无误后重试。