WorldFirst DocsWorldFirst DocsDOCS

notifyTransfer需要签名验签

万里汇使用此接口向集成商通知转账的结果。

您需要在调用 createTransfer 接口时配置 transferToDetail.transferNotifyUrl 字段来设置接收通知的地址。

在收到通知后，您需正确发送响应。若不向万里汇发送响应信息，万里汇会重新发送最多七次请求通知，详见 处理逻辑 章节。

报文结构

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

请求头

字段名

是否必传

范例

说明

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


入参

transferRequestId String  REQUIRED

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

更多信息：

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

transferId String  REQUIRED

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

更多信息：

  • 最大长度：64 字符

businessSceneCode String  REQUIRED

转账业务类型码。

可取值：

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

transferResult TransferResult  REQUIRED

代表转账结果。

Show child parameters

transferFinishTime DateTime  REQUIRED

本次转账请求的结束时间。

更多信息：

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

transferFromDetail TransferFromDetail  REQUIRED

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

Show child parameters

transferToDetail TransferToDetail  REQUIRED

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

Show child parameters

出参

result Result  REQUIRED

代表接口调用结果。

Show child parameters
API Explorer

请求

Case
户到户转账
请求体

响应

响应体

处理逻辑

transferResult.resultCode：此字段为转账结果。更多详见：结果码

在收到万里汇的请求之后，集成商需要向万里汇发送响应信息，以确认信息已收到。

发送响应信息前，集成商需正确加签。详见：生成签名及加验签 章节。

关于响应信息的头参数，详见：API概览-响应报文结构。

响应体范例：

Sample Code


如果集成商不向万里汇发送响应信息，万里汇会重新发送请求通知。

万里汇重发通知的规则为：

  • 重试总数：7次
  • 两次重发请求之间的间隔：2分钟，10分钟，10分钟，1小时，2小时，6小时，15小时

result.resultCode

结果码值结果码信息行动建议
SUCCESSSSuccess
PROCESS_FAILFA general business failure occurred. Do not retry.

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

UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

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

transferResult.resultCode

结果码值结果码信息行动建议
SUCCESSSSuccess
PROCESS_FAILFA general business failure occurred. Do not retry.

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

@2024 WorldFirst