Issue:
Updating the API reference documentation 

We have had feedback related to the API doc being outdated, and lacking proper visibility of the latest spec of the API collection.

Resolution:
<think>
PR Context:
- Title: Docs: Api reference docs update for Payments - Create
- Merged: 2024-06-28T11:47:58Z
- Files changed: 9 files
- Commits: 25 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
This is regarding the API Reference Doc changes using OpenAPI.
This PR just the doc changes for Payments - Create (Including the Payments - Response)

### Additional Changes

- [ ] This PR modifies the API contract
- [ ] This PR modifies the database schema
- [ ] This PR modifi
</think>

To implement this, you'll need to modify:


**Detailed Implementation:**


**Commit 1:** Docs: Api reference docs update for Payments - Create (#4955)
Co-authored-by: Gorakhnath Yadav <gora
Files to modify:


**crates/api_models/src/admin.rs**
  Modify existing code

**crates/api_models/src/enums.rs**
  Modify existing code

**crates/api_models/src/ephemeral_key.rs**
  Modify existing code

**crates/api_models/src/mandates.rs**
  Modify existing code

**crates/api_models/src/payments.rs**
  Modify existing code

**crates/common_enums/src/enums.rs**
  Modify existing code

**crates/openapi/src/openapi.rs**
  Modify existing code

**crates/openapi/src/routes/payments.rs**
  Modify existing code