WorldFirst DocsWorldFirst DocsDOCS

notifyVostro

当您的万里汇账户发生充值后， 万里汇会调用本接口通知您关于资金变化的信息。

报文结构

万里汇接口报文结构包括：请求头，请求体。关于头信息，详见：

入参

fundingId String  REQUIRED

由万里汇定义、用于唯一标识某次垫付请求。

更多信息：

  • 此为幂等字段。集成商可使用本字段做幂等校验，具体详见幂等字段介绍。
  • 最大长度：128 字符

balanceResult Result  REQUIRED

代表本次垫付是否成功。

Show child parameters

payerBankAccount PayerBankAccount  REQUIRED

付款人银行账户信息。

Show child parameters

beneficiaryAccount BeneficiaryBankAccount  REQUIRED

收款人万里汇VA账户信息

Show child parameters

balanceChangeAmount Amount  REQUIRED

账户余额变动的金额。

Show child parameters

balanceChangeTime DateTime  

账户余额变动的时间。

更多信息：

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

remitInfo String  

垫付请求附加信息。

更多信息：

  • 最大长度：530 字符

出参

result Result  REQUIRED

代表接口调用结果。

Show child parameters
API Explorer

请求

请求体

响应

响应体

响应处理

万里汇通过在请求中指定 balanceResult.result 参数向集成商发送本次垫付的结果。有关详细信息，请参阅以下 balanceResult.resultCode 部分。在收到万里汇的请求之后，集成商需要向万里汇发送响应信息，以确认信息已收到。

发送响应信息前，集成商需正确加签。请参考以下示例。

详见：生成签名及加验签 及 响应头 章节。

Sample Code

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

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

balanceResult.resultCode

结果码值结果码信息行动建议
SUCCESSSSuccess
REFUNDSRefund Success


result.resultCode

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

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

@2024 WorldFirst