updating api docs with examples of payment channels usage during disburs...

...ements and repayments