Приём платежей

Статус платежа

Запросите актуальное состояние транзакции по её идентификатору Cashera

GET/integration/transactions/{uuid}

Возвращает текущий объект транзакции, включая её status. Для общей платёжной формы до выбора метода возвращается checkout-сессия, а после выбора - созданная из неё транзакция с тем же UUID.

Параметры пути

ПолеТипОписание
uuidобязательноеstringИдентификатор транзакции, полученный при создании

Пример

200 OK
curl https://api.cashera.cash/api/v1/integration/transactions/9b1f2c4e-7a01-4b9d-8f1c-2eab57d90c11 \
-H "X-Api-Key: $CASHERA_API_KEY"
Вебхуки вместо опроса

Для отслеживания оплаты предпочитайте вебхуки - они приходят сразу при смене статуса. Запрос статуса используйте для сверки или если вебхук не дошёл.

Ошибки

ПолеТипОписание
401UnauthorizedНеверный X-Api-Key
403ForbiddenМерчант отключён или удалён, либо запрос пришёл с IP вне разрешённого списка (IP-allowlist). Ключ при этом может быть валидным
404Not FoundТранзакция с таким uuid не найдена
429Too Many RequestsПревышен лимит запросов. При опросе статуса делайте паузу между попытками или используйте вебхуки