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

...arameters for purchases.