WorldFirst DocsWorldFirst Docs

notifyCardholderStatus需要签名验签

万里汇将调用此接口将持卡人状态通知给集成商。

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

报文结构

万里汇接口的报文结构包括：请求头、请求体、响应头和响应体。该章节主要介绍请求体和响应体的结构。关于请求头和响应头的更多信息，参见：


入参

requestId String  REQUIRED

由集成商定义的唯一请求号，用于幂等处理。

更多信息：

  • 最大长度：32 字符

cardholderId String  

持卡人的唯一 ID。

当 auditStatus 为 ​APPROVED​ 时，此字段为必填。

auditStatus String  REQUIRED

风控审核状态。

可取值：

  • APPROVED：通过
  • PENDING：处理中
  • REJECTED：拒绝

failCode String  

请求失败结果码。

此字段仅在 auditStatus 为 ​REJECTED​ 时返回。

failMessage String  

请求失败结果码的补充信息。

此字段仅在 auditStatus 为 REJECTED 时返回。

userId String  

用户 ID。

出参

result Result  REQUIRED

代表 API 接口的调用结果。

Show child parameters
API Explorer

请求

请求体

响应

响应体

响应处理

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

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

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

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

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


result.resultCode 结果码

结果码值结果码信息行动建议
SUCCESSSSuccess
PARAM_ILLEGALFIllegal parameters exist. For example, a non-numeric input, or an invalid date.

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

SYSTEM_ERRORFSystem error.

请勿重试，联系万里汇技术支持了解详情。

SERVICE_NOT_ALLOWEDFService not allowed.

使用正确的信息重试，若问题依旧，联系万里汇技术支持以解决问题。

UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

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

REQUEST_TRAFFIC_EXCEED_LIMITUThe request traffic exceeds the limit.

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

OAUTH_FAILFOAuth process failed.

联系万里汇技术支持了解详情。

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

CONTRACT_CHECK_FAILFThe contract check has failed.

联系万里汇技术支持了解合约状态后重试。