Skip to content

docs(standard-payments): remove AI warning, restructure content with step-by-step flow, and update API references#62

Open
aimensahnoun wants to merge 1 commit into03-02-docs_api-features_rewrite_conversion-payments_with_verified_api_behavior_refactor_api-features_conversion-payments.mdx_from_ai-generated_placeholder_content_into_endpoint-driven_documentation_aligned_with_current_api_behavior._-from
03-02-docs_api-features_rewrite_standard-payments_with_verified_api_flow_refactor_api-features_standard-payments.mdx_from_ai-generated_placeholder_content_into_a_clearer_endpoint-driven_page_aligned_with_current_api_behavior._-_remove
Open

docs(standard-payments): remove AI warning, restructure content with step-by-step flow, and update API references#62
aimensahnoun wants to merge 1 commit into03-02-docs_api-features_rewrite_conversion-payments_with_verified_api_behavior_refactor_api-features_conversion-payments.mdx_from_ai-generated_placeholder_content_into_endpoint-driven_documentation_aligned_with_current_api_behavior._-from
03-02-docs_api-features_rewrite_standard-payments_with_verified_api_flow_refactor_api-features_standard-payments.mdx_from_ai-generated_placeholder_content_into_a_clearer_endpoint-driven_page_aligned_with_current_api_behavior._-_remove

Conversation

@aimensahnoun
Copy link
Member

@aimensahnoun aimensahnoun commented Mar 2, 2026

TL;DR

Rewrote the standard payments documentation to remove AI-generated content warning and provide clearer, more structured guidance on same-currency crypto payments.

What changed?

  • Removed the AI-generated content warning banner
  • Clarified that standard payments are same-currency payments where invoiceCurrency and paymentCurrency match
  • Restructured native currency and ERC20 token sections to focus on characteristics rather than benefits
  • Added a new "How It Works" section with step-by-step implementation guidance
  • Updated the "Supported Networks & Tokens" section to reference the supported currencies catalog
  • Revised "Used In" section to focus on invoicing and checkout use cases
  • Updated API reference section to point to the OpenAPI documentation

How to test?

  • Review the documentation page to ensure the content flows logically
  • Verify that all referenced links work correctly
  • Check that the step-by-step implementation guide is clear and actionable
  • Confirm the supported chains and currencies references are accurate

Why make this change?

The previous version contained an AI-generated content warning and lacked clear implementation guidance. This revision provides developers with more precise definitions, clearer implementation steps, and removes uncertainty about content accuracy while maintaining technical accuracy.

Refactor `api-features/standard-payments.mdx` from AI-generated placeholder
content into a clearer, endpoint-driven page aligned with current API behavior.
- removed AI warning banner and unsupported assumptions
- clarified standard payments as same-currency flows where
  `invoiceCurrency` and `paymentCurrency` match
- split behavior between Native and ERC20 payments with accurate
  execution characteristics (approval vs no-approval paths)
- added practical “How It Works” steps with direct endpoint references:
  - POST /v2/request
  - POST /v2/payouts
  - GET /v2/request/{requestId}/pay
- replaced vague token/network claims (e.g. “500+ tokens”) with
  references to authoritative supported-currency resources
- removed hidden/unsupported use-case links (`payouts`, `payroll`)
  and kept active links (`invoicing`, `checkout`)
- updated technical reference to canonical OpenAPI docs:
  https://api.request.network/open-api
Copy link
Member Author

aimensahnoun commented Mar 2, 2026

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

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

@aimensahnoun aimensahnoun self-assigned this Mar 2, 2026
@aimensahnoun aimensahnoun changed the title docs(api-features): rewrite standard-payments with verified API flow Refactor api-features/standard-payments.mdx from AI-generated placeholder content into a clearer, endpoint-driven page aligned with current API behavior. - removed AI warning banner an docs(standard-payments): remove AI warning, restructure content with step-by-step flow, and update API references Mar 2, 2026
@aimensahnoun aimensahnoun marked this pull request as ready for review March 2, 2026 12:09
@greptile-apps
Copy link

greptile-apps bot commented Mar 2, 2026

Greptile Summary

Successfully refactors standard payments documentation by removing AI-generated content warning and providing clearer, endpoint-driven guidance.

Major improvements:

  • Replaced vague "crypto-to-crypto" description with precise "same-currency payments where invoiceCurrency and paymentCurrency match" definition
  • Restructured Native and ERC20 sections from "Benefits" to "Characteristics" with accurate technical details (approval flows, transaction counts)
  • Added comprehensive "How It Works" section with step-by-step implementation using actual API endpoints (POST /v2/request, POST /v2/payouts, GET /v2/request/{requestId}/pay)
  • Updated network/token section to reference authoritative supported currencies catalog instead of making unsupported claims
  • Removed hidden use-case references (payouts, payroll) and kept only active links (invoicing, checkout)
  • Standardized API reference to canonical OpenAPI documentation URL

The changes align with the ongoing effort to migrate from AI-generated placeholders to verified content, following the same pattern as recent conversion-payments, batch-payments, and recurring-payments updates.

Confidence Score: 5/5

  • This PR is safe to merge with no risk
  • Documentation-only change that improves content clarity and accuracy. All internal links verified, API references updated to canonical URLs, and content follows established technical writing guidelines. Part of systematic effort to replace AI-generated content with verified documentation.
  • No files require special attention

Important Files Changed

Filename Overview
api-features/standard-payments.mdx Removed AI warning, restructured with clear same-currency payment definition, added step-by-step flow, updated API references to OpenAPI docs

Last reviewed commit: ad72ad5

Copy link

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 file reviewed, no comments

Edit Code Review Agent Settings | Greptile

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant