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
表明转账结果。
transferFromDetail Object REQUIRED
买家发起的转账信息。
注意:仅当 result.resultStatus 的值为 S 时,才会返回此字段。
transferToDetail Object REQUIRED
收款人转账详情。
注意:仅当 result.resultStatus 的值为 S 时,才会返回此字段。
出参
result Object REQUIRED
表示是否成功收到来自 Antom 的通知。
API Explorer
请求
响应
结果码
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | 成功。 | 接口调用成功。 |
| PROCESS_FAIL | F | 发生了一般的业务失败。 | 通常需要人工干预。建议联系 Antom 技术支持以解决问题。 |
| UNKNOWN_EXCEPTION | U | 接口调用因未知原因失败。 | 服务可能不可用,请稍后重试。如果问题仍然存在,请联系 Antom 技术支持。 |
transferResult.resultCode
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | 成功 | 转账已成功创建并正在处理中。调用 inquirePayout 接口查询转账结果。 |
| PROCESS_FAIL | F | 发生了一般的业务失败,请勿重试。 | 通常需要人工干预。建议您联系 Antom 技术支持以解决问题。 |
| UNKNOWN_EXCEPTION | U | 接口调用失败,原因未知。 | 服务可能不可用,请稍后重试。如果问题仍然存在,请联系 Antom 技术支持。 |
| USER_ACCOUNT_ABNORMAL | F | 用户账户状态异常。 | 尝试使用其他用户重试。如果问题仍然存在,请联系 Antom 技术支持以获取更多详细信息。 |
| AMOUNT_EXCEED_LIMIT | F | 金额超出限制。 | 确保提交的金额正确并重试。 |
| RISK_REJECT | F | 由于风控原因,转账被拒绝。 | 提示用户请求因风控失败而被拒绝。 |
| ORDER_IS_CLOSED | F | 订单已关闭。 | 尝试使用其他付款订单重试。 |
| ORDER_IS_REVERSED | F | 订单已被撤销。 | 尝试使用其他付款订单重试。 |
| ORDER_NOT_FOUND | U | 未找到订单。 | 尝试使用正确的订单信息重试。 |
| CARD_INFO_NOT_MATCH | F | 卡信息不匹配。 | 尝试使用其他付款订单重试。 |
| BALANCE_NOT_ENOUGH | F | 余额不足。 | 确保余额充足并重试。 |