Skip to main content
POST
/
cards
/
{id}
/
terminate
Terminate a card
curl --request POST \
  --url https://api.cartevo.co/api/v1/cards/{id}/terminate \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "statusCode": 201,
  "message": "Card terminated successfully",
  "data": {
    "card_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "card_status": "TERMINATED",
    "refund_processed": "true",
    "balance_before_termination": 6
  }
}

​
Description

Permanently terminate a card. When a card is terminated:
  • The card status changes to TERMINATED
  • The card becomes unusable and cannot be reactivated
  • Any remaining balance on the card is automatically refunded to the company’s USD wallet
  • The card balance is set to zero
⚠️ Warning: This action is irreversible. Once terminated, a card cannot be unfrozen or reactivated.

​
Request

​
Endpoint

POST /api/v1/cards/{id}/terminate

​
Headers

Authorization: Bearer {access_token}

​
Path Parameters

ParameterTypeRequiredDescription
idstring (UUID)YesThe ID of the card to terminate

​
Response

​
Success Response (201)

{
  "success": true,
  "statusCode": 201,
  "message": "Card terminated successfully",
  "data": {
    "card_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "TERMINATED",
    "refunded_amount": 50.0
  }
}

​
Error Responses

​
400 Bad Request - Card Already Terminated

{
  "success": false,
  "statusCode": 400,
  "message": "Card is already terminated",
  "error": "Bad Request"
}

​
404 Not Found

{
  "success": false,
  "statusCode": 404,
  "message": "Card not found",
  "error": "Not Found"
}

​
Example

​
cURL

curl -X POST "https://api.cartevo.co/api/v1/cards/550e8400-e29b-41d4-a716-446655440000/terminate" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
JavaScript (fetch)

const response = await fetch(
  'https://api.cartevo.co/api/v1/cards/550e8400-e29b-41d4-a716-446655440000/terminate',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
    }
  }
);

const data = await response.json();
console.log(data);

​
Balance Refund Process

When a card is terminated:
  1. The system checks the current balance on the card
  2. If there is a balance greater than 0:
    • The balance is automatically transferred to the company’s USD wallet
    • A transaction record is created documenting the refund
  3. The card balance is set to 0
  4. The card status is updated to TERMINATED

​
Important Notes

  • Irreversible Action: Terminating a card cannot be undone
  • Balance Refund: Any remaining balance is automatically refunded to your company’s USD wallet
  • Card Status: Once terminated, the card status will be TERMINATED and cannot be changed
  • Card Usage: Terminated cards cannot be used for any transactions
  • Verification: You can verify the refund by checking your company’s USD wallet balance after termination

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Card ID to terminate

Response

Card terminated successfully. Balance refunded to company USD wallet.

​
success
boolean
Example:

true

​
statusCode
integer
Example:

201

​
message
string
Example:

"Card terminated successfully"

​
data
object