Подтверждение оплаты (Accept Order)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude
Connect to Cursor
Install MCP server on Cursor
Connect to VS Code
Install MCP server on VS Code

После создания котировки подтвердите её для выполнения платежа.

Endpoint

POST /orders/accept/{id}

Параметры

Параметр	Расположение	Тип	Обязательный	Описание
`id`	path	uuid	Да	ID котировки
`Idempotency-Key`	header	string	Нет	Ключ идемпотентности

Идемпотентность

Заголовок Idempotency-Key гарантирует, что повторные запросы не создадут дублирующие платежи:

curl -X POST 'https://b2b.lumowallet.io/orders/accept/550e8400-e29b-41d4-a716-446655440000' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Idempotency-Key: accept-order-12345'

При повторном запросе с тем же Idempotency-Key:

Если ордер уже создан — вернётся существующий ордер
Новый платёж не будет инициирован

Рекомендация: Всегда используйте Idempotency-Key на продакшене.

Пример ответа

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amountUsdt": 52.63,
  "amountRub": 5000.00,
  "status": "in_progress",
  "paymentUntil": "2026-03-10T12:05:00Z",
  "merchantName": "ООО Кофейня",
  "externalOrderId": "order-12345",
  "completedAt": null,
  "failureReason": null,
  "createdAt": "2026-03-10T12:00:00Z"
}

Поля ответа

Поле	Тип	Описание
`id`	uuid	ID ордера
`amountUsdt`	number	Сумма в USDT
`amountRub`	number	Сумма в рублях
`status`	string	Текущий статус
`paymentUntil`	datetime	Дедлайн выполнения платежа
`merchantName`	string	Название получателя
`externalOrderId`	string	Ваш внутренний ID
`completedAt`	datetime	Время завершения (при success/failed)
`failureReason`	string	Причина ошибки (при failed)
`createdAt`	datetime	Время создания

Что происходит после accept

Резервирование средств — amountUsdt блокируется на frozenBalance
Отправка в wallet-backend — инициируется оплата QR
Статус in_progress — ожидание подтверждения
Webhook — уведомление о финальном статусе

Таймауты

paymentUntil — дедлайн для выполнения платежа системой
Если платёж не выполнен до дедлайна — статус expired_by_system
Средства разблокируются и возвращаются на баланс

Ошибки

Код	Ошибка	Описание
400	`Quote expired`	Котировка истекла (TTL 30 сек)
400	`Insufficient balance`	Недостаточно средств
400	`Quote already accepted`	Котировка уже подтверждена
401	`Unauthorized`	Неверный API-ключ
404	`Quote not found`	Котировка не найдена

Пример полного flow

# 1. Создаём котировку
QUOTE=$(curl -s -X POST 'https://b2b.lumowallet.io/orders/prepare' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"qrCode": "https://qr.nspk.ru/..."}')

QUOTE_ID=$(echo $QUOTE | jq -r '.id')

# 2. Подтверждаем
curl -X POST "https://b2b.lumowallet.io/orders/accept/$QUOTE_ID" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Idempotency-Key: my-unique-key'

Что дальше?

Жизненный цикл ордера — все статусы и переходы
Webhooks — получение уведомлений о статусе