queryCardholderDetail需要签名验签

2026-05-26 12:32

POST /amsin/api/v1/business/worldcard/queryCardholderDetail

集成商可调用此接口获取 World Card 账户的单个持卡人信息。

报文结构

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

字段名	是否必传	范例	说明
Client-Id	是	`Client-Id: *****`	关于这些参数的解释说明，详见：请求报文结构。 `Signature` 生成方法详见生成签名及加验签。
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-AccountId	否（有条件要求）	`Connected-AccountId: *****`	注意此字段当平台客户操作商户账户时需要传递
Access-Token	有条件要求	`Access-Token: ******`	注意此字段当用 OAUTH 授权时需要传递。参考 applyToken。

持卡人的唯一 ID。

代表 API 接口的调用结果。

Show child parameters

持卡人的唯一 ID。

风控审核状态。

可取值：

表示卡状态。

可取值：

持卡人类型。

可取值：

持卡人信息。

Show child parameters

API Explorer

URL

请求体

响应体

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

result.resultStatus	描述
S	API请求成功。
F	API请求失败。失败原因参见结果码（即 result.resultCode 和 result.resultMessage ）
U	API响应结果为`UNKNOWN`（未知）时，需重试API请求。重试策略：重试次数上限：7次重试时间间隔：5分钟、10分钟、20分钟、40分钟、80分钟、160分钟、320分钟如果问题依旧，请联系万里汇技术支持。

结果码	值	结果码信息	行动建议
SUCCESS	S	Success
PARAM_ILLEGAL	F	存在非法参数。例如，输入了非数字或无效的日期。	参考 API 文档页面，确认请求头和传参是否正确。
SYSTEM_ERROR	F	系统错误。	请勿重试，联系万里汇技术支持了解详情。
SERVICE_NOT_ALLOWED	F	服务不允许。	使用正确的信息重试，若问题依旧，联系万里汇技术支持以解决问题。
UNKNOWN_EXCEPTION	U	API 因未知原因失败。	服务器错误，若稍后重试问题依旧，联系万里汇技术支持以解决问题。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	请求流量超过限制。	重试，若问题依旧，联系万里汇技术支持。
OAUTH_FAIL	F	OAuth 流程失败。	联系万里汇技术支持了解详情。
INVALID_API	F	调用的 API 无效或未激活。	确认是否调用正确的 API。
INVALID_CLIENT	F	客户端无效。	Client ID 不存在或无效。
INVALID_SIGNATURE	F	签名无效。	确认请求正确加签。
METHOD_NOT_SUPPORTED	F	服务器未实现请求的 HTTP 方法。	确认 HTTP 请求方法为 POST。
CONTRACT_CHECK_FAIL	F	合约检查失败。	联系万里汇技术支持了解合约状态后重试。