⚙️API Only
For more sophisticated and adaptable solutions, you can utilize the API Only type of integration.
Prerequisites
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.
Request web-hook is configured.
Integration
1. Create Fixed Price Request through Inqud API
Request Example:
POST https://api.inqud.com/v1/user/crypto-acquiring/{projectId}/requests
Request Headers:
X-Token-API-Id: {tokenApiId}
X-Token-API-Secret: {tokenApiSecret}
Request Body:
{
"amount": 100,
"amountIn": "USD",
"clientOrderId": "1234567890",
"cryptoCurrency": "ETHEREUM_USDT"
}
Response Example:
{
"id": "CAPD-8f57bdbe-b485-41e2-a850-ef4feb45759c",
"orderId": "ORD-5e5e6551-3cae-4124-a299-6fef30105fb9",
"clientOrderId": "1234567890",
"currency": "USDT",
"blockchain": "ETHEREUM",
"status": "WAITING_PAYMENT",
"reason": null,
"cryptoAcquiringProjectId": "CAP-df02b127-6717-4a73-a231-5a57155308a5",
"cryptoAcquiringProjectName": "test",
"checkoutId": null,
"address": "0xd954c250e68d2e4585a83d01c2f620ca0f9e94e5",
"paymentWindowEndsAt": "2023-12-22T09:49:13.124979025Z",
"expiresAt": "2023-12-22T09:49:13.125002012Z",
"createdAt": "2023-12-22T09:39:13.125003488Z",
"lastUpdatedAt": null,
"paymentStatus": null,
"paymentId": null,
"payment": null,
"txHash": null,
"requestAmount": 100,
"requestAmountIn": "USD",
"requestAmountConverted": 99.46291,
"convertPair": "USDTUSD",
"convertRate": 1.0054,
"payAmount": 99.46291,
"payerPlatformFee": 0,
"payerFixedPlatformFee": null,
"payerPercentPlatformFee": null,
"merchantPlatformFee": 5.07315,
"merchantFixedPlatformFee": 0.1,
"merchantPercentPlatformFee": 5,
"processingAmount": 94.38976,
"paidAmount": null,
"overpaid": false,
"minLimit": null,
"maxLimit": null
}
The following fields in the response are the most important:
Request Example:
POST https://api.inqud.com/v1/user/crypto-acquiring/{projectId}/requests
Request Headers:
X-Token-API-Id: {tokenApiId}
X-Token-API-Secret: {tokenApiSecret}
Request Body:
{
"clientOrderId": "12345672890",
"cryptoCurrency": "ETHEREUM_USDT"
}
Response Example:
{
"id": "CAPD-f275c7af-a369-4351-a8e2-22b74c853933",
"orderId": "ORD-812db356-a8d4-4890-8e15-df086500db8f",
"clientOrderId": "12345672890",
"currency": "USDT",
"blockchain": "ETHEREUM",
"status": "WAITING_PAYMENT",
"reason": null,
"cryptoAcquiringProjectId": "CAP-df02b127-6717-4a73-a231-5a57155308a5",
"cryptoAcquiringProjectName": "kasdk",
"checkoutId": null,
"address": "0xb9253575b8acaf51fe8ab92b05f5dd64d09c9244",
"paymentWindowEndsAt": "2023-12-22T10:06:14.889894454Z",
"expiresAt": "2023-12-22T10:06:14.88990107Z",
"createdAt": "2023-12-22T09:56:14.889902585Z",
"lastUpdatedAt": null,
"paymentStatus": null,
"paymentId": null,
"payment": null,
"txHash": null,
"requestAmount": null,
"requestAmountIn": null,
"requestAmountConverted": null,
"convertPair": null,
"convertRate": null,
"payAmount": null,
"payerPlatformFee": null,
"payerFixedPlatformFee": null,
"payerPercentPlatformFee": null,
"merchantPlatformFee": null,
"merchantFixedPlatformFee": 0.1,
"merchantPercentPlatformFee": 5,
"processingAmount": null,
"paidAmount": null,
"overpaid": false,
"minLimit": 1,
"maxLimit": 1000
}
The following fields in the response are the most important:
Request Example:
POST https://api.inqud.com/v1/user/crypto-acquiring/{projectId}/requests
Request Headers:
X-Token-API-Id: {tokenApiId}
X-Token-API-Secret: {tokenApiSecret}
Request Body:
{
"amount": 100,
"amountIn": "USD",
"clientOrderId": "1234567890",
"cryptoCurrency": "ETHEREUM_USDT"
}
Response Example:
{
"id": "CAPD-8f57bdbe-b485-41e2-a850-ef4feb45759c",
"orderId": "ORD-5e5e6551-3cae-4124-a299-6fef30105fb9",
"clientOrderId": "1234567890",
"currency": "USDT",
"blockchain": "ETHEREUM",
"status": "WAITING_PAYMENT",
"reason": null,
"cryptoAcquiringProjectId": "CAP-df02b127-6717-4a73-a231-5a57155308a5",
"cryptoAcquiringProjectName": "test",
"checkoutId": null,
"address": "0xd954c250e68d2e4585a83d01c2f620ca0f9e94e5",
"paymentWindowEndsAt": "2023-12-22T09:49:13.124979025Z",
"expiresAt": "2023-12-22T09:49:13.125002012Z",
"createdAt": "2023-12-22T09:39:13.125003488Z",
"lastUpdatedAt": null,
"paymentStatus": null,
"paymentId": null,
"payment": null,
"txHash": null,
"requestAmount": 100,
"requestAmountIn": "USD",
"requestAmountConverted": 99.46291,
"convertPair": "USDTUSD",
"convertRate": 1.0054,
"payAmount": 99.46291,
"payerPlatformFee": 0,
"payerFixedPlatformFee": null,
"payerPercentPlatformFee": null,
"merchantPlatformFee": 5.07315,
"merchantFixedPlatformFee": 0.1,
"merchantPercentPlatformFee": 5,
"processingAmount": 94.38976,
"paidAmount": null,
"overpaid": false,
"minLimit": null,
"maxLimit": null
}
2. Receive a web-hook notification related to the request
Last updated