Improve documentation for payments module

The payments module could use improved docs.