Техническая документация РФИ БАНК
Page tree
Skip to end of metadata
Go to start of metadata

В некоторых случаях требуется вернуть денежные средства плательщику, в таких случаях необходимо использовать функционал возврата платежей.
ВНИМАНИЕ: данный функционал активируется для выбранного сервиса и канала оплаты по отдельному согласованию. Возврат платежа может быть недоступен для определенного вида каналов оплаты.

Возврат платежа в личном кабинете

Для проведения возврата платежа необходимо найти транзакцию в разделе статистика и перейти по ссылке “Запросить возврат”:

Вы будете автоматически переадресованы на страницу управления возвратами. При необходимости можно откорректировать* сумму возврата и создать операцию. В случае если канал оплаты поддерживает возврат, появится новая запись в таблице с указанием статуса операции. Если канал оплаты не поддерживает возврат, будет выведено сообщение “Канал оплаты не поддерживает возвраты”


*ВНИМАНИЕ: Операция возврата, необратима. В случае если вы ошиблись с суммой возврата обратитесь в техническую поддержку банка.

ВАЖНО: для проведения нескольких возвратов обязательно указать ID возврата, если  данный ID не будет указан, об будет присвоен системой автоматически. Данный функционал работает только для возвратов по Visa/MasterCard/МИР


Возврат платежа (асинхронная операция)

Для создания заявки через API необходимо выполнить POST запрос на адрес https://partner.rficb.ru/alba/refund/

В запросе необходимо передать (версия протокола 2.0) (Content-Type обязательно должен быть “application/x-www-form-urlencoded”):

  • version – “2.0”
  • tid – id транзакции
  • amount – опциональный параметр, сумма указывается в формате xxx.xx
  • reason – опциональный параметр – причина возврата
  • refund_ext_id - id возврата (при проведении нескольких возвратов в рамках одной транзакции)
  • check – Электронная подпись запроса. См. приложение №1
 Другой способ авториазции (устаревшее)
  • tid – id транзакции
  • api_key – ключ авторизации (https://home.rficb.ru/apikeys/)
  • amount – опциональный параметр, должен быть меньше или равен сумме исходной транзакции
  • reason – опциональный параметр – причина возврата
  • refund_ext_id - id возврата (при проведении нескольких возвратов в рамках одной транзакции)

Ответ c ошибкой: {‘status’: ‘error’, ‘message’: ”}

Положительный ответ: {‘status’: ‘success’, ‘payback_id’: }

SDK пример:

  • php


1
2
3
4
5
6
7
8
    $service = new AlbaService(SERVICE_ID, 'SERVICE_SECRET');
 
    try {
        $result = $service->refund(TRANSACTION_ID);
        echo "Возврат поставлен в очередь, payback_id: " . $result->payback_id;
    } catch (AlbaException $e) {
        echo "Произошла ошибка:" . $e->getMessage();
    }


  • python
1
2
3
4
5
6
7
8
    from alba_client import AlbaService, AlbaException
 
    service = AlbaService(SERVICE_ID, 'SERVICE_SECRET')
    try:
        result = service.refund(TRANSACTION_ID)
        print("Возврат поставлен в очередь, payback_id: {}".format(result['payback_id']))
    except AlbaException, e:
        print("Произошла ошибка: {}".format(e))



  • java
1
2
3
4
5
6
7
8
  AlbaService = new AlbaService(SERVICE_ID, "SERVICE_SECRET");
 
    RefundResponse refundResponse = service.refund(
            RefundRequest.builder(response.getTransactionId())
                    .setAmount(new BigDecimal("REFUND_AMOUNT"))
                    .setReason("REFUND_REASON")
                    .build()
    );


  • No labels