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

createPayout

POST /v1/aba/funds/createPayout

调用此接口可将资金从 Antom 全球商家账户提现至蚂蚁集团以外的账户（如银行账户、支付宝账户等）。

结构

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

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

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

入参

transferRequestId String  REQUIRED

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

更多信息：

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

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

transferOrderAddition Object  

扣款补充信息（包括付款方与收款方等详情）。

Show child parameters

businessSceneCode String  REQUIRED

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

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

注意：

  • 当 transferToDetail.transferToAmount.currency 的值为 ​CNY​ 时需填写此参数。
  • 若选择​ THIRD_PARTY_PAYOUT​，请联系销售团队。

出参

result Object  REQUIRED

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

Show child parameters

transferRequestId String  

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

更多信息：

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

transferId String  

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

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

更多信息：

  • 最大长度：64 字符

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合同检查失败。

在重试前，请与 Antom 确认合同状态。

CARD_INFO_NOT_MATCHF卡片信息不匹配。

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