inquiryPayout需要签名验签

POST /amsin/api/v1/business/fund/inquiryPayout

调用本接口查询外部转账结果。

  • 您需要设定timeout机制中断查询,以处理转账后无明确结果的情况;
  • 若调用createPayout接口后2小时没有接收到万里汇通知,且调用inquiryPayout接口后transferResult.resultCode返回UNKNOWN,联系万里汇技术支持。

报文结构

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

请求头

字段名

是否必传

范例

说明

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字段

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



入参

transferId String  CONDITIONAL

万里汇提现申请成功时返回的代发单据号。

transferId、transferRequestId不能同时为空。

transferRequestId String  CONDITIONAL

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

transferId、transferRequestId不能同时为空。

更多信息:

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

出参

result Result  REQUIRED

代表API调用结果。

Show child parameters

transferResult Result  REQUIRED

代表转账结果。

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

Show child parameters

transferRequestId String  REQUIRED

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

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

更多信息:

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

transferId String  REQUIRED

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

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

更多信息:

  • 最大长度:64 字符

transferFinishTime DateTime  

本次转账请求的完成时间。

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

更多信息:

  • 值遵循 ISO 8601 标准格式。例如,“2019-11-27T12:01:01+08:00”。

transferFromDetail TransferFromDetail  REQUIRED

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

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

Show child parameters

transferToDetail TransferToDetail  REQUIRED

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

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

Show child parameters
API Explorer

请求

URL
请求体

响应

响应体

响应处理

集成商调用接口之后,万里汇会返回给集成商以下两个字段:

  • result.resultStatus:API调用结果
  • transferResult.resultStatus:转账结果

集成商调用接口后,万里汇响应集成商API调用结果。

result.resultStatus 字段取值范围为:

result.resultStatus

描述

S

API请求成功。

F

API请求失败。

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

U

API响应结果为UNKNOWN(未知)时,需重试API请求。

重试策略:

  • 重试次数上限:7次
  • 重试时间间隔:5分钟、10分钟、20分钟、40分钟、80分钟、160分钟、320分钟

如果问题依旧,请联系万里汇技术支持。


transferResult.resultStatus 取值范围为:

result.resultStatus

描述

S

转账请求成功。

  • 如果 transferResult.resultStatus 结果为S,且 transferResult.resultCode PROCESSING,此次转账请求正在处理中。

F

转账请求失败。

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

U

转账结果为UNKNOWN(未知)时,需重试。

result.resultCode

结果码结果码信息行动建议
SUCCESSSSuccess
UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

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

REQUEST_TRAFFIC_EXCEED_LIMITUThe request traffic exceeds the limit.

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

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

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

PROCESS_FAILFA general business failure occurred. Do not retry.

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

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

transferResult.resultCode

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

万里汇正在处理该请求,可稍后再次调用inquiryPayout接口查询结果

PROCESS_FAILFA general business failure occurred. Do not retry.

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

ORDER_IS_CLOSEDFThe order is closed.

换单重试

ORDER_NOT_FOUNDUOrder not found.

使用正确的订单信息重试

ORDER_NOT_EXISTFThe order does not exist.

订单不存在,重新下单

ORDER_IS_REVERSEDFThe order is reversed.

换单重试

USER_NOT_EXISTFThe user does not exist.

使用正确的用户信息重试

USER_ACCOUNT_ABNORMALFThe user account status is abnormal.

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

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

更换用户信息重试

AMOUNT_EXCEED_LIMITFThe amount exceeds the limit.

确认金额正确后重试

RISK_REJECTFThe transfer is rejected for risk control reasons.

通知用户需要通过风控审核

CARD_INFO_NOT_MATCHFThe card information does not match.

换卡重试

BALANCE_NOT_ENOUGHFBalance is not enough.

确认余额充足后重试

CURRENCY_NOT_SUPPORTFThe currency is not supported.

确认币种信息正确后重试

UN_SUPPORT_BUSINESSFUnsupported business.

使用正确的参数重试

USER_NO_PERMISSIONFUser does not have permission.

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

@2024 WorldFirst