Setup instructions
Last updated
Last updated
Why do you need to create a widget? A project represents an entity through which interaction with Inqud is conducted. By creating different projects (widgets), you can separate the flow of funds, which allows for more efficient financial operations. For example, if a merchant has two websites, they can create two separate projects with individual settings for each. This will not only separate the flow of funds but also allow unique parameters for each project, enabling more flexible management.
To create a new project (widget), follow these steps:
Go to your dashboard.
Open the Widgets page.
Click on Add new widget.
Enter the name of the widget in the form that appears.
Set the activation status using the Active toggle.
You can activate or deactivate the widget at any time.
This section displays all currently available deposit options that your users can use. You will see a list of cryptocurrencies and their corresponding networks. The list of activated currencies and networks determines what your users will see in their deposit currency list.
Use the Active toggle to manage currencies. When activated, all networks for the selected currency will be enabled.
If you wish to enable or disable specific networks, you can activate or deactivate the necessary networks by checking or unchecking the respective boxes.
You can choose the currency to which incoming funds will be converted for each specific cryptocurrency. To set up auto-conversion, select the desired currency from the list. All incoming payments in Currency 1 will be automatically converted to Currency 2.
A platform fee is charged for each transaction, which is deducted at the time the funds are received. For example, when 100 USDT is received, the fee might be 5 USDT, resulting in 95 USDT being credited to the balance. However, you can pass this fee on to your users by enabling the Fee is paid by end user setting. In this case, the fee will be passed to the end user after all calculations. Note that when this setting is enabled (when using the Inqud-branded UI), the user will be informed about the fee they will pay. If you do not want the user to see this information, you can activate the Hide fee from user setting. This way, the fee will still be charged to the user, but the information will not be displayed.
Important: This function is relevant only for checkouts with the Fixed_price type.
To use acquiring in the widget format, it is necessary to verify the domain on which the widget will be placed. To verify a domain, follow these steps:
Go to Widgets >> Domains.
Click the Add button.
Complete the form by entering the domain for verification (without using http:// or https://).
Submit the form.
The domain verification process can take up to 24 hours during business hours. Once the domain is successfully verified, it will be assigned the status Approved or Rejected.
If the domain is Approved, it can be linked to a project:
Go to the desired widget.
Open the Domain management tab.
You will see all verified domains in the list and can link any of them to the project.
Domain verification is required only for acquiring in widget format. For other acquiring formats, domain verification is not needed.
You need to set up webhooks for Requests and Checkouts.
Additional information about Requests can be found [at this link]
Additional information about Request webhooks can be found [at this link]
Additional information about Checkouts can be found [on this page]
Additional information about Checkout webhooks can be found [on this page]
Click ADD.
Enter the webhook URL (mandatory field) in the form that appears.
Optionally, provide a Webhook secret.
Click Submit to save the settings.
Additionally, we recommend setting up a webhook for Payments. Detailed instructions can be found [at this link].
How to set up the Predefined Amount model
To use the Predefined Amount model, follow these steps:
Go to the Predefined Amounts tab.
Click the Setup Predefined Amounts button.
In the pop-up window, select the currency that will be set as Amount In — the currency from which incoming cryptocurrency payments will be converted.
Enter up to three possible amount options in the input field in the selected currency.
Toggle Allow Manual Input to enable users to manually enter an amount in the chosen currency for deposits.
Save your settings.
Once the settings are saved, when using the Checkout Suggested Amount type, users will see the predefined options you configured.
Go to the Payment links tab: In your widget's settings, navigate to the Payment links tab.
Click on "Setup payment link": In this tab, locate and click the Setup payment link button to begin the payment link creation process.
Select the model and enter initial amount:
Choose the desired model from the dropdown menu.
Enter the initial amount that the user will need to pay (Note: Entering this amount is only relevant for the Fixed Price model).
Select the expiration date: Choose the date until which the link will remain active.
Create the Link: Once you’ve filled in the required fields, click to create the payment link.
Copy the Link: After the link is generated, copy it to share with your user.
