PHPDoc fixes

Many methods lack proper PHPDoc documentation, or are documented with mistakes.

This PR fixes a few of the most annoying PHPDoc bugs in `Braintree_Transaction`.