Deleting a Registered Card
- Endpoint:
/vendor/creditcard - HTTP Method:
DELETE - Request Content-Type:
application/json - Response Content-Type:
application/json - Authorization: Valid AccessToken is required. (See: 2. Authentication – Obtaining AccessToken)
Description
This service allows the registered credit card of a member to be deleted from the system. The deletion is performed using the memberCreditCardId parameter.
Note
- Deleted cards cannot be recovered.
- The operation can only be performed by the member to whom the card belongs (or an authorized dealer).
Header Information
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Valid token in Bearer {AccessToken} format |
| Content-Type | Yes | application/json |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| memberCreditCardId | string | Yes | Unique system ID of the registered card to be deleted. |
Example Request
DELETE vendor/creditCard/73e4e086-c42d-49aa-bfaf-2cd8f25a2334
Successful Response (200 OK)
{
"isSuccess": true,
"message": "Registered card has been successfully deleted."
}
Notes & Best Practices
- Deletion cannot be undone — use with caution.
- After successful deletion, the card will not appear in any listing endpoints.
- The
memberCreditCardIdmust exist in the system; otherwise, a 404 Not Found error is returned. - The user's AccessToken must belong to the member to whom the card is linked or an authorized dealer.
- If the token has expired, the request returns 401 Unauthorized; a new token must be obtained.