Retire card

Permanently retires (cancels) a specific card, making it unusable for future transactions. Updates the card status to be canceled and ensures the card cannot be reactivated.

Important considerations

  • card_id must be valid and belong to the authenticated customer.
  • The card must be in a state that allows retirement.
  • Once retired, the card cannot be reactivated.
  • Customer ID is validated to ensure the card belongs to the requesting customer.
  • All operations are atomic—if the retirement process fails, no changes are applied.
  • The card status is updated to "canceled" in the database.
Language
Response
Click Try It! to start a request and see the response here!