Параметры запроса#
Детальное описание параметров для запроса /avia/ticket_refund.
Обязательные параметры#
| Параметр | Тип | Описание |
|---|---|---|
bookingId | guid | Идентификатор бронирования (формат UUID) |
ticketNumber | string | Номер билета для возврата (может включать префикс vendor) |
forRefund | Money | Сумма к возврату из расчета возврата |
Структура Money#
| Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
currencyCode | string | Да | Код валюты (ISO 4217, например: RUB, USD) |
value | decimal | Да | Сумма к возврату |
Пример запроса#
1curl -X POST https://test.travel-api.ru/avia/ticket_refund \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "bookingId": "019a0ce6-2633-787f-a6bc-5dbddc02cc1f",
6 "ticketNumber": "425-6170037294",
7 "forRefund": {
8 "currencyCode": "RUB",
9 "value": 5499
10 }
11 }' 1var request = new
2{
3 bookingId = "019a0ce6-2633-787f-a6bc-5dbddc02cc1f",
4 ticketNumber = "425-6170037294",
5 forRefund = new
6 {
7 currencyCode = "RUB",
8 value = 5499
9 }
10};
11
12var response = await httpClient.PostAsJsonAsync(
13 "https://test.travel-api.ru/avia/ticket_refund",
14 request
15);
16
17if (response.IsSuccessStatusCode)
18{
19 var content = await response.Content.ReadAsStringAsync();
20
21 // Пустой ответ {} означает успех
22 if (content.Trim() == "{}")
23 {
24 Console.WriteLine("Возврат билета успешно оформлен");
25 }
26}Обработка ошибок#
При возврате билета могут возникнуть следующие ошибки:
| Код ошибки | Причина | Решение |
|---|---|---|
TICKET_NOT_FOUND | Билет не найден | Проверьте bookingId и ticketNumber |
REFUND_NOT_ALLOWED | Возврат запрещен тарифом | Возврат невозможен по правилам тарифа |
TICKET_ALREADY_REFUNDED | Билет уже возвращен | Операция уже выполнена ранее |
INVALID_REFUND_AMOUNT | Неверная сумма возврата | Выполните новый расчет возврата |
TICKET_USED | Все сегменты использованы | Возврат невозможен |
Связанные операции#
- Расчёт возврата - предварительный расчет суммы возврата
- Войдирование билета - отмена без штрафов
- Информация о билете - проверка статуса билета