От каталога
до выдачи товара

{
  "ok": true,
  "data": {
    "telegram_id": "123456789",
    "username": "example_user",
    "balance_kopeks": 100000,
    "held_kopeks": 19900,
    "limits": {
      "requests_per_minute": 60
    },
    "api_access": "enabled",
    "balance": "1000.00",
    "held": "199.00",
    "currency": "RUB",
    "settlement_currency": "RUB",
    "exchange_rate": null
  }
}

{
  "ok": true,
  "data": {
    "id": "LF-API-EXAMPLE1-A1B2C",
    "client_order_id": "store-1042",
    "status": "delivered",
    "channel": "api",
    "is_test": false,
    "product": {
      "id": 42,
      "name": "Example product"
    },
    "quantity": 1,
    "unit_price_kopeks": 19900,
    "total_kopeks": 19900,
    "held_kopeks": 0,
    "charged_kopeks": 19900,
    "refunded_kopeks": 0,
    "failure_code": null,
    "failure_message": null,
    "created_at": "2026-09-21 09:00:00",
    "updated_at": "2026-09-21 09:00:02",
    "delivery_data": "example@example.com | FictionalPassword123",
    "unit_price": "199.00",
    "held": "0.00",
    "total": "199.00",
    "charged": "199.00",
    "refunded": "0.00",
    "currency": "RUB",
    "settlement_currency": "RUB",
    "exchange_rate": null
  }
}

{
  "idempotency_key": "store-order-1042",
  "body": {
    "product_id": 42,
    "quantity": 1,
    "max_total_kopeks": 19900,
    "client_order_id": "1042"
  }
}

// Node.js 22+. Keep API_KEY on your server.
// Save operation.json before the first request; reuse it after a restart.
import { readFile } from "node:fs/promises";

const base = "https://littlefox-api.ru/api/v1";
const apiKey = process.env.API_KEY;
const operation = JSON.parse(await readFile("operation.json", "utf8"));
if (!apiKey || !operation.idempotency_key || !operation.body) {
  throw new Error("API_KEY and a saved operation are required");
}
const body = JSON.stringify(operation.body);
const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
let orderId;
let delivery;

for (let attempt = 0; attempt < 6; attempt++) {
  let response, result;
  try {
    response = await fetch(base + (orderId
      ? "/orders/" + encodeURIComponent(orderId) : "/orders"), {
      method: orderId ? "GET" : "POST",
      headers: {
        Authorization: "Bearer " + apiKey,
        "Content-Type": "application/json",
        "Idempotency-Key": operation.idempotency_key,
      },
      ...(orderId ? {} : { body }),
      signal: AbortSignal.timeout(30000),
    });
    result = await response.json();
  } catch {
    // The result is unknown. Never replace the saved operation.
    await sleep(Math.min(5000 * 2 ** attempt, 60000));
    continue;
  }
  const order = result.data;
  if (order?.id) orderId = order.id;
  if (order?.status === "delivered") {
    delivery = order.delivery_data;
    break;
  }
  if (["failed", "refunded"].includes(order?.status)) {
    throw new Error(order.status + ": " + order.failure_code);
  }
  const pending = ["processing", "recovering"].includes(order?.status);
  if (pending || response.status === 429 || response.status >= 500) {
    const retry = Number(response.headers.get("Retry-After")) || 5;
    await sleep(Math.max(5, retry, Math.min(2 ** attempt * 5, 60)) * 1000);
    continue;
  }
  throw new Error(result.error?.code || "unexpected_response");
}
if (delivery === undefined) {
  throw new Error("Still unresolved; resume with the SAME operation.json");
}
// Save the entire delivery securely; do not log it or split its format.
// The value in delivery is the completed result.

{
  "ok": true,
  "data": {
    "id": "LF-API-EXAMPLE1-A1B2C",
    "client_order_id": "store-1042",
    "status": "processing",
    "channel": "api",
    "is_test": false,
    "product": {
      "id": 42,
      "name": "Example product"
    },
    "quantity": 1,
    "unit_price_kopeks": 19900,
    "total_kopeks": 19900,
    "held_kopeks": 19900,
    "charged_kopeks": 0,
    "refunded_kopeks": 0,
    "failure_code": null,
    "failure_message": null,
    "created_at": "2026-09-21 09:00:00",
    "updated_at": "2026-09-21 09:00:00",
    "delivery_data": null,
    "unit_price": "199.00",
    "held": "199.00",
    "total": "199.00",
    "charged": "0.00",
    "refunded": "0.00",
    "currency": "RUB",
    "settlement_currency": "RUB",
    "exchange_rate": null
  }
}

{
  "ok": true,
  "data": {
    "id": "LF-API-EXAMPLE1-A1B2C",
    "client_order_id": "store-1042",
    "status": "refunded",
    "channel": "api",
    "is_test": false,
    "product": {
      "id": 42,
      "name": "Example product"
    },
    "quantity": 1,
    "unit_price_kopeks": 19900,
    "total_kopeks": 19900,
    "held_kopeks": 0,
    "charged_kopeks": 0,
    "refunded_kopeks": 19900,
    "failure_code": "purchase_rejected",
    "failure_message": "The purchase could not be completed. Any reserved funds have been returned.",
    "created_at": "2026-09-21 09:00:00",
    "updated_at": "2026-09-21 09:00:02",
    "delivery_data": null,
    "unit_price": "199.00",
    "held": "0.00",
    "total": "199.00",
    "charged": "0.00",
    "refunded": "199.00",
    "currency": "RUB",
    "settlement_currency": "RUB",
    "exchange_rate": null
  }
}

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "LF-API-EXAMPLE1-A1B2C",
        "client_order_id": "store-1042",
        "status": "delivered",
        "channel": "api",
        "is_test": false,
        "product": {
          "id": 42,
          "name": "Example product"
        },
        "quantity": 1,
        "unit_price_kopeks": 19900,
        "total_kopeks": 19900,
        "held_kopeks": 0,
        "charged_kopeks": 19900,
        "refunded_kopeks": 0,
        "failure_code": null,
        "failure_message": null,
        "created_at": "2026-09-21 09:00:00",
        "updated_at": "2026-09-21 09:00:02",
        "unit_price": "199.00",
        "held": "0.00",
        "total": "199.00",
        "charged": "199.00",
        "refunded": "0.00",
        "currency": "RUB",
        "settlement_currency": "RUB"
      }
    ],
    "page": 1,
    "limit": 20,
    "has_more": false,
    "currency": "RUB",
    "settlement_currency": "RUB",
    "exchange_rate": null
  }
}

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": 1042,
        "amount_kopeks": -19900,
        "type": "purchase",
        "order_id": "LF-API-EXAMPLE1-A1B2C",
        "channel": "api",
        "created_at": "2026-09-21 09:00:00",
        "amount": "-199.00",
        "currency": "RUB",
        "settlement_currency": "RUB"
      }
    ],
    "page": 1,
    "limit": 30,
    "has_more": false,
    "currency": "RUB",
    "settlement_currency": "RUB",
    "exchange_rate": null
  }
}