WorldFirst DocsWorldFirst Docs

deleteCardholder需要签名验签

POST /amsin/api/v1/business/worldcard/deleteCardholder

集成商可调用此接口删除持卡人。

报文结构

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

请求头

字段名

是否必传

范例

说明

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-AccountId

否(有条件要求)

Connected-AccountId: *****

注意此字段

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

Access-Token

有条件要求

Access-Token: ******

注意此字段

当用 OAUTH 授权时需要传递。参考 applyToken


入参

requestId String  REQUIRED

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

cardholderId String  REQUIRED

持卡人的唯一 ID。

出参

result Result  REQUIRED

代表 API 接口的调用结果。

Show child parameters

requestId String  REQUIRED

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

cardholderId String  REQUIRED

持卡人的唯一 ID。

API Explorer

请求

URL
请求体

响应

响应体

响应处理

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

result.resultStatus

描述

S

API请求成功。

F

API请求失败。失败原因参见结果码(即 result.resultCoderesult.resultMessage

U

API响应结果为UNKNOWN(未知)时,需重试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文档页面,确认请求头和传参是否正确。

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.

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