# «Локальные выплаты на банковские счета в Великобритании» {#pm_bankpayout_uk}

**На уровень выше:**[Банковские платежи](ru_pm_bankpayments.md)

## Обзор {#ru_pm_bankpayout_uk_overview}

статья о работе с платёжным методом «Локальные выплаты на банковские счета в Великобритании», который позволяет проводить платежи в фунтах стерлингов с использованием банковских счетов в Великобритании и для которого в платформе Ecommpay поддерживаются выплаты

### Введение {#section_ql3_5fj_stb .section}

«Локальные выплаты на банковские счета в Великобритании» — метод, позволяющий проводить платежи в фунтах стерлингов с использованием банковских счетов в Великобритании. Для этого метода в платёжной платформе Ecommpay поддерживаются выплаты. Вместе с тем, для проведения оплат при работе с этим методом может использоваться комплементарный метод [Open Banking in the UK](pm_uk.md#).

В этой статье представлена информация о работе с методом «Локальные выплаты на банковские счета в Великобритании»: обзорный раздел с общими сведениями и последующие разделы с информацией о действиях, необходимых со стороны мерчанта для решения разных задач.

### Характеристика {#section_tbf_2zk_ggb .section}

|Тип платёжного метода|банковские платежи|
|Платёжные инструменты|банковские счета|
|Регионы использования|[GB](references/ru/countries/GB.md)|
|Валюты платежей|[GBP](references/ru/currencies/GBP.md)|
|Конвертация валют|–|
|Разовые оплаты|–|
|Повторяемые оплаты|–|
|Полные возвраты|–|
|Частичные возвраты|–|
|Выплаты|+|
|Опротестования|–|
|Особенности|для проведения оплат можно использовать комплементарный метод [Open Banking in the UK](pm_uk.md#).|
|Организация и стоимость подключения|по согласованию с курирующим менеджером Ecommpay|

### Схема работы {#section_tsp_gzk_ggb .section}

В проведении отдельного платежа с использованием метода «Локальные выплаты на банковские счета в Великобритании» задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа Ecommpay, а также технические средства сервиса провайдера.

![](images/pm/ru_bankpayout_uk_functional.svg)

### Основные операции {#section_rnx_4cl_ggb .section}

Для проведения платежей и выполнения операций с использованием метода «Локальные выплаты на банковские счета в Великобритании» могут применяться различные интерфейсы платёжной платформы. Так, выплаты могут проводиться через Gate и Dashboard. При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения.

||Суммы, [GBP](references/ru/currencies/GBP.md)¹|Время²|
|минимум|максимум|базовое|предельное|
|--|----------------------------------------------|------|
|-------|--------|-------|----------|
|Выплаты|\*|\*|\*|\*|

**Прим.:**

1.  Ограничения сумм и время проведения платежей зависят от банков.
2.  Базовое и предельное время определяются следующим образом:
    -   Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время определяется для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя. Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа \([подробнее](ru_Gate_payment_status_request.md#)\).
    -   Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус `decline`. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки Ecommpay.

### Сценарии использования {#section_fgt_sdl_ggb .section}

Проведение выплат с использованием метода «Локальные выплаты на банковские счета в Великобритании» осуществляется с уведомлением пользователей через веб-сервис мерчанта.

![](images/pm/ru_bankpayout_uk_interfaces_gate_payout.svg "Выплата через Gate")

## Выплаты через Gate {#ru_pm_bankpayout_uk_gate_payout}

### Общая информация {#section_lsx_3jl_ggb .section}

Для проведения выплаты через Gate с использованием метода «Локальные выплаты на банковские счета в Великобритании» со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay и принять оповещение о результате.Полная схема проведения выплаты выглядит следующим образом.

![](images/pm/ru_bankpayout_uk_uml_gate_payout.svg)

1.  Пользователь на стороне веб-сервиса инициирует выплату через «Локальные выплаты на банковские счета в Великобритании».
2.  От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение выплаты через Gate.
3.  Запрос на проведение выплаты поступает в платёжную платформу.
4.  В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи.
5.  От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности. Подробнее — в разделе [Формат ответа](ru_gate_interaction_organisation.md#).
6.  В платёжной платформе обеспечиваются дальнейшая обработка запроса \(с проверкой согласованности параметров\) и его отправка в сервис провайдера.
7.  В сервисе провайдера выполняется обработка выплаты.
8.  От сервиса провайдера к платёжной платформе направляется информация о результате выплаты.
9.  От платёжной платформы к веб-сервису направляется оповещение о результате выплаты.
10. На стороне веб-сервиса обеспечивается информирование пользователя о результате выплаты.

Информация о форматах запросов и оповещений, используемых для проведения выплат методом «Локальные выплаты на банковские счета в Великобритании» через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье [Организация взаимодействия](ru_gate_interaction_organisation.md#).

### Формат запросов {#section_osx_3jl_ggb .section}

При работе с запросами на выплаты с применением метода «Локальные выплаты на банковские счета в Великобритании» необходимо учитывать следующее:

1.  Для инициирования каждой выплаты должен использоваться отдельный POST-запрос к конечной точке `/v2/payment/bank-transfer/uk/payout`. Эта точка относится к группе [/v2/payment/bank-transfer/\{payment\_method\}/payout](https://api-developers.ecommpay.com/api-specification/bank-transfer/post-v2-payment-bank-transfer-payment-method-payout).
2.  В каждом запросе должны использоваться следующие объекты и параметры:
    -   `general` — объект, содержащий основные идентификационные сведения запроса:
        -   `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции;
        -   `payment_id` — идентификатор платежа, уникальный в рамках проекта;
        -   `signature` — подпись запроса, составленная после указания всех целевых параметров \(подробнее — в разделе [Работа с подписью к данным](ru_platform_signature.md#)\);
    -   `payment` — объект, содержащий сведения о платеже:
        -   `amount` — сумма выплаты в дробных единицах валюты;
        -   `currency` — код валюты платежав формате ISO-4217 alpha-3;
        -   `description` — описание платежа;
    -   `customer` — объект, содержащий сведения о получателе:
        -   `id` — идентификатор получателя, уникальный в рамках проекта;
        -   `ip_address` — IP-адрес получателя, актуальный для инициируемой выплаты;
        -   `first_name` — полное имя или название получателя;
    -   `account` — объект, содержащий сведения о счёте получателя:
        -   `bank_code` — SORT-код банка получателя;
        -   `number` — номер счёта получателя в локальном формате.
3.  Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.

Таким образом, корректный запрос на выплату с применением метода «Локальные выплаты на банковские счета в Великобритании» должен содержать идентификатор проекта, базовые сведения о платеже \(его идентификатор, сумму и код валюты\), описание платежа, информацию о получателе, номер счёта, SORT-код банка, а также подпись.

```language-json
 {
  "general": {
    "project_id": 3027,
    "payment_id": "payout1",
    "signature": "M1vT4q9c8hA8xCjEwH6bgBOp8DTf8d/XdoV+vd7Q=="
  },
   "customer": {
     "id": "customer1",
     "ip_address": "192.0.2.0",
     "first_name": "John Doe"
  },
   "account": {
     "bank_code": "123",
     "number": "1020304010"
  },
   "payment": {
     "amount": 10000,
     "currency": "GBP",
     "description": "test payout"
  }
}
```

```language-json
 {
  "general": {
    "project_id": 3027,
    "payment_id": "payout1",
    "signature": "M1vT4q9c8hA8xCjEwH6bgBOp8DTf8d/XdoV+vd7Q=="
  },
   "customer": {
     "id": "customer1",
     "ip_address": "192.0.2.0",
     "first_name": "John Doe"
  },
   "account": {
     "bank_code": "123",
     "number": "1020304010"
  },
   "payment": {
     "amount": 10000,
     "currency": "GBP",
     "description": "test payout"
  }
}
```

### Формат оповещений {#section_wsx_3jl_ggb .section}

Для оповещений о результатах выплат с применением метода «Локальные выплаты на банковские счета в Великобритании» используется типовой формат, описание которого представлено в разделе [Работа с оповещениями](ru_platform_callbacks.md#).

В следующем примере оповещение свидетельствует о том, что в рамках проекта `4991` была проведена выплата в размере `305,00 GBP`.

```language-json
 {
        "project_id": 4991,
        "payment": {
            "id": "85777022",
            "type": "payout",
            "status": "success",
            "date": "2021-02-22T13:47:30+0000",
            "method": "bank-transfer-uk",
            "sum": {
                "amount": 30500,
                "currency": "GBP"
            },
            "description": "test payout"
        },
        "account": {
            "number": "5345765"
        },
        "customer": {
            "id": "customer1"
        },
        "operation": {
            "id": 4205000000072,
            "type": "payout",
            "status": "success",
            "date": "2021-02-22T13:47:30+0000",
            "created_date": "2021-02-22T13:47:09+0000",
            "request_id": "d61112fb05c3c558a5b77dde36fa41b649d-00004206",
            "sum_initial": {
                "amount": 30500,
                "currency": "GBP"
            },
            "sum_converted": {
                "amount": 30500,
                "currency": "GBP"
            },
            "code": "0",
            "message": "Success",
            "provider": {
                "id": 2944,
                "payment_id": "j29UpFMgQ0",
                "auth_code": ""
            }
        },
        "signature": "EaiGnnSGbZ20U0wmq1x1v/UiIDbzAAxECZegwQqZlYUA=="
    }
```

В следующем примере оповещение свидетельствует об отклонённой выплате.

```language-json
 {
        "project_id": 4991,
        "payment": {
            "id": "31596106",
            "type": "payout",
            "status": "decline",
            "date": "2021-02-22T13:57:40+0000",
            "method": "bank-transfer-uk",
            "sum": {
                "amount": 23400,
                "currency": "GBP"
            },
            "description": "test payout"
        },
        "account": {
            "number": "312312543"
        },
        "customer": {
            "id": "customer2"
        },
        "operation": {
            "id": 7033000000070,
            "type": "payout",
            "status": "decline",
            "date": "2021-02-22T13:57:40+0000",
            "created_date": "2021-02-22T13:57:37+0000",
            "request_id": "c84225facb18f7218f76b053af8b717f946-00007034",
            "sum_initial": {
                "amount": 23400,
                "currency": "GBP"
            },
            "sum_converted": {
                "amount": 23400,
                "currency": "GBP"
            },
            "code": "20000",
            "message": "General decline",
            "provider": {
                "id": 2944,
                "payment_id": "j29ih8EBLQ",
                "auth_code": ""
            }
        },
        "signature": "9PcGBHYLfgObqD1cUHXN/iGInDB0KVS2RFVyht5k5wIei75g=="
    }
```

### Дополнительные материалы {#section_xsx_3jl_ggb .section}

Для организации работы с выплатами через Gate также могут быть полезны следующие материалы:

-   [Организация взаимодействия](ru_gate_interaction_organisation.md#)— о том, как взаимодействовать с платёжной платформой через Gate.
-   [Работа с подписью к данным](ru_platform_signature.md#)— о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
-   [Проведение платежей](ru_platform_payment_model.md)— о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
-   [Выплаты](ru_Gate_payout.md)— о том, как проводить выплаты через Gate.
-   [Работа с информацией об операциях](ru_platform_payment_info_codes.md)— о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.

## Выплаты через Dashboard {#ru_pm_dash_payout}

При использовании интерфейса Dashboard можно проводить *одиночные* и *массовые*выплатыметодом «Локальные выплаты на банковские счета в Великобритании» с единичной и пакетной отправкой запросов, называемые соответственно *одиночными* и *массовыми*.

-   Для проведения одиночной выплаты необходимо открыть форму выплаты, задать все необходимые параметры \(включая метод\), отправить запрос и убедиться в проведении выплаты.
-   Для проведения массовой выплаты необходимо подготовить и загрузить файл с информацией обо всех целевых выплатах, отправить пакет запросов и убедиться в проведении выплат.

    При этомдолжен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе [Сведения о массовых платежах](ru_dbl_payments.md#), а параметры выплат— требованиям, представленным в разделе [Выплаты через Gate](pm_bankpayout_uk.md#) этой статьи \(за исключением пункта о подписи\).


Более подробная информация о проведении выплат через Dashboard представлена в [отдельной статье](ru_dbl_payments.md#).

## Анализ результатов проведения платежей {#ru_pm_bankpayout_uk_dash_analysis}

Для анализа информации о платежах и операциях, как в отдельности по методу «Локальные выплаты на банковские счета в Великобритании», так и в совокупности с другими методами, можно использовать:

-   инструментарийинтерфейса Dashboard, с различными реестрами и аналитическими панелями;
-   отчёты в формате CSV, выгружаемые\(как разово, так и периодически\) черезраздел **Отчёты** интерфейса Dashboard;
-   данные в формате JSON, получаемыепо программным запросам черезинтерфейс Data API.

С вопросами по анализу информации можно обращаться к разделам документации \([Dashboard](ru_dbl_about.md) и [Использование Data API](ru_dbl_api_protocol.md)\) и специалистам Ecommpay.