inquiryTransfer

2026-06-16 14:22

POST /v1/aba/funds/inquiryTransfer

调用此接口以查询资金转账结果。

建议设置超时机制，以防止在未获得明确转账结果的情况下持续轮询。
如果您在调用 createTransfer 接口两小时后仍未收到任何来自 Antom 的通知，同时调用 inquiryTransfer 接口后在 transferResult.resultCode 中返回 UNKNOWN，请联系 Antom 技术支持寻求帮助。

结构

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

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

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

入参

transferRequestId String REQUIRED

商户为识别转账请求而分配的专属 ID。

更多信息：

最大长度：64 字符

出参

result Result REQUIRED

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

Show child parameters

transferResult Result

转账结果。

注意：只有当 result.resultStatus 的值为 S 时，才会按需返回该字段。

Show child parameters

transferRequestId String

商户为识别转账请求而分配的专属 ID。

注意：只有当 result.resultStatus 的值为 S 时，才会按需返回该字段。

更多信息：

此为幂等字段。
最大长度：64 字符

transferId String

由 Antom 分配的用于标识一笔转账的专属 ID。

注意：只有当 result.resultStatus 的值为 S 时，才会按需返回该字段。

更多信息：

最大长度：64 字符

transferFinishTime Datetime

转账到账时间。

注意：只有当 result.resultStatus 的值为 S 时，才会按需返回该字段。

更多信息：

值遵循 ISO 8601 标准格式。例如，“2019-11-27T12:01:01+08:00”。

transferFromDetail TransferFromDetail

买家发起的转账信息。

注意：只有当 result.resultStatus 的值为 S 时，才会按需返回该字段。

Show child parameters

transferToDetail TransferToDetail

收款人转账详情。

注意：只有当 result.resultStatus 的值为 S 时，才会按需返回该字段。

Show child parameters

businessSceneCode String

表示转账业务场景的代码。有效值为：

THIRD_PARTY_TRANSFER：账户间转账 (收款方的值为 ANTOM_BIZ_ACCOUNT)。

更多信息：

最大长度：64 字符

API Explorer

请求

URL

Method

POST

请求体

响应

响应体

结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	接口调用成功。	该接口调用已成功完成，无需进一步操作。
PARAM_ILLEGAL	F	存在非法参数。例如，输入非数字，或日期无效。	请检查并确认请求字段（包括头部字段和正文字段）是否正确且有效。有关各接口字段的详细信息，请参见具体的接口结构说明。
PROCESS_FAIL	F	业务处理失败，一般需要人工干预。	建议联系 Antom 技术支持以解决问题，不要重试。
UNKNOWN_EXCEPTION	U	接口调用失败，原因未知。	服务可能不可用，请稍后重试。如果问题仍然存在，请联系我们的技术支持团队。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	请求流量超出限制。	请重新调用该接口以解决问题。如果问题仍然存在，请联系我们的技术支持团队。
INVALID_API	F	调用的接口无效或未启用。	请确认是否调用了正确的接口。
INVALID_CLIENT	F	客户端无效。	客户端 ID 不存在或无效。
INVALID_SIGNATURE	F	签名无效。	请确保请求已使用有效的签名正确签名。
METHOD_NOT_SUPPORTED	F	服务器未实现所请求的 HTTP 方法。	请确保 HTTP 方法为 POST。

transferResult.resultCode

结果码	值	结果码信息	行动建议
SUCCESS	S	转账成功。	无需进一步操作。
PROCESSING	S	处理中	收到该状态表示 Antom 已接收到交易请求，但仍在处理中。这不是最终状态，您可以稍后重试查询交易状态。
PROCESS_FAIL	F	业务处理失败	通常需要人工干预。建议您联系我们的技术支持团队解决问题，不要重试。
UNKNOWN_EXCEPTION	U	未知异常	服务可能不可用，请稍后重试。如果问题仍然存在，请联系我们的技术支持团队。
USER_NOT_EXIST	F	用户不存在	请使用正确的用户信息重试。
USER_ACCOUNT_ABNORMAL	F	用户账户状态异常	请使用其他用户重试。如果问题仍然存在，请联系我们的技术支持团队获取更多详情。
AMOUNT_EXCEED_LIMIT	F	金额超出限制	请确保提交的金额正确后重试。
RISK_REJECT	F	因风控原因被拒绝	提示用户请求被拒绝的原因是风控校验未通过。
TRANSFER_IN_PROCESS	U	转账处理中	请稍后重试。
ORDER_IS_CLOSED	F	订单已关闭	请使用其他转账订单重试。
ORDER_IS_REVERSED	F	订单已撤销	请使用其他转账订单重试。
BALANCE_NOT_ENOUGH	F	余额不足	请确保余额充足后重试。
ORDER_NOT_FOUND	U	未找到订单	请使用正确的订单信息重试。