OP-5810 - documentation updates to include new returned values and new p...

...arameters for purchases.
This is where the new stuff is added.