Delete cardholder需要签名验签

2026-05-26 12:34

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

Call this API to delete the cardholder with the corresponding ID.

Structure

A message consists of a header and body. For details, see the following sections.

Field	Required	Sample	Description
Client-Id	Yes	`Client-Id: *****`	For more information about these request header fields, see Request structure. To generate`Signature`, see Sign a request and validate the signature.
Signature	Yes	`Signature: algorithm=RSA256, keyVersion=2, signature=*****`
Content-Type	Yes	`Content-Type: application/json; charset=UTF-8`
Request-Time	Yes	`Request-Time: 2019-04-04T12:08:56+08:00`
Connected-AccountId	Conditional	`Connected-AccountId: *****`	Attention Required when a partner manages a customer's account.
Access-Token	Conditional	`Access-Token: ******`	Attention Required for OAUTH authorization. Refer to applyToken.

The unique ID defined by the Partner to identify the request, which ensures idempotency.

Unique Identifier for cardholder.

The result of the API call.

Show child parameters

The unique ID defined by the Partner to identify the request, which ensures idempotency.

Unique Identifier for cardholder.

API Explorer

URL

Request Body

Response Body

After the integrator calls the API, WorldFirst returns the API call result. The result.resultStatus field has the following values:

result.resultStatus	Description
S	The API request is successful.
F	The API request failed. For the failure reason, see the result code (result.resultCode and result.resultMessage).
U	When the API response result is `UNKNOWN`, retry the API request. Retry strategy: + Maximum retries: 7 + Retry intervals: 5 minutes, 10 minutes, 20 minutes, 40 minutes, 80 minutes, 160 minutes, 320 minutes If the issue persists, contact WorldFirst technical support.

Code	Value	Message	Further action
SUCCESS	S	Success
PARAM_ILLEGAL	F	Illegal parameters exist. For example, a non-numeric input, or an invalid date.	Refer to the API documentation page to verify that the request headers and parameters are correct.
SYSTEM_ERROR	F	System error.	Do not retry. Contact WorldFirst technical support for details.
SERVICE_NOT_ALLOWED	F	Service not allowed.	Retry with the correct information. If the issue persists, contact WorldFirst technical support for assistance.
UNKNOWN_EXCEPTION	U	API failed due to unknown reason.	Server error. If the issue persists after retrying later, contact WorldFirst technical support for assistance.
REQUEST_TRAFFIC_EXCEED_LIMIT	U	The request traffic exceeds the limit.	Retry. If the issue persists, contact WorldFirst technical support.
OAUTH_FAIL	F	OAuth process failed.	Contact WorldFirst technical support for details.
INVALID_API	F	The called API is invalid or not active.	Verify that the correct API is being called.
INVALID_CLIENT	F	The client is invalid.	The Client ID does not exist or is invalid.
INVALID_SIGNATURE	F	The signature is invalid.	Verify that the request is correctly signed.
METHOD_NOT_SUPPORTED	F	The server does not implement the requested HTTP method.	Verify that the HTTP request method is POST.
CONTRACT_CHECK_FAIL	F	The contract check has failed.	Contact WorldFirst technical support to check the contract status before retrying.