inquirePayout
调用此接口查询资金出款结果。
- 请设置超时机制以终止轮询流程,避免因未获取到明确结果而持续等待。
- 若调用 createPayout 接口超过两小时后仍未收到 Antom 通知,且调用 inquirePayout 接口时返回的 transferResult.resultCode 显示为
UNKNOWN,请立即联系 Antom 技术支持协助处理。
结构
报文由报文头和报文体组成。本文主要介绍报文体结构信息,有关报文头的结构信息,请参阅:
注意:将每个字段(除数组外)的数据类型设置为字符串。这意味字段值必须使用双引号(" ")括起来。例如:
- 如果字段的数据类型为整数属性,且其值为
20,设置为 "20"。 - 如果字段的数据类型为布尔属性,且其值为
true,设置为 "true"。
入参
transferRequestId String CONDITIONAL
商户为识别转账请求而分配的专属 ID。
注意:当 transferId 参数为空时,该字段必传。
更多信息:
- 最大长度:64 字符
transferId String
由 Antom 分配的用于标识一笔转账的专属 ID。
注意:当 transferRequestId 参数为空时,该字段必传。
更多信息:
- 最多可包含元素个数:64
出参
result Object REQUIRED
表明此接口是否调用成功。
transferResult Object REQUIRED
表明转账结果。
transferRequestId String REQUIRED
商户为识别转账请求而分配的专属 ID。
更多信息:
- 此为幂等字段。
- 最大长度:64 字符
transferId String REQUIRED
由 Antom 分配的用于标识一笔转账的专属 ID。
更多信息:
- 最大长度:64 字符
transferFinishTime Datetime
转账到账时间。
注意:只有当 result.resultStatus 的值为 S 且支付处理完毕时,才会返回该字段。
更多信息:
- 值遵循 ISO 8601 标准格式。例如,“2019-11-27T12:01:01+08:00”。
transferFromDetail Object REQUIRED
买家发起的转账信息。
注意:仅当 result.resultStatus 的值为 S 时,才会返回此字段。
transferToDetail Object REQUIRED
收款人转账详情。
注意:仅当 result.resultStatus 的值为 S 时,才会返回此字段。
请求
响应
结果码
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | 成功。 | 接口调用成功,无需进一步操作。 |
| PARAM_ILLEGAL | F | 存在非法参数。例如,非数字输入、无效日期或参数的长度和类型错误。 | 检查并确认当前接口请求字段(包括头部字段和主体字段)是否正确传递且有效。 |
| PROCESS_FAIL | F | 发生了一般业务失败,请勿重试。 | 通常需要人工干预。建议联系 Antom 技术支持解决问题。 |
| UNKNOWN_EXCEPTION | U | 由于未知原因,接口调用失败。 | 稍后重试。如果问题仍然存在,请联系 Antom 技术支持。 |
| REQUEST_TRAFFIC_EXCEED_LIMIT | U | 请求流量超出限制。 | 再次调用接口以解决问题。如果问题仍未解决,请联系 Antom 技术支持。 |
| INVALID_API | F | 调用的接口无效或未激活。 | 检查是否调用了正确的接口。 |
| INVALID_CLIENT | F | 客户端无效。 | 客户端 ID 不存在或无效。 |
| INVALID_SIGNATURE | F | 签名无效。 | 确保请求已使用有效签名正确签名。 |
| METHOD_NOT_SUPPORTED | F | 服务器不支持请求的 HTTP 方法。 | 确保 HTTP 方法为 POST。 |
transferResult.resultCode
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | 成功。 | 指示出款查询状态。 |
| PROCESSING | S | 处理中 | 请稍后再试。 |
| ORDER_NOT_FOUND | U | 订单未找到。 | 请使用正确的订单信息重试。 |
| PROCESS_FAIL | F | 发生了一般业务失败。请勿重试。 | 通常需要人工干预。建议联系 Antom 技术支持以解决问题。 |
| ORDER_IS_REVERSED | F | 订单已撤销。 | 请使用新的出款订单重试。 |
| USER_NOT_EXIST | F | 用户不存在。 | 请使用正确的用户信息重试。 |
| USER_ACCOUNT_ABNORMAL | F | 用户账户状态异常。 | 请使用其他用户重试。如果问题持续存在,请联系Antom技术支持获取更多详情。 |
| USER_STATUS_ABNORMAL | F | 用户状态异常。请使用其他卡片重试。 | 请使用其他用户重试。 |
| AMOUNT_EXCEED_LIMIT | F | 金额超过限制。 | 确保提交的金额正确并重试。 |
| RISK_REJECT | F | 因风险控制原因转账被拒绝。 | 提示用户请求因风险控制失败而被拒绝。 |
| CARD_INFO_NOT_MATCH | F | 卡信息不匹配。 | 请使用正确的卡信息重试。 |
| BALANCE_NOT_ENOUGH | F | 余额不足。 | 确保余额充足并重试。 |
| CURRENCY_NOT_SUPPORT | F | 货币不支持。 | 确保货币正确并重试。 |
| ORDER_NOT_EXIST | F | 订单不存在。 | 请使用新的订单重试。 |
| UN_SUPPORT_BUSINESS | F | 不支持的业务。 | 请使用正确的参数重试。 |
| USER_NO_PERMISSION | F | 用户没有权限。 | 检查用户权限并重试。 |
| ORDER_IS_CLOSED | F | 订单已关闭。 | 请使用新的出款订单重试。 |