docs: API-ref revamp for better user experience

API-ref revamp for better user experience
<think>
PR Context:
- Title: docs: changes for api ref
- Merged: 2025-02-25T19:02:34Z
- Files changed: 4 files
- Commits: 8 commits

Implementation approach:
## Type of Change
<!-- Put an `x` in the boxes that apply -->

- [ ] Bugfix
- [ ] New feature
- [ ] Enhancement
- [ ] Refactoring
- [ ] Dependency updates
- [X] Documentation
- [ ] CI/CD

## Description
<!-- Describe your changes in detail -->

We have changes the Intro page of the API-ref to make it more informative and navigable.
Also, The API sidebar is now re-organised basis of different use-cases to improve the dev experience.
Added an introduction page to payments API expla
</think>

To implement this, you'll need to modify:


(No detailed commit information available)
{"issue_number": 7323, "pr_number": 7324, "commits_count": 0, "files_changed": 4, "response_length": 755, "file_count": 0, "needs_breakdown": false}