Возвраты
Мерчант может производить возвраты средств по успешно выполненным платежам (в статусе succeeded).
Можно проводить любое число возвратов при условии, что сумма одного возврата больше или равна 1 USD (или соответствующей сумме в UZS) и итоговая сумма платежа за вычетом всех произведенных ранее возвратов превышает 1 USD.
Формат запроса:
URL: https://secure.eight.uz/refund
Метод: POST
Content-type: application/json
Тело запроса:
{
"merchant_shop_id": 1,
"merchant_secret": "29586cd6-b18d-4262-8ec5-26eb13b941c3",
"payment_UUID": "82e74a8e-df8c-49cd-8635-e1a8d933c5a7",
"shop_refund_id": "shdauhd22jddi90",
"amount": 5.77
}
Валюта возврата совпадает с валютой платежа.
Описание полей запроса:
Поле | Обязательное | Описание
:--------------- | :----------: | ---------------------------------------:
merchant_shop_id | Да | Уникальный ID мерчанта (доступен в ЛК мерчанта)
merchant_secret | Да | Персональный секретный ключ мерчанта, который генерируется в ЛК мерчанта.
Должен содержаться в безопасной недоступной зоне сайта мерчанта.
payment_UUID | Да | Уникальный идентификатор транзакции в ПС Eight.
amount | Да | Сумма возврата.
shop_refund_id | Да | Уникальный ID операции возврата на стороне мерчанта.
Необходим для фильтрации возможных дублирующих вызовов операций возврата.В ответ на запрос мерчанта ПС Eight отвечает следующим JSON в теле ответа:
{
"error": 0,
"status": "succeeded",
"refund_id": "shdauhd22jddi90",
"payment_UUID": "82e74a8e-df8c-49cd-8635-e1a8d933c5a7",
"refund_time": "2024-01-05 13:22:33"
}
Описание полей ответа Eight:
Поле | Обязательное | Описание
:----------------- | :---------------:| ---------------------------------:
status | Да | Статус возврата:
new - новый
succeeded - успешно
pending - в ожидании
canceled - отменен
unknown - неизвестный
error - ошибка
payment_UUID | Да | Уникальный идентификатор транзакции в ПС Eight.
refund_id | Нет | Уникальный идентификатор операции возврата на стороне мерчанта.
rrn | Нет | RRN операции от банка.
refund_time | Нет | Время возврата
error | Да | Код ошибки. Варианты:
0 - нет ошибок
1 - ошибка формата данных
2 - ошибка авторизации
3 - недопустимая сумма возврата