From ad72ad5ccbdaa52081cd2c8b90e58f5e9c794626 Mon Sep 17 00:00:00 2001 From: Aimen Sahnoun Date: Mon, 2 Mar 2026 02:07:08 +0400 Subject: [PATCH] =?UTF-8?q?docs(api-features):=20rewrite=20standard-paymen?= =?UTF-8?q?ts=20with=20verified=20API=20flow=20Refactor=20`api-features/st?= =?UTF-8?q?andard-payments.mdx`=20from=20AI-generated=20placeholder=20cont?= =?UTF-8?q?ent=20into=20a=20clearer,=20endpoint-driven=20page=20aligned=20?= =?UTF-8?q?with=20current=20API=20behavior.=20-=20removed=20AI=20warning?= =?UTF-8?q?=20banner=20and=20unsupported=20assumptions=20-=20clarified=20s?= =?UTF-8?q?tandard=20payments=20as=20same-currency=20flows=20where=20=20?= =?UTF-8?q?=20`invoiceCurrency`=20and=20`paymentCurrency`=20match=20-=20sp?= =?UTF-8?q?lit=20behavior=20between=20Native=20and=20ERC20=20payments=20wi?= =?UTF-8?q?th=20accurate=20=20=20execution=20characteristics=20(approval?= =?UTF-8?q?=20vs=20no-approval=20paths)=20-=20added=20practical=20?= =?UTF-8?q?=E2=80=9CHow=20It=20Works=E2=80=9D=20steps=20with=20direct=20en?= =?UTF-8?q?dpoint=20references:=20=20=20-=20POST=20/v2/request=20=20=20-?= =?UTF-8?q?=20POST=20/v2/payouts=20=20=20-=20GET=20/v2/request/{requestId}?= =?UTF-8?q?/pay=20-=20replaced=20vague=20token/network=20claims=20(e.g.=20?= =?UTF-8?q?=E2=80=9C500+=20tokens=E2=80=9D)=20with=20=20=20references=20to?= =?UTF-8?q?=20authoritative=20supported-currency=20resources=20-=20removed?= =?UTF-8?q?=20hidden/unsupported=20use-case=20links=20(`payouts`,=20`payro?= =?UTF-8?q?ll`)=20=20=20and=20kept=20active=20links=20(`invoicing`,=20`che?= =?UTF-8?q?ckout`)=20-=20updated=20technical=20reference=20to=20canonical?= =?UTF-8?q?=20OpenAPI=20docs:=20=20=20https://api.request.network/open-api?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- api-features/standard-payments.mdx | 84 +++++++++++++++++++----------- 1 file changed, 55 insertions(+), 29 deletions(-) diff --git a/api-features/standard-payments.mdx b/api-features/standard-payments.mdx index 074fb69..e019fbe 100644 --- a/api-features/standard-payments.mdx +++ b/api-features/standard-payments.mdx @@ -3,60 +3,86 @@ title: "Standard Native & ERC20 Payments" description: "Simple crypto-to-crypto payments using native currencies and ERC20 tokens" --- - -**AI-Generated Content** – This page was generated with AI assistance and may contain inaccuracies. While likely close to accurate, please verify critical details with the [stable documentation](https://docs.request.network) or [contact support](https://github.com/orgs/RequestNetwork/discussions). - - ## Overview -Standard payments are the simplest form of crypto transactions - sending tokens directly from one wallet to another without conversion or crosschain routing. +Standard payments are same-currency payments where `invoiceCurrency` and `paymentCurrency` match. + +Use this type when you want straightforward crypto settlement without conversion or crosschain routing. ## Native Currency Payments -Pay using blockchain native currencies like ETH, MATIC, BNB. +Pay with network native currencies (for example ETH on Ethereum-compatible networks). -**Benefits:** -- No token approval required -- Fastest execution -- Lowest gas costs +**Characteristics:** +- no ERC20 allowance step +- one payment transaction in most cases +- payer covers gas in native token ## ERC20 Token Payments -Pay using standard tokens like USDC, USDT, DAI. +Pay with ERC20 tokens such as USDC, USDT, and DAI (depending on chain support). + +**Characteristics:** +- may require approval before payment +- API can return approval calldata when needed +- payment then executes with token transfer transaction(s) + +## How It Works + + + +Use either: + +- [POST /v2/request](https://api.request.network/open-api/#tag/v2request/POST/v2/request) for request-first flows +- [POST /v2/payouts](https://api.request.network/open-api/#tag/v2payouts/POST/v2/payouts) for payment-first flows + +For standard payments, set matching values for `invoiceCurrency` and `paymentCurrency`. + + + +Fetch payment payload with [GET /v2/request/{requestId}/pay](https://api.request.network/open-api/#tag/v2request/GET/v2/request/{requestId}/pay) when using request-first flow. + +The response includes: -**Benefits:** -- Stable value (stablecoins) -- Wide acceptance -- Predictable costs +- payment transaction calldata +- approval calldata when token approval is required +- metadata such as `stepsRequired` and `needsApproval` + + + +For native payments, execute the payment transaction. + +For ERC20 payments, execute approval first if needed, then execute the payment transaction. + + ## Supported Networks & Tokens - - Ethereum, Polygon, Arbitrum, Base, Optimism, BSC, Avalanche, Fantom, Tron + + Choose valid chain/token pairs from the supported currencies and chains catalog. - - USDC, USDT, DAI, and hundreds more across all networks + + Supports native currency payments and ERC20 token payments. +Use [Supported Chains and Currencies](/resources/supported-chains-and-currencies) and [Request Network Token List](/resources/token-list) for current availability. + ## Used In - - - Direct vendor payments - - - - Employee compensation - + Simple crypto invoices + + + Direct same-currency checkout payments + -## Implementation Details +## API Reference -See [API Reference - Standard Payments](/api-reference/standard-payments) for complete technical documentation. \ No newline at end of file +For full endpoint schemas and examples, see [Request Network API Reference](https://api.request.network/open-api).