Antom, leading provider of tailored payment solutions

inquireVirtualAccount

POST /v1/aba/accounts/inquireVirtualAccount

调用此接口获取可用的虚拟账户进行充值。

结构

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

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

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

入参

currency String  REQUIRED

遵循 ISO 4217 标准的 3 位货币代码.

更多信息:

  • 最大长度:3 字符

bankRegion String  REQUIRED

银行所在的国家或地区代码。有关更多信息,请参阅 ISO 3166 国家代码标准。

更多信息:

  • 最大长度:2 字符

出参

result Object  REQUIRED

表明此接口是否调用成功。

Show child parameters

legalName String  

商户的法定名称。

更多信息:

  • 此为幂等字段。

virtualAccountInfos Array<VirtualAccountInfo>  

虚拟账户信息列表。

Show child parameters
API Explorer

请求

URL
Method
POST
请求体

响应

响应体

结果码

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

接口调用成功,无需进一步操作。

PARAM_ILLEGALF存在非法参数

请检查请求字段(包括头部字段和正文字段)是否正确且有效。有关各接口字段的详细信息,请参见具体接口结构部分。

PROCESS_FAILF业务处理失败

通常需要人工干预。建议联系 Antom 技术支持以解决问题。

UNKNOWN_EXCEPTIONU由于未知原因导致接口调用失败

服务可能已下线,请稍后重试。如果问题仍然存在,请联系 Antom 技术支持。

REQUEST_TRAFFIC_EXCEED_LIMITU请求流量超出限制

请重新调用接口以解决问题。如果问题仍然存在,请联系 Antom 技术支持。

CURRENCY_NOT_SUPPORTF不支持的币种

请选择其他币种。请确保输入的币种正确,然后重试。

USER_NO_PERMISSIONF用户缺少必要权限

请使用其他用户重试。

USER_NOT_EXISTF用户不存在

请使用正确的用户信息重试。

CONTRACT_CHECK_FAILF合同检查失败

请确保合作伙伴已签署合同且输入信息正确。

INVALID_APIF调用的接口无效或未启用

请检查是否调用了正确的接口。

INVALID_CLIENTF客户端无效

客户端 ID 不存在或无效。

INVALID_SIGNATUREF签名无效

请确保请求已使用有效签名正确签名。

METHOD_NOT_SUPPORTEDF服务器未实现所请求的 HTTP 方法

请确保 HTTP 方法为 POST。