docs(payment-types): simplify overview and add payment type selection guidance

[aimen74]

TL;DR

Simplified the Payment Types Overview page by removing AI-generated content warnings, streamlining the structure, and focusing on helping users choose the right payment type for their integration.

What changed?

• Updated page description from explaining workflows to helping users choose payment types
• Removed AI-generated content warning banner
• Eliminated the Payment Workflows section (Invoice-first vs Payment-first)
• Restructured content to focus on core payment types with clearer descriptions
• Added Batch Payments and Recurring Payments cards to replace use case examples
• Replaced implementation details with a decision-making steps section
• Updated API reference link to point to the OpenAPI documentation

How to test?

• Verify the page renders correctly without the warning banner
• Check that all card links navigate to their respective documentation pages
• Ensure the new step-by-step guidance section displays properly
• Confirm the updated API reference link works correctly

Why make this change?

The previous version was overly complex with workflow distinctions that may have confused users. This revision creates a clearer, more actionable guide that helps developers quickly identify which payment type suits their needs without unnecessary conceptual overhead.

[aimen74]

• docs(review): apply Tristan's two must-fix items from the final review #97
• docs(review): address Greptile review feedback across the stack #96
• docs(feedback): apply Tristan's revisions from RequestNetwork/request-api#806 #95
• docs(kyt): document KYT-screened payments as a use case + payee-destination field #94
• docs(secure-payments): document redirectUrl + redirectLabel #93
• docs(verify): fix broken cross-refs surfaced by mintlify broken-links #92
• docs(scripts): add Playwright screenshot capture scaffolding #91
• docs(content): add use-case pages, Dashboard + Secure Payment tools pages #90
• docs(content): refresh Tron coverage, batch-payment EVM scope, webhook 12-event list #89
• docs(nav): restructure navigation, remove legacy pages, retire Portal #88
• docs: fix broken links and clarify edge cases #87
• docs: add missing feature documentation for recent API changes #86
• docs: fix implementation discrepancies across API docs #85
• docs: remove beta banner and legacy SDK tab #78
• Remove AI-generated content warnings and update internal links #77
• docs(lifecycle): replace external image with local asset and remove AI-generated warning #76
• docs: remove AI-generated content warnings and simplify Request Scan page #75
• docs(resources): remove community page from navigation #74
• docs(supported-chains): add Tron network support and enhance currency documentation #73
• docs(supported-chains): streamline supported chains and currencies documentation #72
• docs(api-reference): add v2 endpoints overview and switch docs OpenAPI to v2-only spec Improve API Reference navigation by introducing a dedicated Endpoints Overview page in docs and wiring Mintlify OpenAPI rendering to a local v2-only spec. - add `api-re #71
• docs(authentication): simplify auth guide with API key vs Client ID methods and remove AI-generated content #70
• docs(fee-breakdowns): rewrite to focus on API response locations and reconciliation usage #69
• docs(protocol-fees): add protocol fees documentation and navigation #68
• docs(platform-fees): simplify configuration guide and remove AI-generated content warning #67
• docs(query-payments): rewrite with practical implementation focus and remove AI warning #66
• docs(query-requests): simplify and refactor query requests documentation for practical implementation #65
• docs(payment-detection): simplify content and remove AI warning #64
• docs(partial-payments): rewrite with step-by-step implementation guide and clarify API usage #63
• docs(standard-payments): remove AI warning, restructure content with step-by-step flow, and update API references #62
• docs(conversion-payments): rewrite with step-by-step implementation guide and remove AI-generated warning #61
• docs(payment-types): simplify overview and add payment type selection guidance #60 👈 (View in Graphite)
• docs(crypto-to-fiat): expand comprehensive guide with sandbox access, compliance flows, and implementation details #59
• docs(recurring-payments): rewrite with comprehensive workflow, security details, and practical implementation guide #58
• docs(batch-payments): add comprehensive implementation guide with examples, workflow diagrams, and demo videos #57
• docs(crosschain-payments): replace AI-generated content with comprehensive implementation guide #56
• docs(create-requests): rewrite with workflows, examples, and remove AI warning #55
• feat: add complete integration tutorial with Node.js backend and React frontend #54
• docs(getting-started): remove AI warning and refactor to focus on practical payment integration #53
• docs(api-portal): remove AI warning, add local screenshot, and update .gitignore #52
• docs: remove release notes section and streamline use cases to core features #51
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[greptile-apps]

Greptile Summary

This PR simplifies the Payment Types Overview page by removing the AI-generated content warning, collapsing the Invoice-first/Payment-first workflow sections, and restructuring the content around a card-based layout with a decision-guidance section.

• Removes the <Warning> banner and two workflow sections, replacing them with two <CardGroup> blocks covering all five payment types.
• Adds a "Choosing a Payment Type" <Steps> section to help developers select the right type.
• Updates the API reference link from the internal /api-reference/payment-types path to the external OpenAPI URL https://api.request.network/open-api; all five internal card href values resolve to existing pages in the repo.

Confidence Score: 5/5

Safe to merge — documentation-only change with no logic or API surface affected.

The change touches a single documentation page, removes outdated content, and all five card links point to pages that exist in the repository. The external API reference URL is a straightforward swap from the previous internal path. No functional code is modified.

No files require special attention.

Important Files Changed

Filename	Overview
api-features/payment-types-overview.mdx	Simplified overview page: removes AI-content warning, collapses workflow sections into two CardGroups, adds a Steps-based guidance section, and updates the API reference link to the external OpenAPI URL. All internal card hrefs resolve to existing .mdx files.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
A[Developer lands on Payment Types Overview] --> B{Same currency?}
B -- Yes --> C[Native & ERC20]
B -- No --> D{Fiat-denominated?}
D -- Yes --> E[Conversion]
D -- No --> F[Crosschain]
C & E & F --> G{Advanced behavior needed?}
G -- Multiple recipients --> H[Batch Payments]
G -- Scheduled/recurring --> I[Recurring Payments]
G -- No --> J[Implement chosen type]
H & I --> J

Loading

_{Reviews (2): Last reviewed commit: "docs(api-features): refocus payment-type..." | Re-trigger Greptile}

[greptile-apps]

_{1 file reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

[rodrigopavezi]

Merge activity

• May 12, 4:02 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• May 12, 4:19 PM UTC: Graphite rebased this pull request as part of a merge.
• May 12, 4:20 PM UTC: @rodrigopavezi merged this pull request with Graphite.