Старые версии

устарело

Что ещё работает, что снято и какая страница заменяет старые инструкции.

Синхронный чек

POST/gate/receiptHTTPTCP

Отправка и ожидание результата в одном запросе. Метод работает, существующие подключения можно не трогать, но для новых берите v4.

	HTTP	TCP
Ожидание	до 30 секунд	до 20 секунд
Формат ответа	полный, как в v4, есть `link`	укороченный
`needPrint`	работает	блок `print` не отдаётся

Документ тот же, что в v4, смешанная оплата этим методом не описана.

Ответ TCP

{ "id": "…", "status": "OK", "qr": "…", "amount": 610.00, "cashless": true, "fdNumber": "3160" }

Ошибка TCP

{ "status": "fail", "message": "Нет результата в течении 20 секунд" }

Если пришло «Нет результата в течении 20 секунд», документ не отменён, он остаётся в работе. Его судьбу можно узнать через receipt-status-v4 с тем же id.

Как перейти на v4

Замените путь /gate/receipt на /gate/receipt-v4.
После приёма добавьте опрос статуса.
Считайте чек пробитым только по статусу OK из receipt-status-v4.
Отправляйте смешанную оплату на receipt-v4-1 по HTTP.

Поля документа менять не нужно.

Платежи через /gate/bank

Метод POST /gate/bank из инструкции 2024 года снят: на демо и рабочем контуре он отвечает 404. Вместо него используйте:

Было	Стало
`"operation": "pay"`	документ `fiscal: false`, `cashless: true`, см. оплата без чека
`"operation": "reversal"` с `rrn`	возврат `INCOME_RETURN` с `fiscal: false` и `rrn`, см. возвраты
только TCP	`/payment` и `/status`

Старые инструкции

Если у вас на руках один из этих файлов, теперь актуальна страница справа.

Файл	Что с ним	Где теперь
API Обмена с YaKassa	устарел, только синхронный чек	чек v4
API Обмена с YaKassa v4	устарел, нет новых полей и TCP	обмен через кассу
API платежей через YaKassa	снято	способы оплаты
API YaKassa V2, V2-001, V2 EN	устарели, нет смены и наличных	фискализация без кассы
Intent Api YaKassa	устарел	Intent
API обмена HTTP и TCP	заменён этим сайтом	обмен через кассу
Обмен валют V2	заменён этим сайтом	обмен валюты
Протокол оплаты через TCP-сервер	заменён этим сайтом	оплата без чека
Оповещение внешней программы о чеках	заменён этим сайтом	оповещения

Поля в старых инструкциях в основном совпадают. Главные отличия:

Заголовок Content-Type: application/json обязателен: без него сервер отвечает 415, а в старых примерах его не было.
Запасной домен работает только с портом: ofd2.yaros.kg:8143.
Возврат по безналу на кассе с банком требует rrn или skip_bank: true.