API Integration

For full control over the payment experience, integrate iPint's APIs directly. The core workflow uses four endpoints.

Workflow

1. List supported currencies

   Call GET /currencies to get the list of cryptocurrencies your customers can pay with.

2. Get an estimated price

   Call GET /prices with the selected currency to get the current exchange rate and conversion limits.

3. Create a payment

   Call POST /invoice with the conversion details and amount to generate a QR code and deposit address for your customer.

4. Check payment status

   Call GET /invoice to verify the payment status. This is also triggered by the webhook callback when the status changes.

Endpoints at a glance

Example: create an invoice

// POST /invoice — Generate QR code
const response = await fetch(
  "https://api.ipint.io:8003/invoice",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      conversion_id: "1xmKHnsJH23",  // from /prices
      amount_in_usd: "1250.00",
      amount_in_crypto: "1250",
      crypto_code: "USDTERC20"
    }),
  }
);

const {
  invoice_id,
  deposit_address,
  qr_string,
  invoice_amount_in_crypto
} = await response.json();

// Display the QR code to your customer for payment

Base URLs

Full API documentation

For the complete REST API reference with all endpoints, parameters, and response schemas, see:

• API Reference — detailed endpoint documentation
• Interactive Swagger docs — try endpoints live
• GitHub examples — integration code

Next steps

• Authentication — how to sign requests with HMAC
• Receive a payment — step-by-step guide
• Testing on Testnet — test before going live