Widget
Last updated
Last updated
The Inqud Crypto Widget stands at the heart of our crypto acquiring platform, serving as the primary interface for configuring and managing cryptocurrency payments. It's designed to be both powerful and user-friendly, ensuring that businesses can effortlessly tailor their crypto payment processes.
To start working with the widget, it is necessary to proceed with the setup.
After creating the widget, by default, all currencies in it are disabled. To enable the payment acceptance feature through the widget, you need to activate currencies for a specific widget. All available currencies for activation will be displayed in the settings.
Please note that the merchant has the ability not only to enable specific tokens but also to choose specific networks for each of these tokens.
Currently supported blockchains and cryptocurrencies:
For added convenience, you can activate the auto-conversion feature. This helps mitigate risks associated with highly volatile currencies. How does it work? Upon enabling this feature, you'll need to choose a specific currency into which you want to convert incoming payments in the selected currency. After activating this setting, all payments received through the widget in the chosen currency will be automatically converted based on market rates.
For each currency, there are fees associated with deposits. By default, these fees are deducted from the deposit amount, meaning they are automatically charged to the merchant's account.
However, with flexible settings, you have the option to shift these fees to the end user. This can be done in two ways:
Displaying the Fee in the Widget: You can configure the system so that the end user sees the actual fee for each payment directly in the widget.
Hiding Fee Information: With an additional setting, you can disable the display of information about the charged fee for the end user, making it invisible to them.
These flexible settings allow you to tailor the fee system according to your preferences and business strategy.
Payment: This refers to the actual transaction that is recorded on the blockchain. A payment includes key details such as the blockchain used, the type of token, the transaction amount, and the target address.
Request: A request is an action initiated by a merchant, directed at the end user, to make a payment in a specific cryptocurrency on a designated blockchain.
Checkout: Checkout constitutes a request from the merchant to the end user for the payment of a monetary amount, which can be optionally predefined, and is usually expressed in USD or other fiat currencies. In this process, the end user is granted the flexibility to choose the blockchain and cryptocurrency through which they wish to make the payment.
Explore subjects in more details:
Webhooks provide merchants with the capability to receive real-time notifications about cryptocurrency payment transactions. This feature enables seamless synchronization and updating of their internal systems with the latest payment information.
Inqud facilitates comprehensive notification services for merchants on three distinct levels:
Checkouts: Receive updates specifically related to the checkout process.
Requests: Get notified about various payment requests initiated by merchant.
Payments: Stay informed about the status and details of actual payment transactions.
Refer to Web Hooks page to grasp into technical details:
To utilize the Inqud Crypto Widget in embedded mode, merchants must first verify the domain where the widget will be placed. Upon successful verification and approval of the domain, the merchant can then associate it with the widget, paving the way for integration into their system.
Navigate to the "Crypto widgets" section and select "Widgets."
Choose the widget to which you want to link the domain.
In the profile of the selected widget, locate the "Domain Management" section.
In the dropdown list, choose the desired domain. Please note that only widgets for which you have completed Inqud verification will be displayed in the list.
For more details please refer to:
To enhance user experience, merchants can preselect the most suitable amounts for the checkout process.
Go to the "Crypto widgets" section and select "Widgets."
Choose the widget where you want to set predefined checkout amounts.
In the selected widget's profile, find the "Predefined amount" section.
Click "Set up predefined amount."
You can choose up to 3 predefined amounts. Optionally, you can enable manual input so that users can enter their own amount during checkout.
Predefined amount setting will only have an effect on checkouts of type Predefined amounts (SUGGESTED_FIXED_PRICE in API).
Given the following settings:
The widget will display:
Merchants can generate checkout links via the Inqud App to accept crypto payments, which can then be shared with customers.
When creating a payment link, the following parameters should be specified:
Product Name: The name of the product, displayed to the customer.
Client Order ID: A merchant-provided ID used for tracking orders.
Return URL: The link to the merchant’s website where the customer is redirected after payment.
Expires At: Until what time the link stays accessible.
Additional inputs depending on selected checkout type.
To create a payment link:
Go to the "Crypto widgets" section and select "Widgets."
Choose the widget with which you want to create a payment link.
In the selected widget's profile, find the "Payment links" section.
Click "Create", fill all required field then click "Create" again
You should get a checkout link that you can share with a user.
After creating a payment link, a corresponding checkout will also be generated. You can find the new checkout in the "Checkouts" tab within the Widget's profile.
You can also create the payment link through the API. For more details, refer to the integration instructions: Redirect payment flow
If you have not yet verified a domain, follow the instructions at to complete the verification process.
Checkout Type: Select the type of checkout experience. Learn more:
