docs: add Payment and Client resource documentation

Completed API resources documentation:
- payment.md: Payment object schema, verification, analytics
- client.md: Client object, upsert behavior, management patterns

Both include:
- Complete field reference
- TypeScript interfaces
- Database schema
- Integration patterns
- Best practices
- Future enhancements

Author: carlos-israelj