The Invoice API supports various payment scenarios to fit different merchant needs. These scenarios show you how to configure each request to receive exact crypto amounts, convert to fiat, or display local currency equivalents for your customers.

We have grouped these scenarios into five categories based on what you want to receive and how you want to display values to your customers.

🚧
The values of the crypto currencies are for reference

1. Direct Crypto Payments

Here, the merchant specifies an exact crypto amount and receives that same amount when the customer pays. No conversion happens. What the customer pays is exactly what the merchant receives.

Use this when:

You want to receive a fixed amount of cryptocurrency
You don't need fiat conversion
You want a straightforward crypto-to-crypto payment

Accept Exact Stablecoin

This is the simplest scenario. You specify the exact stablecoin amount you want, and you receive exactly that. No conversion, no calculations. For example, you want 100 USDT, your customer pays 100 USDT, and you receive 100 USDT in your account. The recipe below includes an example request and response for this scenario.

Accept Exact Cryptocurrency

This is another straightforward scenario where you specify the exact cryptocurrency amount you want, and you receive exactly that. No conversion, no calculations. For example, you want 100 ETH, your customer pays 100 ETH, and you receive 100 ETH in your account. The recipe below includes an example request and response for this scenario.

2. Crypto to Fiat Conversion

The merchant specifies a fiat amount they want to receive (e.g., 100 USD), and the API calculates how much crypto the customer needs to pay. The merchant is credited in fiat after conversion, protecting them from crypto price volatility.

Use this when:

You want to receive a guaranteed fiat amount
You want to avoid crypto price volatility
Your accounting is fiat-based

Accept Stablecoin with Fiat Conversion

Here, you want a guaranteed fiat amount and your customer pays in stablecoin. The API handles the conversion so you don't have to worry about price changes. For example, you want 100 USD, the API calculates that's 100.04 USDT, your customer pays 100.04 USDT, and you receive exactly 100 USD. The recipe below includes an example request and response for this scenario.

Accept Cryptocurrency with Fiat Conversion

In this scenario, you want a guaranteed fiat amount and your customer pays in cryptocurrency. The API handles the conversion so you don't have to worry about price volatility. For example, you want 100 USD, the API calculates that's 0.00095 BTC, your customer pays 0.00095 BTC, and you receive exactly 100 USD. The recipe below includes an example request and response for this scenario.

3. Crypto to Fiat Conversion with Local Currency Display

The merchant receives fiat from a crypto payment, while showing the customer a local currency equivalent (e.g., CNY) for reference. The cashierCurrency is for display only. It helps customers understand the value in their local currency but does not affect the actual payment.

Use this when:

Your customers are in a region with a different local currency
You want customers to see a familiar currency value for reference
You still want to receive fiat after conversion

Accept Stablecoin with Fiat Conversion and Local Currency Display

In this scenario, you receive fiat from a stablecoin payment while showing your customer a local currency equivalent for reference. The local currency display helps your customer understand what they're paying without affecting the actual payment. For example, you want USD from USDT with CNY display, your customer sees 712.05 CNY for reference but pays 100 USDT, and you receive 99.96 USD. The recipe below includes an example request and response for this scenario.

Accept Cryptocurrency with Fiat Conversion and Local Currency Display

This scenario lets you receive fiat from a cryptocurrency payment while showing your customer a local currency equivalent for reference. The local currency display helps your customer understand what they're paying without affecting the actual payment. For example, you want USD from ETH with CNY display, your customer sees 2,526,437.48 CNY for reference but pays 100 ETH, and you receive 354,910 USD. The recipe below includes an example request and response for this scenario.

4. Local Currency-Based Crypto Payments

The merchant prices a product in a local currency (e.g., 1000 CNY), and the API calculates the crypto equivalent. The customer sees the local currency value for reference but pays in crypto. The merchant receives crypto, not fiat.

Use this when:

You want to price products in a local currency your customers understand
You want to receive cryptocurrency, not fiat
You want to simplify pricing for regional customers

Accept Cryptocurrency Based on Local Currency Amount

This covers when you want to price your product in a local currency that your customer understands, but receive cryptocurrency. The API converts the local currency amount to crypto for you. For example, you price a product at 1000 CNY, the API calculates that's 0.03962 ETH, your customer sees 1000 CNY for reference but pays 0.03962 ETH, and you receive 0.03962 ETH. The recipe below includes an example request and response for this scenario.

Accept Stablecoin Based on Local Currency Amount

This is useful when you want to price your product in a local currency that your customer understands, but receive stablecoin. The API converts the local currency amount to stablecoin for you. For example, you price a product at 1000 CNY, the API calculates that's 140.48 USDT, your customer sees 1000 CNY for reference but pays 140.48 USDT, and you receive 140.48 USDT. The recipe below includes an example request and response for this scenario.

5. Direct Crypto Payments with Local Currency Display

The merchant specifies an exact crypto amount and receives that same amount. The cashierCurrency shows the customer a local currency equivalent for reference but does not affect the payment.

Use this when:

You want to receive a fixed crypto amount
You want customers to see a local currency value for reference
You don't need fiat conversion

Accept Exact Cryptocurrency with Local Currency Display

This scenario is for when you want to receive an exact cryptocurrency amount while showing your customer a local currency equivalent for reference. This helps customers who aren't familiar with crypto values understand what they're paying. For example, you want 100 ETH with CNY display, your customer sees 2,276,038.17 CNY for reference but pays 100 ETH, and you receive 100 ETH. The recipe below includes an example request and response for this scenario.

Accept Exact Stablecoin with Local Currency Display

Here, you receive an exact stablecoin amount while showing your customer a local currency equivalent for reference. This helps customers who aren't familiar with crypto values understand what they're paying. For example, you want 100 USDT with CNY display, your customer sees 711.78 CNY for reference but pays 100 USDT, and you receive 100 USDT. The recipe below includes an example request and response for this scenario.