Shoddy API's are not unique to Checkout. Most, if not all, of Google's API's are actually pretty terrible. When they DO update their API's it's pretty rare that they tell anyone, and they never update their documentation. So, a workflow that worked fine last week will suddenly fail disgracefully and you'll have no idea unless you find the right version of the docs.