createCardholder需要签名验签

2026-08-14 12:58

POST /amsin/api/v1/business/worldcard/createCardholder

集成商可调用此接口创建 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。

入参

requestId String REQUIRED

由集成商定义的唯一请求 ID。

cardholderInfo Object REQUIRED

持卡人信息。

Show child parameters

cardholderType String REQUIRED

持卡人类型。

取值范围：

EMPLOYEE：员工
SHAREHOLDER：股东

出参

result Result REQUIRED

代表 API 接口的调用结果。

Show child parameters

auditStatus String REQUIRED

风控审核状态。

取值范围：

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

availableStatus String REQUIRED

表示卡状态。

取值范围：

T：可用
F：不可用

failCode String

提供卡状态为不可用的结果码。

只有当 availableStatus 为 F 时，该字段才会返回。

failMessage String

说明卡状态为不可用的结果码信息。

只有当 availableStatus 为 F 时，该字段才会返回。

orderId String REQUIRED

订单 ID。

cardholderId String

持卡人 ID。

只有当 auditStatus 为 APPROVED 时，该字段才会返回。

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分钟如果问题依旧，请联系万里汇技术支持。

result.resultCode：系统结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	Success
PARAM_ILLEGAL	F	Illegal parameters exist. For example, a non-numeric input, or an invalid date.	参考API文档页面，确认请求头和传参是否正确。
SYSTEM_ERROR	F	System error.	请勿重试，联系万里汇技术支持了解详情。
SERVICE_NOT_ALLOWED	F	Service not allowed.	使用正确的信息重试，若问题依旧，联系万里汇技术支持以解决问题。
UNKNOWN_EXCEPTION	U	API failed due to unknown reason.	服务器错误，若稍后重试问题依旧，联系万里汇技术支持以解决问题。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	The request traffic exceeds the limit.	重试，若问题依旧，联系万里汇技术支持。
OAUTH_FAIL	F	OAuth process failed.	联系万里汇技术支持了解详情。
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.	联系万里汇技术支持了解合约状态后重试。

result.resultCode：业务结果码

结果码	值	结果码信息	行动建议
RISK_REJECT	F	Request rejected due to risk concerns.	请联系技术支持团队寻求帮助。
AUTHORIZATION_NOT_EXIST	F	The authorization does not exist.	请确保输入信息正确。如问题仍然存在，请联系技术支持团队验证授权状态。
REPEAT_REQUEST	U	Repeat request	更换 requestId 后重新调用此 API。