API счетов v1
Создание и проверка отдельных счетов существующей интеграции.
Для новых hosted-сессий используйте быстрый старт v2. Базовый адрес API: https://api.bramapay.com.
POST /v1/invoices
Передайте секрет проекта/режима в X-Api-Key, обязательный Idempotency-Key и Content-Type: application/json.
| Поле | Требование |
|---|---|
amount | Обязательная положительная десятичная строка |
asset | Обязательный символ доступного актива |
network | Обязательная доступная сеть для актива |
externalId | Обязательный постоянный идентификатор попытки заказа, 1–200 символов |
Ответ 201 содержит invoiceId, externalId, status, checkoutUrl, expiresAt в ISO-8601. Точной криптосуммы и адреса в этой проекции нет: используйте hosted checkout.
GET /v1/invoices/:invoiceId
Вернёт ту же проекцию для проверки сервером. Используйте секрет того же проекта/режима. Некорректный, отсутствующий или чужой ID возвращает 404 INVOICE_NOT_FOUND. Для выдачи нужны PAID и совпадение сохранённых invoice ID и external ID. Отмена не входит в узкий v1-контракт; отдельный endpoint кабинета — POST /invoices/:id/cancel.
Идемпотентность
Ключ содержит 1–128 ASCII-букв, цифр или символов ., _, :, -. Сохраните ключ и тело до запроса. При неизвестном исходе повторяйте неизменный запрос. Изменение тела под тем же ключом или конфликт с зарезервированным externalId даёт 409 IDEMPOTENCY_CONFLICT.
Это существующий контракт отдельных счетов Legacy v1. Новые hosted-интеграции начинайте с API v2. Явная оплата покупателем использует feePayer: "BUYER", pricingVersion: "BUYER_FEE_V1", baseAmountUsd вместо amount; политика проекта сохраняет базу заказа интеграции. См. контракты цены. Не меняйте идентичность запроса и смысл старых значений.