Refund - Возврат средств

Запрос выполняется командой Refund.

Запрос используется для осуществления возврата денежных средств на карту Пользователя, предварительно списанных командой Charge. Результатом обработки запроса является возврат (полный или частичный) списанных денежных средств на карту Пользователя.

Внимание: для успешного возврата необходимо, чтобы на момент исполнения запроса платеж имел статус Charged.

Название Описание Формат Обязательный
key Идентификатор Продавца. Выдается с параметрами тестового/боевого доступа Строка Да
map_order_id Идентификатор платежа в системе theMAP Строка (максимум 50 символов) Да
amount Сумма блокировки в минимальных единицах валюты (копейках) Целое число Да
goods* Список наименований товаров/услуг для отправки в ОФД (54-ФЗ). Общая сумма всех товаров должна соответствовать amount Массив объектов Нет
├─ name Наименование товара/услуги, не более 128 символов Строка В случае передачи goods параметр обязательный
├─ price Сумма блокировки в минимальных единицах валюты (копейках) Строка В случае передачи goods параметр обязательный
├─ tax Ставка НДС. Целое число от 1 до 6. В случае отсутствия в запросе, значение берется из настроек терминала

  1. 1 – ставка НДС 20%
  2. 2 – ставка НДС 10%
  3. 3 – ставка НДС расч. 20/120
  4. 4 – ставка НДС расч. 10/110
  5. 5 – ставка НДС 0%
  6. 6 – НДС не облагается
 Число Нет
├─ payment_subject_type Признак предмета расчета. Целое число от 1 до 13. Параметр не обязательный, в случае отсутствия в запросе, будет передано значение 1 – Товар.

  1. 1 – Товар
  2. 2 – Подакцизный товар
  3. 3 – Работа
  4. 4 – Услуга
  5. 5 – Ставка азартной игры
  6. 6 – Выигрыш азартной игры
  7. 7 – Лотерейный билет
  8. 8 – Выигрыш лотереи
  9. 9 – Предоставление РИД
  10. 10 - Платеж
  11. 11 – Агентское вознаграждение
  12. 12 – Составной предмет расчета
  13. 13 – Иной предмет расчета
    		14.  Число Нет
    ├─ payment_method_type Признак способа расчета. Целое число от 1 до 7. Параметр не обязательный, в случае отсутствия в запросе, будет передано значение 4 – Полный расчет.

    1. 1 – Предоплата 100%
    2. 2 – Частичная предоплата
    3. 3 – Аванс
    4. 4 – Полный расчет
    5. 5 – Частичный расчет и кредит
    6. 6 – Передача в кредит
    7. 7 – Оплата кредита
      		8.  Число Нет
      ├─ supplier Данные поставщика. Опциональное поле в товаре Объект Нет
      ├── name Наименование Строка В случае передачи supplier параметр обязательный
      ├── inn ИНН поставщика Строка В случае передачи supplier параметр обязательный
      ├── phone_numbers Список номеров телефонов Массив Нет
      custom_params_rdy Список дополнительных параметров операции в формате "ключ - значение" Объект формата {"param1":"test", "param2":"test"...} Нет

      * - Пример передачи goods:

      "goods": [{"name": "Mock1","price": "500","tax": 2,"payment_subject_type": 3,"payment_method_type": 4,"supplier": {"name": "ООО Ромашка","inn": "123456789112","phone_numbers": [" 71111111111"]}},{"name": "Mock2","price": "500","tax": 3,"payment_subject_type": 1,"payment_method_type": 6,"supplier": {"name": "test","supplierINN": "123","phoneNubmers": ["1","2"]}},{"name": "Mock3","price": "500","tax": 3,"payment_subject_type": 6,"payment_method_type": 4},{"name": "Mock4","price": "500","tax": 1,"payment_subject_type": 1,"payment_method_type": 4}]

      Если параметр goods не указан в запросе, то:

      • в случае полного возврата в чеке будут указаны позиции из списания по заказу;
      • в случае частичного возврата в фискальном чеке будет указана позиция "Частичный возврат" с параметрами для фискализации по-умолчанию (из настроек терминала).