Improved phpdocs, better IDE typehinting

Braintree_Transaction::sale()