Skip to main content
When a payment request is created in fixed mode, the payment currency and network are provided via the API. The customer skips currency selection on the CryptoProcessing payment page, while the exchange rate is locked and the payment timer starts immediately upon creation. The API immediately returns the fixed payment details, which can be used to redirect the customer directly to the payment page or within your own payment experience.
This is an advanced integration guide. This guide is intended for merchants who already provide currency selection within their own checkout.For most merchants, we recommend following the standard integration guide, where customers select the payment currency and network on the CryptoProcessing payment page. This requires less implementation effort and automatically supports newly added currencies and networks.
1

Complete your onboarding

Configure your account and get an API key, see Initial setup.
2

Pre-select the payment method

When the customer wants to make a new purchase, show them a screen for selecting the cryptocurrency and the network.The list of currencies and networks accepted by CryptoProcessing depends on the target currency that you want to receive on your balance. We recommend getting the list of currencies from /v2/currencies/rates. Specify the target currency in currency_to, then iterate through the results with the "crypto" type.
3

Create a payment request

Once the customer selected the cryptocurrency, send a request to /payments/v1/requests. Specify the currency and amount you want to receive on your balance, as well as the payment_currency according to the customer’s choice on the previous step.Set rate_mode to "fixed" to skip the currency selection step on the CryptoProcessing side.Note that the effective lifespan in the fixed rate mode will be no longer than 1 hour, as the payment timer will start immediately.
Request example
Response example
4

Let the customer navigate to the payment request interface

The URL of the interface is provided in the data.payment_link field of the API response. Depending on your payment flow, you can:
  • navigate the customer to the payment request link in a new tab,
  • generate a QR code based on the payment request link and display it to your customer,
  • embed the payment link as an iFrame for quick on-page checkout.
For the customer’s convenience, we recommend providing a link to the pending payment request somewhere on your site, too. This way, if the customer accidentally closes the payment request tab before finishing the payment, they will use the link to continue the process.
5

Process the callback

When you get the payment_request callback, update the purchase status on your site.Make sure to cover all possible statuses of the callback. For a failed payment request, consider showing a ‘Retry’ button that initiates a purchase of the same product again.
Last modified on August 10, 2026