⚙️API Integration
Last updated
Was this helpful?
Last updated
Was this helpful?
Your business account with Inqud is set up, complete with API tokens configured.
The Crypto Widget has been established and configured within the Inqud platform.
The Crypto Widget is active.
Static Address Payments web-hook is configured.
Create static bundle API Reference
Static addresses are created within static address bundles, each containing multiple unique addresses per blockchain/address type. A bundle is identified by a merchant-supplied referenceId and represents a set of addresses a single user can use to send funds across different blockchains.
Request Example:
POST https://api.inqud.com/v1/user/crypto-acquiring/{projectId}/static/bundles
projectId is the ID of the widget
X-Token-API-Id
{tokenApiId}
X-Token-API-Secret
{tokenApiSecret}
Request Body Example:
Response Example:
The endpoint follows a "getOrCreate" approach. On the first call with a specific referenceId, it creates a new bundle with static addresses. Subsequent calls with the same referenceId return the existing bundle. If an address for a requested asset is missing, it will generate and add it to the existing bundle.
The bundle reuses static addresses when possible. For example, if an Ethereum USDT address exists, a Polygon USDC address will be the same address. This allows a user to send different tokens across multiple blockchains using a single address.
If any static address in the bundle is disabled (e.g., due to AML rule violations), the endpoint will return a newly generated address for that asset.
The following fields in the response are the most important:
referenceId
Merchant-provided ID used to track incoming payments
addresses
List of static addresses in the bundle
addresses[].address
Static address for end-user payments
addresses[].active
true if the address can process deposits immediately; false if deposits may be delayed or temporarily unprocessed
addresses[].values.minLimit
Minimum amount the end user must send in a single transaction; otherwise, the payment will fail
addresses[].values.percentFee
A percentage fee is deducted from the incoming transaction amount
addresses[].values.fixedFee
A fixed fee is deducted from the incoming transaction amount
addresses[].values.networkFeeEstimate
An estimated fee deducted from the incoming transaction amount to cover Inqud's transfer costs from the address
addressesByAsset
Basically, the same as addresses but grouped by assets
When an end user sends crypto to the assigned static address, you receive a webhook upon payment detection by the Inqud system.
🪝Web HooksInqud does not currently convert payment amounts to other currencies. Use a separate endpoint for conversion if needed.
Request Example:
GET https://api.inqud.com/v1/user/crypto-acquiring/rates/{baseAsset}/{quoteAsset}
projectId is the ID of the widget
X-Token-API-Id
{tokenApiId}
X-Token-API-Secret
{tokenApiSecret}
Response Example:
