Возвраты

Магазин может производить возвраты средств по успешно выполненным платежам (в статусе succeeded).

Можно проводить любое число возвратов при условии, что сумма одного возврата больше или равна 1 USD (или соответствующей сумме в UZS) и итоговая сумма платежа за вычетом всех произведенных ранее возвратов превышает 1 USD.

URL: https://secure.octo.uz/refund

Method: POST

Content-type: application/json

Тело запроса:

{
  "octo_shop_id": 10000,
  "shop_refund_id" : "a8s75f6sdaf85",
  "octo_secret": "2d45df74-bb95-47cf-a616-8d6dcee2e10d",
  "octo_payment_UUID": "1145df74-bb95-47cf-a616-8d6dcee2e222",
  "amount": 1.33
}

Валюта возврата совпадает с валютой платежа.

Описание полей ответа Octo:

Поле Обязательно Описание
shop_refund_id да Уникальный ID операции возврата на стороне магазина. Необходим для фильтрации возможных дублирующих вызовов операций возврата.
octo_secret да Персональный секретный ключ магазина, который генерируется в ЛК магазина. Должен содержаться в безопасной недоступной зоне сайта магазина.
amount да Сумма возврата.
octo_payment_UUID да Уникальный идентификатор транзакции в ПС Octo.
supplier_shop_id нет ID магазина (поставщика товара при сплиттинге) по которому надо сделать возврат. Если не указан при сплиттинге - возврат производится только в рамках стоимости услуг маркетплейса.

В ответ сервер отправит JSON вида:

{
  "error": 0,
  "status": "ok",
  "octo_payment_UUID": "1145df74-bb95-47cf-a616-8d6dcee2e222",
  "refund_id": "3335df74-bb95-47cf-a616-8d6dcee2e333",
  "refund_time": "2018-03-30 13:22:33"
}

Описание полей ответа Octo:

Поле Обязательно Описание
error да Код ошибки. Варианты:

0 - нет ошибок
1 - ошибка формата данных
2 - ошибка авторизации
3 - недопустимая сумма возврата
status да Статус возврата:

new - новый
succeeded - успешно
pending - в ожидании
canceled - отменен
unknown - неизвестный
error - ошибка
octo_payment_UUID да Уникальный идентификатор транзакции в ПС Octo.
refund_id нет Уникальный ID операции возврата на стороне магазина.
refund_time нет Время возврата