notifyVostro

需要签名验签

当您的万里汇账号成功收到垫付款后,万里汇会调用本接口向您通知来账结果。

报文结构

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

请求参数

字段名

数据类型

是否必填

描述

fundingId

字符串

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

更多信息:

  • 本字段为幂等字段,您可使用本字段做幂等校验,具体详见幂等字段介绍。
  • 字段最大长度:128

balanceResult

Result 对象

代表本次垫付是否成功

payerBankAccount

payerBankAccount 对象

付款人银行账户信息

beneficiaryAccount

beneficiaryBankAccount 对象

收款人万里汇VA账户信息

balanceChangeAmount

Amount 对象

账户余额变动的金额,即本次充值的金额

balanceChangeTime

DateTime 字符串

账户余额变动的时间,即本次充值的时间

更多信息:

  • 本时间遵循 ISO 8601 标准规定的时间格式,如:2019-01-01T01:01:01+08:002019-01-01T01:01:01Z(UTC时间)

remitInfo

字符串

垫付请求附加信息

更多信息:

  • 最大长度:530字符

响应参数

字段名

数据类型

是否必填

描述

result

Result 对象

代表接口调用结果

处理逻辑

万里汇使用balanceResult.resultCode向您返回垫付结果,具体请见balanceResult.resultCode章节。在收到万里汇的结果通知后,您需要向万里汇发送响应信息,以确认信息已收到。

如果您不向万里汇发送响应信息,万里汇会重新通过以下规则向您发送请求通知:

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

注意:在您发送响应信息前,请确保正确加签。参见以下响应头代码范例。详见:生成签名及加验签 章节和API概览-响应报文结构

结果码

balanceResult.resultCode

resultCode

resultStatus

resultMessage

处理建议

SUCCESS

S

Success

REFUND

S

Refunding  success

PROCESS_FAIL

F

A general business failure occurred. Do not retry.

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

系统错误码 result.resultCode

resultCode

resultStatus

resultMessage

处理建议

SUCCESS

S

Success

PARAM_ILLEGAL

F

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

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

PROCESS_FAIL

F

A general business failure occurred. Do not retry.

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

UNKNOWN_EXCEPTION

U

API failed due to unknown reason.

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

INVALID_API

F

The called API is invalid or not active.

检查调用API是否正确

INVALID_CLIENT

F

The client is invalid.

Client ID 不存在或无效

INVALID_SIGNATURE

F

The signature is invalid.

确认请求正确加签

METHOD_NOT_SUPPORTED

F

The server does not implement the requested HTTP method.

确认HTTP请求方法为POST

CONTRACT_CHECK_FAIL

F

The contract check has failed.

联系万里汇技术支持了解当前合约状态,确保合约有效后重试。

范例

请求

请求体范例

copy
{
    "fundingId": "*****",
    "balanceResult": {
        "resultCode": "SUCCESS",
        "resultMessage": "success",
        "resultStatus": "S"
    },
    "payerBankAccount": {
        "accountNo": "*****",
        "bankBIC": "payerBic123",
        "bankName": "ping**",
        "bankRegion": "payerBCC123",
        "holderAddress": "payerAddress123",
        "holderName": {
            "fullName": "xy****"
        }
    },
    "beneficiaryAccount": {
        "accountNo": "*****",
        "bankBIC": "CHASHK*****",
        "holderName": {
            "fullName": "x***y"
        }
    },
    "balanceChangeAmount": {
        "currency": "HKD",
        "value": "3333"
    },
    "remitInfo": "*****"
}

响应

响应头范例

copy
{
"headers": {
  "Content-Type": "application/json",
  "client-id": "*****",
  "response-time": "2022-03-07T07:49:27Z",
  "signature": "algorithm=RSA256,keyVersion=1,signature=VelVji6jp8*****"
  }
}

响应体范例

copy
{
    "result": {
        "resultStatus": "S",
        "resultCode": "SUCCESS",
        "resultMessage": "success."
    }
}

@2024 WorldFirst