Despite a 20% decline in South Africa’s millionaire population over the past decade, it remains a hub for the continent’s high-net-worth individuals.