Получение статуса транзакции
Метод возвращает актуальный статус конкретной транзакции по ее id с использованием API-ключа.
Запрос
GET /api/v1/transactions/{transaction_id}
Заголовок: x-api-key: <api_key>
{transaction_id} — внутренний id транзакции (UUID), передаётся как сегмент пути.
Поля ответа
| Поле | Описание |
|---|---|
| amount | Сумма (минорные единицы) |
| amount_with_fee | Сумма с комиссией (минорные единицы) |
| amount_dest | Сумма зачисления при конвертации (минорные единицы), если применимо |
| currency | Валюта |
| currency_dest | Валюта зачисления при конвертации, если применимо |
| description | Описание транзакции |
| env | Среда (prod / test) |
| error_description | Описание ошибки при rejected |
| finished | Время завершения (ISO) |
| id | Внутренний UUID транзакции |
| route | Использованный маршрут обработки |
| started | Время старта (ISO) |
| status | Текущий статус (см. раздел «Статусы» в Глоссарии; created, charging, charged, refunded, rejected, failed) |
| txid | Внешний идентификатор клиента |
| type | Тип (payment / payout) |
| widget_url | Ссылка на виджет (если применимо) |
| simple_auth_redirect_url | Ссылка для доп. авторизации / 3DS |
Пример
curl --location 'https://app.heth.me/api/v1/transactions/c033ceaa-3726-4479-8be3-c9af8a0b2336' \
--header 'x-api-key: ВАШ_КЛЮЧ'
Рекомендации
- Используйте экспоненциальный backoff при опросе.
- Отсутствие
finishedзначит, что транзакция еще обрабатывается. - Значения
txidделайте идемпотентными.