Перейти к содержимому

API

На странице

Подтверждение

Фиксируйте токен и сеть для счёта с ценой в фиатной валюте из собственного интерфейса и безопасно показывайте реквизиты оплаты.

POST/v1/invoices/:invoice_id/confirm-payment

API-ключ: Payment

Подтверждает стейблкоин и сеть, которые клиент выбрал для фиатного инвойса, пока тот в статусе awaiting_client. Paymos фиксирует курс, назначает адрес для зачисления и переводит инвойс в awaiting_payment.

Используйте, когда рисуете свой white-label чекаут и получаете выбор токена на своём сервере. Платёжная страница Paymos — payment_url, iframe-встройка и Widget SDK — подтверждает выбор клиента своим браузерным путём, поэтому для них этот эндпоинт вызывать не нужно.

Тело запроса

Параметр Тип Обязателен Описание
currency string Да Стейблкоин, которым клиент решил платить (например, USDT, USDC). Должен быть включён в проекте инвойса
network string Да Сеть, в которой клиент решил платить (например, TRC20, BASE) — должна быть сетью, где этот токен включён 
{
  "currency": "USDT",
  "network": "TRC20"
}

Ответ (200 OK)

Возвращает инвойс целиком с заполненной секцией payment — выбранные currency / network, назначенный адрес address, зафиксированный exchange_rate и ожидаемую сумму expected. Поскольку вызов аутентифицирован ключом мерчанта, в ответе также есть merchant-поля fee и net. Структура — как у Получения инвойса.

Ошибки

См. Коды ошибок — полный каталог. URI в поле type каждой ошибки ведёт сразу на нужную строку. Подтверждение чужого инвойса возвращает 404. Инвойс в expired или cancelled — 410; любой другой статус после awaiting_client — 409, включая терминальные paid, paid_over и underpaid.

Список инвойсов Получение инвойса