createTransfer
调用此接口在 Antom 全球商家账户之间进行资金转账。
转账过程是异步的。调用此接口后,Antom 会立即返回响应,表示转账正在处理中。最终的转账结果将通过 notifyTransfer 接口发送给您,您也可以调用 inquiryTransfer 接口查询转账状态。
结构
报文由报文头和报文体组成。本文主要介绍报文体结构信息,有关报文头的结构信息,请参阅:
注意:将每个字段(除数组外)的数据类型设置为字符串。这意味字段值必须使用双引号(" ")括起来。例如:
- 如果字段的数据类型为整数属性,且其值为
20,设置为 "20"。 - 如果字段的数据类型为布尔属性,且其值为
true,设置为 "true"。
入参
transferRequestId String REQUIRED
商户为识别转账请求而分配的专属 ID。
更多信息:
- 此为幂等字段。
- 最大长度:64 字符
transferFromDetail Object
买家发起的转账信息。
transferToDetail Object REQUIRED
收款人转账详情。
出参
result Object REQUIRED
表明此接口是否调用成功。
transferRequestId String
商户为识别转账请求而分配的专属 ID。
更多信息:
- 此为幂等字段。
- 最大长度:64 字符
transferId String
由 Antom 分配的用于标识一笔转账的专属 ID。
注意:仅当 result.resultStatus 的值为 S 时,才会返回此字段。
更多信息:
- 最大长度:64 字符
transferFromDetail Object
买家发起的转账信息。
注意:仅当 result.resultStatus 的值为 S 时,才会返回此字段。
transferToDetail Object
收款人转账详情。
注意:仅当 result.resultStatus 的值为 S 时,才会返回此字段。
请求
响应
结果码
| 结果码 | 值 | 结果码信息 | 行动建议 |
|---|---|---|---|
| SUCCESS | S | 成功。 | 接口调用成功,无需进一步操作。 |
| PROCESSING | S | 处理中 | 转账已创建并正在处理中。调用 inquiryTransfer 接口获取转账结果。 |
| 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。 |
| UN_SUPPORT_BUSINESS | F | 不支持的业务 | 使用了无效参数。请使用正确的信息重试。 |
| USER_NO_PERMISSION | F | 用户无权限 | 请使用其他用户信息重试。 |
| CURRENCY_NOT_SUPPORT | F | 币种不支持 | 请确保输入的币种正确,然后重试。 |
| USER_NOT_EXIST | F | 用户不存在 | 请使用正确的用户信息重试。 |
| USER_ACCOUNT_ABNORMAL | F | 用户账户状态异常 | 请使用其他用户重试。如果问题仍然存在,请联系 Antom 技术支持以获取更多详情。 |
| REPEAT_REQ_INCONSISTENT | F | 重复请求不一致 | 请确保请求中的所有字段一致,然后重试。 |
| USER_STATUS_ABNORMAL | F | 用户状态异常 | 请使用其他卡重试。如果问题仍然存在,请联系 Antom 技术支持以获取更多详情。 |
| BALANCE_NOT_ENOUGH | F | 余额不足 | 请确保余额充足后重试。 |
| AMOUNT_EXCEED_LIMIT | F | 金额超出限制 | 请确保提交的金额正确后重试。 |
| CONTRACT_CHECK_FAIL | F | 合同检查失败 | 请确保合作伙伴已签署合同且输入信息正确。 |
| QUOTE_EXPIRED | F | 报价已过期 | 调用 createQuote 接口创建新的报价,并使用新报价重试请求。 |