GITBOOK-170: feat: add new currencies conversion endpoint docs

bassgeta · gitbook-bot · commit da92ef5200ec · 2025-08-28T21:12:26.000Z
diff --git a/docs/request-network-api/crypto-to-fiat-payments.md b/docs/request-network-api/crypto-to-fiat-payments.md
@@ -56,6 +56,19 @@ Production access includes:
 
 For Crypto-to-fiat Payments, the Request Network API supports USDC on Ethereum, Polygon, Arbitrum One, and Sepolia.
 
+{% hint style="info" %}
+**Crypto-to-fiat Payment with non-USDC currencies:**
+
+While crypto-to-fiat requests must be created in USDC, users can pay in alternative currencies through a four-step process, using [crosschain-payments.md](crosschain-payments.md "mention"):
+
+1. **Create Crosschain Request**: Create a request to swap the payer's currency (e.g., ETH on Ethereum) to USDC on the target chain (e.g., USDC on Polygon). Note: Don't specify a payer address during request creation to allow flexibility in who can pay.
+2. **Pay Crosschain Request**: Execute the crosschain payment to fulfill the first request
+3. **Create Crypto-to-Fiat Request**: Create a separate request for the USDC offramp to fiat and bank deposit
+4. **Pay Crypto-to-Fiat Request**: Execute the crypto-to-fiat payment to complete the flow
+
+This four-step approach is required due to current API limitations - more streamlined flows are not yet implemented.
+{% endhint %}
+
 ## Understanding `clientUserId`
 
 Many `/payer` endpoints in the Request Network API require a `clientUserId` as a path parameter. This value is an **arbitrary identifier** chosen by your platform to represent a user (the payer) in your own system.
diff --git a/docs/request-network-api/recurring-payments.md b/docs/request-network-api/recurring-payments.md
@@ -99,7 +99,9 @@ Recurring payments are supported on the following Blockchain networks:
 
 ## Supported currencies
 
-The recurring payments support **all** **ERC20** currencies available in the supported networks
+The recurring payments support **all** **ERC20** currencies available in the supported networks.
+
+See the full list here [supported-chains-and-currencies.md](supported-chains-and-currencies.md "mention")
 
 ## How it works
 
diff --git a/docs/request-network-api/supported-chains-and-currencies.md b/docs/request-network-api/supported-chains-and-currencies.md
@@ -54,6 +54,8 @@ For Conversion Payments, the Request Network API supports the following _payment
 * DAI
 * FAU on Sepolia
 
+To get a list of supported _payment_ currencies for a given _invoice_ currency, use the [#get-v2-currencies-currencyid-conversion-routes](supported-chains-and-currencies.md#get-v2-currencies-currencyid-conversion-routes "mention") endpoint.
+
 ### Crosschain Payments Supported Currencies
 
 See [#crosschain-payments-supported-chains-and-currencies](crosschain-payments.md#crosschain-payments-supported-chains-and-currencies "mention")
@@ -93,3 +95,7 @@ Each token in the response includes:
 {% openapi-operation spec="request-api" path="/v2/currencies" method="get" %}
 [OpenAPI request-api](https://api.request.network/open-api/openapi.json)
 {% endopenapi-operation %}
+
+{% openapi-operation spec="request-api-staging" path="/v2/currencies/{currencyId}/conversion-routes" method="get" %}
+[OpenAPI request-api-staging](https://api.stage.request.network/open-api/openapi.json)
+{% endopenapi-operation %}
