createTransfer需要签名验签

POST /amsin/api/v1/business/fund/createTransfer

调用本接口进行资金的转账。资金会转入到另一个万里汇账户,即资金在万里汇账户之间流通。

转账步骤为异步。调用本接口后,WF仅返回本API的调用结果,而在notifyTransfer接口中返回转账结果。集成商也可以自行调用 inquiryTransfer接口查询转账结果。

报文结构

万里汇接口报文结构包括:请求头,请求体。

请求头

HTTP请求头主要包含了客户端、加验签、加解密相关的信息,请求头中的内容不区分大小写。

字段名

是否必传

范例

说明

Client-Id

Client-Id: *****

关于这些参数的解释说明,详见:请求头

Signature

Signature: algorithm=RSA256, keyVersion=2, signature=*****

Content-Type

Content-Type: application/json; charset=UTF-8

Request-Time

Request-Time: 2019-04-04T12:08:56+08:00

Connected-CustomerId

否(有条件)

Connected-CustomerId: *****

注意此header字段

当平台客户操作商户账户时需要传递


入参

transferRequestId String  REQUIRED

由集成商定义的唯一转账识别ID。

更多信息:

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

businessSceneCode String  CONDITIONAL

转账业务类型码。

可取值:

  • MULTI_ACCOUNT_TRANSFER万里汇主/子账号余额互转

此字段仅在您需要进行以下转账时为必传

  • 从 主账号 转至 子账号
  • 从 子账号 转至 子账号

transferFromDetail TransferFromDetail  REQUIRED

支付方提供的转账详细信息。

Show child parameters

transferToDetail TransferToDetail  REQUIRED

收款方接受的转账详细信息。

Show child parameters

出参

result Result  REQUIRED

代表接口调用结果。

Show child parameters

transferRequestId String  REQUIRED

由集成商定义的唯一转账识别ID。

该字段只有当 result.resultStatus =S 时才会按需返回。

更多信息:

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

transferId String  REQUIRED

由万里汇定义的转账识别ID。

该字段只有当 result.resultStatus =S 时才会按需返回。

更多信息:

  • 最大长度:64 字符

businessSceneCode String  REQUIRED

转账业务类型码。

可取值:

  • MULTI_ACCOUNT_TRANSFER万里汇主/子账号余额互转
  • ATOMIC_TRANSFER:万里汇户到户转账。

transferFromDetail TransferFromDetail  REQUIRED

支付方提供的转账详细信息。

该字段只有当 result.resultStatus =S 时才会按需返回。

Show child parameters

transferToDetail TransferToDetail  REQUIRED

收款方接受的转账详细信息。

该字段只有当 result.resultStatus =S时才会按需返回。

Show child parameters
API Explorer

请求

URL
Case
户到户转账
请求体

响应

Case
户到户转账
响应体

响应处理

集成商调用接口后,万里汇返回集成商API调用结果。result.resultStatus 字段取值范围为:

result.resultStatus

描述

S

API请求成功。

  • 如果 result.resultStatus S,表示万里汇已接受本次API请求,转账请求正在处理中。调用 inquiryTransfer 以查询转账结果。
  • 如果万里汇在20分钟内没有使用 notifyTransfer 向集成商发送结果通知,集成商需调用inquiryTransfer接口查询本次转账结果。

F

API请求失败。

失败原因参见下文结果码(即 result.resultCode 和 result.resultMessage 

U

API响应结果为UNKNOWN(未知)时,集成商需调用 inquiryTransfer 接口以检查转账请求状态。


result.resultCode:系统结果码

结果码结果码信息行动建议
SUCCESSSSuccess
PROCESSINGSThe transfer is in process.

转账请求已创建,处理中。调用 inquiryTransfer 接口以查询转账结果。

PARAM_ILLEGALFIllegal parameters exist. For example, a non-numeric input, or an invalid date.

参考API文档页面,确认请求头和传参是否正确。

PROCESS_FAILFA general business failure occurred. Do not retry.

需要人工介入,联系万里汇技术支持以解决此问题。

UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

服务器错误,若稍后重试问题依旧,联系万里汇技术支持以解决问题。

REQUEST_TRAFFIC_EXCEED_LIMITUThe request traffic exceeds the limit.

重试,若问题依旧,联系万里汇技术支持。

INVALID_APIFThe called API is invalid or not active.

确认是否调用正确的API。

INVALID_CLIENTFThe client is invalid.

Client ID不存在或无效。

INVALID_SIGNATUREFThe signature is invalid.

确认请求正确加签。

METHOD_NOT_SUPPORTEDFThe server does not implement the requested HTTP method.

确认HTTP请求方法为POST

result.resultCode:业务结果码

结果码结果码信息行动建议
UN_SUPPORT_BUSINESSFUnsupported business.

使用正确的参数重试。

USER_NO_PERMISSIONFUser does not have permission.

检查用户权限是否正确并重试。

CURRENCY_NOT_SUPPORTFThe currency is not supported.

确认币种信息正确后重试。

USER_NOT_EXISTFThe user does not exist.

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

USER_ACCOUNT_ABNORMALFThe user account status is abnormal.

使用其他用户信息重试。如问题依旧,联系万里汇技术支持。

REPEAT_REQ_INCONSISTENTFRepeated requests are inconsistent.

重试请求不一致。需保证所有请求参数均相同。

USER_STATUS_ABNORMALFThe status of the user is abnormal. Retry with another card.

使用其他用户信息重新下单。

BALANCE_NOT_ENOUGHFBalance is not enough.

确认余额充足后重试。

AMOUNT_EXCEED_LIMITFThe amount exceeds the limit.

确认金额正确后重试。

CONTRACT_CHECK_FAILFThe contract check has failed.

检查合约状态后重试。

QUOTE_EXPIREDFThe quote is expired.

调用  createQuote 接口来获取新汇率报价,并使用新汇率报价完成外汇请求。

@2024 WorldFirst