docs(protocol-fees): add protocol fees documentation and navigation

[aimen74]

TL;DR

Added comprehensive documentation for protocol fees charged by Request Network API on all payment types.

What changed?

Created a new documentation page api-features/protocol-fees.mdx that explains:

• Protocol fee structure (5 basis points with ~$25/€25 cap for major stablecoins)
• Payment types subject to fees (ERC20, native currency, conversion, batch, crosschain, and upcoming subscription payments)
• Default fee responsibility (payer bears the cost)
• Method to shift fees to payee by reducing invoice amount
• Platform fee integration and batching
• Fee information included in API responses

Added the protocol fees page to the navigation structure under the "Fee Structure" group in docs.json.

How to test?

Review the documentation page to ensure:

• Fee calculations and examples are accurate
• Navigation links work properly in the documentation site
• Content is clear and follows existing documentation standards
• JSON response examples are properly formatted

Why make this change?

This documentation provides essential transparency about Request Network's fee model, helping developers understand costs associated with API usage and giving them options for fee management in their applications.

[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 👈 (View in Graphite)
• 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
• 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 adds a new api-features/protocol-fees.mdx documentation page explaining Request Network's protocol fee model and registers it in the navigation under the existing "Fee Structure" group.

• New docs page: covers the 5 bps fee rate, the ~$25/€25 stablecoin cap, who bears the fee by default, how to shift the fee to the payee by reducing the invoice, platform fee co-existence, and the fee fields returned in API responses.
• Navigation update: docs.json inserts api-features/protocol-fees between platform-fees and fee-breakdowns in the Fee Structure group — correct placement with no structural issues.

Confidence Score: 5/5

Documentation-only change with no runtime code; safe to merge once the open prose gaps are addressed.

Both changed files are documentation. The navigation update in docs.json is a straightforward addition. The new MDX page is self-contained with no executable code paths — the only open items are content clarity gaps that don't break anything.

api-features/protocol-fees.mdx — the fee-cap coverage for native-currency payments and the missing related-pages navigation both warrant a quick pass before publishing.

Important Files Changed

Filename	Overview
api-features/protocol-fees.mdx	New documentation page covering protocol fees; fee cap coverage for non-stablecoin payment types (ETH, POL) is undocumented, and a related-pages navigation section is missing.
docs.json	Adds protocol-fees to the Fee Structure navigation group in the correct position between platform-fees and fee-breakdowns; no issues.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
A[Payment initiated] --> B{Payment currency}
B -->|USD/EUR stablecoin| C[Apply 0.05% fee]
B -->|Native currency ETH/POL| D[Apply 0.05% fee]
B -->|Conversion / Batch / Crosschain| E[Apply 0.05% fee]
C --> F{Fee > $25 cap?}
F -->|Yes| G[Cap fee at ~$25/€25]
F -->|No| H[Use calculated fee]
D --> I[Cap behavior undocumented]
E --> J[Cap behavior undocumented]
G --> K{Who bears the fee?}
H --> K
I --> K
J --> K
K -->|Default: payer| L[Fee added on top of invoice]
K -->|Shifted: payee| M[Reduce invoice by ~0.05% before request creation]
L --> N[Payer pays invoice + fee
Payee receives invoice amount]
M --> O[Payer pays ~original amount
Payee receives reduced invoice amount]

Loading

_{Reviews (2): Last reviewed commit: "docs(api-features): add protocol-fees pa..." | Re-trigger Greptile}

[greptile-apps]

_{2 files reviewed, 3 comments}

_{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:36 PM UTC: Graphite rebased this pull request as part of a merge.
• May 12, 4:37 PM UTC: @rodrigopavezi merged this pull request with Graphite.