notifyTransfer

2026-06-16 14:22

Antom 会通过此接口发送转账结果通知。您可以在调用 createTransfer 接口时，通过指定 transferToDetail.transferNotifyUrl 字段，或在门户配置中设置接收转账通知的 URL。

结构

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

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

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

入参

transferRequestId String REQUIRED

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

更多信息：

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

transferId String REQUIRED

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

更多信息：

最大长度：64 字符

transferResult Object REQUIRED

表明转账结果。

Show child parameters

transferFinishTime Datetime

转账到账时间。

更多信息：

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

transferFromDetail Object REQUIRED

买家发起的转账信息。

Show child parameters

transferToDetail Object REQUIRED

收款人转账详情。

Show child parameters

businessSceneCode String

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

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

更多信息：

最大长度：64 字符

出参

result Object REQUIRED

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

Show child parameters

API Explorer

请求

请求体

响应

响应体

结果处理逻辑

对于不同的请求结果，需要采取不同的操作。请参阅以下列表以获取详细信息：

结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	成功。	转账已成功创建并正在处理中。调用转账查询接口获取转账结果。
PROCESS_FAIL	F	处理失败	通常需要人工干预。建议联系 Antom 技术支持以解决问题。
UNKNOWN_EXCEPTION	U	未知异常	服务可能已下线，请稍后重试。如果问题仍然存在，请联系 Antom 技术支持。

transferResult.resultCode

结果码	值	结果码信息	行动建议
SUCCESS	S	成功	无需进一步操作。
PROCESS_FAIL	F	处理失败	通常需要人工干预。建议联系 Antom 技术支持以解决问题。

结果状态	描述
`S`	表示接口调用成功。
`F`	表明接口调用失败。如需了解失败原因，请参阅结果/错误码表。
`U`	表明接口调用结果未知。建议再次调用此接口。