WorldFirst DocsWorldFirst DocsDOCS

queryCardSensitiveInfo需要签名验签

POST /amsin/api/v1/business/worldcard/queryCardSensitiveInfo

集成商可调用此接口查询万里付卡片的敏感信息。

报文结构

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

请求头

字段名

是否必传

范例

说明

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: *****

注意此字段

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

Access-Token

有条件要求

Access-Token: ******

注意此字段

当用 OAUTH 授权时需要传递

入参

assetId String  REQUIRED

卡资产ID。

env Env  REQUIRED

转账环境。

Show child parameters

出参

result Result  REQUIRED

代表API 接口的调用结果。

Show child parameters

assetId String  REQUIRED

卡资产ID。

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

cvv String  REQUIRED

cvv号。

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

cardNo String  REQUIRED

万里付卡号明文。

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

expiredMonth String  

卡片过期月份，格式为“MM“，如：”07“。

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

更多信息：

  • 最大长度：2 字符

expiredYear String  

卡片过期年份，格式为“YY“，取年份后两位数字，如：”29“。

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

更多信息：

  • 最大长度：2 字符
API Explorer

请求

URL
请求体

响应

响应体

响应处理

集成商调用接口后，万里汇返回集成商API调用结果。result.resultStatus 取值范围为：

Result status

描述

S

接口调用成功

F

接口调用失败，具体原因参见result.resultCode

U

调用结果未知，需重试API请求。

重试策略：

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

若上述重试均未成功，联系万里汇技术支持。

result.resultCode

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

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

UNKNOWN_EXCEPTIONUAPI failed due to unknown reason.

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

SYSTEM_ERRORFSystem error.

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

RISK_REJECTFThe transfer is rejected for risk control reasons.

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

USER_NOT_EXISTFThe user does not exist.

使用正确的用户信息重试。

AUTHORIZATION_NOT_EXISTFThe authorization does not exist.

当前授权关系不存在，请联系万里汇技术支持检查授权关系。