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.