⚙️Checkout flow

Prerequisites

• Your business account with Inqud is set up, complete with API tokens configured.

• The On-Ramp Project has been established and configured within the Inqud platform.

• The On-Ramp Project is active.

Workflow

Checkout status transition

Integration

1. Create checkout through Inqud API

Create On-Ramp Checkout API Reference

Only Required Fields

Request Example: POST https://api.inqud.com/v1/user/on-ramp/{onRampProjectId}/checkouts

Header	Value
X-Token-API-Id	{tokenApiId}
X-Token-API-Secret	{tokenApiSecret}

Request Body Example:

{    
    "type": "FIXED_PRICE", // Type of checkout
    "fixedAmount": {
        "amount": 100,     // User pay amount
        "currency": "USD"  // User pay currency
    },
    "clientOrderId": null, // If not provided, identify by id or orderId from response
    "expiresAt": null,     // If not provided, used default: now() + 1 hour
    "merchantShareUserData": null, // If not provided, user will sign-in/up by himself
    "name": null,          // If not provided, user will not see it on payment page
    "returnUrl": null      // If not provided, user will not be redirected on payment complete
}

Response Example:

{
  "id": "ORCO-979d6f5d-f26b-4943-bc4f-eabc65787c6c", // Checkout id
  "onRampUrl": "https://onramp.inqud.com/checkout/ORCO-979d6f5d-f26b-4943-bc4f-eabc65787c6c", // User redirect payment URL
  "orderId": "ORD-ec9735a4-2098-479d-9f00-b142db4adfff", // Order id
  "projectId": "ORP-46dfa42b-6338-4c33-1e1d-cf7062053f22", // On-Ramp project ID
  "projectName": "My on-ramp project",  // On-Ramp project Name
  "sourceAmount": 90, // User pay amount, may be different from fixedAmount.amount if currency changed
  "sourceCurrency": "EUR",  // User pay currency, may be different from fixedAmount.currency
  "status": "PENDING",  // Checkout status
  "targetAmount": 99.5,  // Merchant receive amount
  "targetCurrency": "USDC", // Merchant receive currency
  "type": "FIXED_PRICE", // Checkout type
  "createdAt": "2026-01-01T00:00:00Z",
  "modifiedAt": "2026-01-01T00:00:00Z",
  "expiresAt": "2026-01-02T00:00:00Z",
  "name": null,
  "clientOrderId": null,
  "returnUrl": null,
  "deposit": null,
  "endUserId": null,
  "exchange": null,
  "transfer": null,
}

Required and Optional Fields

Share KYC

2. Receive a webhook when a checkout changes status

As checkout changes its statuses, webhook are being sent if configured. Webhook body contains same model as POST /checkouts response. Proceed to Web Hooks section for extra information and examples

🪝Web Hooks