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