Antom, leading provider of tailored payment solutions
Contact Us
登 录

consultPayout

POST /v1/aba/funds/consultPayout

调用此接口可查询预期打款结果，以便在发起打款前调用 createPayout 接口。

结构

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

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

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

入参

transferFromDetail Object  REQUIRED

发起人提交的转账详细信息。

注意：

  • 如果 transferFromAmount 的值大于0，则 transferToAmount 参数的值必须设置为 ​0​。此时，费用将从transferFromAmount 中扣除。
  • 最终从 Antom 全球商家账户中扣除的金额将等于 transferFromAmount 的值。收款人最终收到的金额将为transferFromAmount 的值减去扣除的费用。
Show child parameters

transferToDetail Object  REQUIRED

发起人转账详情。

注意：

  • 如果 transferToAmount 的值大于0，则 transferFromAmount 必须设置为 0。在这种情况下，费用将添加到 transferToAmount 中。
  • 最终从 Antom 全球商家账户中扣除的金额将是 TransferToAmount 的值加上费用。受益人最终收到的金额将等于 transferToAmount。
Show child parameters

businessSceneCode String  REQUIRED

打款业务场景类型。有效值包括：

  • ​THIRD_PARTY_PAYOUT​：表示向第三方银行账户打款（可为企业账户或个人账户）。
  • ​SAME_NAME_PAYOUT​：表示向同名账户打款。

注意：若选择 THIRD_PARTY_PAYOUT，请联系销售团队。

transferOrderAddition Object  

扣款补充信息（包括发送方和收款方等详情）。

Show child parameters

出参

result Object  REQUIRED

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

Show child parameters

transferFromDetail Object  

发起人发起的转账信息。

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

Show child parameters

transferToDetail Object  

收款人转账详情。

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

Show child parameters
API Explorer

请求

URL

Method
POST
Case
Transfer to the same name user
请求体

响应

响应体

结果码

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

接口调用成功，无需进一步操作。

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

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

REQUEST_TRAFFIC_EXCEED_LIMITU请求流量超出限制。

再次调用接口以解决问题。如果问题仍然存在，请联系 Antom 技术支持。

PARAM_ILLEGALF存在非法参数。例如，非数字输入或无效日期。

检查并验证请求字段（包括头部字段和正文字段）是否正确且有效。有关每个接口的字段详情，请参阅具体的接口结构部分。

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

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

INVALID_APIF调用的接口无效或未激活。

检查是否调用了正确的接口。

INVALID_CLIENTF客户端无效。

客户端 ID 不存在或无效。

INVALID_SIGNATUREF签名无效。

确保请求已使用有效的签名正确签名。

METHOD_NOT_SUPPORTEDF服务器不支持请求的 HTTP 方法。

确保 HTTP 方法为 POST。

CONTRACT_NOT_EXISTF合同不存在。

确保商户已签署合同且输入正确。

FEE_EXCEPTIONU接口调用因费用相关问题失败。

检查参数并再次调用接口以解决问题。如果问题仍然存在，请联系 Antom 技术支持。

UN_SUPPORT_BUSINESSF不支持的业务。

使用了无效参数。请使用正确的信息重试。

USER_NO_PERMISSIONF用户没有权限。

使用其他用户信息重试。

CURRENCY_NOT_SUPPORTF不支持的货币。

确保货币输入正确并重试。

USER_NOT_EXISTF用户不存在。

使用正确的用户信息重试。

USER_ACCOUNT_ABNORMALF用户账户状态异常。

使用不同的用户重试。如果问题仍然存在，请联系 Antom 技术支持以获取更多详细信息。

USER_STATUS_ABNORMALF用户状态异常。

用户状态异常。使用另一张卡重试。

CONTRACT_CHECK_FAILF合同检查失败。

确保商户已签署合同且输入正确。

CARD_INFO_NOT_MATCHF卡片信息不匹配。

使用正确的卡片信息重试。