Параметры запроса

Mon, 01 Jan 0001 00:00:00 +0000

Параметры запроса#

Детальное описание параметров для запроса /avia/ticket_refund.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`ticketNumber`	string	Номер билета для возврата (может включать префикс vendor)
`forRefund`	Money	Сумма к возврату из расчета возврата

Структура Money#

Параметр	Тип	Обязательно	Описание
`currencyCode`	string	Да	Код валюты (ISO 4217, например: RUB, USD)
`value`	decimal	Да	Сумма к возврату

Пример запроса#

curl

 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}

Обработка ошибок#

При возврате билета могут возникнуть следующие ошибки:

Структура ответа

Mon, 01 Jan 0001 00:00:00 +0000

Структура ответа#

Детальное описание структуры ответа от /avia/ticket_refund.

Успешный ответ#

При успешном оформлении возврата API возвращает HTTP 200 и пустой объект.

1{}

Типичные ошибки#

Код ошибки	Причина	Решение
`TICKET_NOT_FOUND`	Билет не найден	Проверьте номер билета и bookingId
`REFUND_NOT_ALLOWED`	Возврат запрещен тарифом	Проверьте условия тарифа
`TICKET_ALREADY_REFUNDED`	Билет уже возвращен	Операция уже выполнена
`INVALID_REFUND_AMOUNT`	Неверная сумма возврата	Пересчитайте сумму согласно тарифу
`TICKET_USED`	Все сегменты использованы	Возврат невозможен

Связанные операции#

Войдирование билета - отмена без штрафов
Информация о билете - проверка статуса билета
Правила тарифа - просмотр условий возврата

Возврат билета on Travel API - Документация