Off the top of my head:

* Undocumented surprise error when user tries to re-subscribe in a different currency or change currency. Solution is to recreate the whole customer.

* Docs instruct to subscribe new users to free plan which is actually a bad practice for reasons that include first bullet point.

* Lack of docs/guidance for China payment systems and seeing Stripe server and frontend errors in testing environment.