Skip to content

conversion-payments.mdx

Latest commit

 

History

History
70 lines (48 loc) · 2.59 KB

conversion-payments.mdx

File metadata and controls

70 lines (48 loc) · 2.59 KB
title Conversion Payments
description Requests denominated in one currency and settled in another with conversion at payment time

Overview

Conversion payments let you denominate a request in one currency (for example USD) and collect payment in a different currency (for example USDC or ETH).

This is useful when you want stable invoicing amounts while still collecting crypto on-chain.

How It Works

Create the request with [POST /v2/request](https://api.request.network/open-api/#tag/v2request/POST/v2/request):
  • invoiceCurrency: currency you want to denominate the request in (for example USD)
  • paymentCurrency: currency you want to receive on-chain (for example USDC-base)

The API stores both values and computes payable amounts using the configured rate source.

Use [GET /v2/request/{requestId}/pay](https://api.request.network/open-api/#tag/v2request/GET/v2/request/{requestId}/pay) to get transaction payloads, then execute on-chain.

At payment time, the converted amount is applied so the request can be settled in paymentCurrency.

Use [GET /v2/request/{requestId}](https://api.request.network/open-api/#tag/v2request/GET/v2/request/{requestId}) to inspect status fields such as:
  • amountInUsd
  • conversionRate
  • rateSource
  • conversionBreakdown (for multi-payment or partial-payment scenarios)

When a request is paid in multiple parts, conversion details are returned in the breakdown instead of a single conversion rate value.

Conversion Behavior

  • Single-payment requests can expose a direct conversionRate
  • Multi-payment or partial-payment requests return detailed conversionBreakdown
  • Rate source metadata is returned by the status endpoint

Supported Currencies and Chains

Use Request Network Token List and Supported Chains and Currencies to choose valid invoiceCurrency and paymentCurrency pairs.

Conversion behavior depends on the selected currency pair and network support.

Used In

Professional invoices in fiat E-commerce pricing

API Reference

For full endpoint schemas and examples, see Request Network API Reference.