Antom, leading provider of tailored payment solutions

notifyPayout

Antom 通过此接口发送出款结果通知。商户可在调用 createPayout 接口时通过 transferToDetail.transferNotifyUrl 字段指定接收通知的 URL,或在 Antom 门户中设置该地址。

商户需确认已收到通知。具体操作请参见 结果处理逻辑。

结构

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

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

  • 如果字段的数据类型为整数属性,且其值为 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

买家发起的转账信息。

注意:仅当 result.resultStatus 的值为 ​S​ 时,才会返回此字段。

Show child parameters

transferToDetail Object  REQUIRED

收款人转账详情。

注意:仅当 result.resultStatus 的值为 S 时,才会返回此字段。

Show child parameters

出参

result Object  REQUIRED

表示是否成功收到来自 Antom 的通知。

Show child parameters
API Explorer

请求

请求体

响应

响应体

结果码

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

接口调用成功。

PROCESS_FAILF发生了一般的业务失败。

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

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

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

transferResult.resultCode

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

转账已成功创建并正在处理中。调用 inquirePayout 接口查询转账结果。

PROCESS_FAILF发生了一般的业务失败,请勿重试。

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

UNKNOWN_EXCEPTIONU接口调用失败,原因未知。

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

USER_ACCOUNT_ABNORMALF用户账户状态异常。

尝试使用其他用户重试。如果问题仍然存在,请联系 Antom 技术支持以获取更多详细信息。

AMOUNT_EXCEED_LIMITF金额超出限制。

确保提交的金额正确并重试。

RISK_REJECTF由于风控原因,转账被拒绝。

提示用户请求因风控失败而被拒绝。

ORDER_IS_CLOSEDF订单已关闭。

尝试使用其他付款订单重试。

ORDER_IS_REVERSEDF订单已被撤销。

尝试使用其他付款订单重试。

ORDER_NOT_FOUNDU未找到订单。

尝试使用正确的订单信息重试。

CARD_INFO_NOT_MATCHF卡信息不匹配。

尝试使用其他付款订单重试。

BALANCE_NOT_ENOUGHF余额不足。

确保余额充足并重试。