Create a terminated request

If you no longer use a card, you can terminate it. Please note that before terminating a card, make sure that all purchases have been made and there is no balance on the card. Once a card is terminated, any remaining balance will not be refunded.

Step 0. Authentication

How to obtain access token Authentication Reference

Step 1. Initialize a Create Intent

POST /mch-api/v1/issuing/cards/update

• Example Request

{
  "request_id": "C61",
  "card_id": "VC95391650019020000",
  "action": "terminate"
}

• Request

REQUEST BODY	Details	Type	Required	Example
request_id	The merchant unique ID created in merchant's order system that corresponds to this card.	string(32)	required
card_id	Please enter the card_id returned when creating the card	string	required
action	In this scenario, please fill in the fixed value "terminate"	string	required

You will get a response similar to the following.

{
  "code": "success",
  "data": {
    "brand": "mastercard",
    "card_id": "VC95391650019020000",
    "card_issuance_status": "success",
    "card_status": "terminated",
    "channel": "hsbc",
    "currency": "USD",
    "request_id": "C61"
  },
  "message": "ok",
  "rid": "46e9de04d2874dc7a88e89abd9a88357"
}