# «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» {#pm_bankpayout_sepa} **На уровень выше:**[Банковские платежи](ru_pm_bankpayments.md) ## Обзор {#ru_pm_bankpayout_sepa_overview} статья о работе с платёжным методом «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)», который позволяет проводить платежи в евро с использованием банковских счетов в странах ЕЗПЕ и для которого в платформе Ecommpay поддерживаются выплаты ### Введение {#section_ql3_5fj_stb .section} «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» — метод, позволяющий проводить платежи в евро с использованием банковских счетов в странах единой зоны платежей в евро \(ЕЗПЕ; SEPA\). Для этого метода в платёжной платформе Ecommpay поддерживаются выплаты. Вместе с тем, для проведения оплат при работе с этим методом могут использоваться комплементарные методы группы Open Banking. В этой статье представлена информация о работе с методом «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)»: обзорный раздел с общими сведениями и последующие разделы с информацией о действиях, необходимых со стороны мерчанта для решения разных задач. ### Характеристика {#section_tbf_2zk_ggb .section} |Тип платёжного метода|банковские платежи| |Платёжные инструменты|банковские счета| |Регионы использования|[AD](references/ru/countries/AD.md), [AT](references/ru/countries/AT.md), [BE](references/ru/countries/BE.md), [BG](references/ru/countries/BG.md), [HR](references/ru/countries/HR.md), [CY](references/ru/countries/CY.md), [CZ](references/ru/countries/CZ.md), [DK](references/ru/countries/DK.md), [EE](references/ru/countries/EE.md), [FI](references/ru/countries/FI.md), [FR](references/ru/countries/FR.md), [DE](references/ru/countries/DE.md), [GR](references/ru/countries/GR.md), [HU](references/ru/countries/HU.md), [IS](references/ru/countries/IS.md), [IE](references/ru/countries/IE.md), [IT](references/ru/countries/IT.md), [LV](references/ru/countries/LV.md), [LI](references/ru/countries/LI.md), [LT](references/ru/countries/LT.md), [LU](references/ru/countries/LU.md), [MT](references/ru/countries/MT.md), [MC](references/ru/countries/MC.md), [NL](references/ru/countries/NL.md), [NO](references/ru/countries/NO.md), [PL](references/ru/countries/PL.md), [PT](references/ru/countries/PT.md), [RO](references/ru/countries/RO.md), [SM](references/ru/countries/SM.md), [SK](references/ru/countries/SK.md), [SI](references/ru/countries/SI.md), [ES](references/ru/countries/ES.md), [SE](references/ru/countries/SE.md), [CH](references/ru/countries/CH.md), [GB](references/ru/countries/GB.md), [VA](references/ru/countries/VA.md)| |Валюты платежей|[EUR](references/ru/currencies/EUR.md)| |Конвертация валют|–| |Разовые оплаты|–| |Повторяемые оплаты|–| |Полные возвраты|–| |Частичные возвраты|–| |Выплаты|+| |Опротестования|–| |Особенности|- этот метод может использоваться как во всех, так и в отдельно взятых странах ЕЗПЕ; конкретный регион покрытия согласовывается с курирующим менеджером Ecommpay - для работы с этим методом необходимо применение процедуры [Verification of Payee](ru_verification_of_payee.md#) - для проведения оплат при работе с этим методом можно использовать комплементарные методы группы [Open Banking](pm_openbanking.md#) | |Организация и стоимость подключения|по согласованию с курирующим менеджером Ecommpay| ### Схема работы {#section_tsp_gzk_ggb .section} В проведении отдельного платежа с использованием метода «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа Ecommpay, а также технические средства сервиса провайдера. ![](images/pm/ru_bankpayout_sepa_functional.svg) ### Основные операции {#section_rnx_4cl_ggb .section} Для проведения платежей и выполнения операций с использованием метода «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» могут применяться различные интерфейсы платёжной платформы. Так, выплаты могут проводиться через Gate и Dashboard. При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения. ||Суммы, [EUR](references/ru/currencies/EUR.md)¹|Время²| |минимум|максимум|базовое|предельное| |--|----------------------------------------------|------| |-------|--------|-------|----------| |Выплаты|\*|\*|\*|\*| **Прим.:** 1. Ограничения сумм и время проведения платежей зависят от банков. 2. Базовое и предельное время определяются следующим образом: - Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время определяется для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя. Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа \([подробнее](ru_Gate_payment_status_request.md#)\). - Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус `decline`. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки Ecommpay. ### Сценарии использования {#section_fgt_sdl_ggb .section} Проведение выплат с использованием метода «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» осуществляется с уведомлением пользователей через веб-сервис мерчанта. ![](images/pm/ru_bankpayout_sepa_interfaces_gate_payout.svg "Выплата через Gate") ## Выплаты через Gate {#ru_pm_bankpayout_sepa_gate_payout} ### Общая информация {#section_lsx_3jl_ggb .section} Для проведения выплаты через Gate с использованием метода «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay и принять оповещение о результате.Полная схема проведения выплаты выглядит следующим образом. ![](images/pm/ru_bankpayout_sepa_uml_gate_payout.svg) 1. Пользователь на стороне веб-сервиса инициирует выплату через «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)». 2. От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение выплаты через Gate. 3. Запрос на проведение выплаты поступает в платёжную платформу. 4. В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи. 5. От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности. Подробнее — в разделе [Формат ответа](ru_gate_interaction_organisation.md#). 6. В платёжной платформе обеспечиваются дальнейшая обработка запроса \(с проверкой согласованности параметров\) и его отправка в сервис провайдера. 7. В сервисе провайдера выполняется обработка выплаты. 8. От сервиса провайдера к платёжной платформе направляется информация о результате выплаты. 9. От платёжной платформы к веб-сервису направляется оповещение о результате выплаты. 10. На стороне веб-сервиса обеспечивается информирование пользователя о результате выплаты. Информация о форматах запросов и оповещений, используемых для проведения выплат методом «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье [Организация взаимодействия](ru_gate_interaction_organisation.md#). ### Формат запросов {#section_osx_3jl_ggb .section} При работе с запросами на выплаты с применением метода «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» необходимо учитывать следующее: 1. Для инициирования каждой выплаты должен использоваться отдельный POST-запрос к конечной точке `/v2/payment/bank-transfer/world/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` — объект, содержащий сведения о счёте получателя: - `number` — номер счёта получателя \(IBAN\). 3. При обработке результатов проверки Verificarion of Payee на стороне веб-сервиса\([подробнее](ru_verification_of_payee.md#)\) необходимо указывать идентификатор действительной проверки в параметре `id` объекта `vop`. 4. Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации. Таким образом, корректный запрос на выплату с применением метода «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» должен содержать идентификатор проекта, базовые сведения о платеже \(его идентификатор, сумму и код валюты\), идентификатор, IP-адрес имя или название получателя, описание платежа, идентификатор проверки Verification of Payee \(при необходимости\), номер счёта и подпись. ```language-json { "general": { "project_id": 3027, "payment_id": "payout1", "signature": "M1vT4q9XAaq7/Jkn+aJmGA4jH6bgBOp8DTf8d/XdoV+vd7Q==" }, "customer": { "id": "customer1", "ip_address": "192.0.2.0", "first_name": "John Doe" }, "account": { "number": "FI1410093000123458" }, "payment": { "amount": 10000, "currency": "EUR", "description": "test payout" }, "vop": { "id": 12345 } ``` ``` {#codeblock_ekl_lhg_53c .language-json} { "general": { "project_id": 3027, "payment_id": "payout1", "signature": "M1vT4q9XAaq7/Jkn+aJmGA4jH6bgBOp8DTf8d/XdoV+vd7Q==" }, "customer": { "id": "customer1", "ip_address": "192.0.2.0", "first_name": "John Doe" }, "account": { "number": "FI1410093000123458" }, "payment": { "amount": 10000, "currency": "EUR", "description": "test payout" }, "vop": { "id": 12345 } ``` ### Формат оповещений {#section_wsx_3jl_ggb .section} Для оповещений о результатах выплат с применением метода «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» используется типовой формат, описание которого представлено в разделе [Работа с оповещениями](ru_platform_callbacks.md#). В следующем примере оповещение свидетельствует о том, что в рамках проекта `4990` была проведена выплата в размере `211,00 EUR`. ```language-json { "project_id": 4990, "payment": { "id": "53923_33600681", "type": "payout", "status": "success", "date": "2021-02-22T13:39:45+0000", "method": "world", "sum": { "amount": 21100, "currency": "EUR" }, "description": "test description" }, "account": { "number": "123456" }, "customer": { "id": "customer1" }, "operation": { "id": 6325000000075, "type": "payout", "status": "success", "date": "2021-02-22T13:39:45+0000", "created_date": "2021-02-22T13:39:23+0000", "request_id": "9a9c4985044f5927dae77daac4b8e488b2-00006326", "sum_initial": { "amount": 21100, "currency": "EUR" }, "sum_converted": { "amount": 21100, "currency": "EUR" }, "code": "0", "message": "Success", "provider": { "id": 2945, "payment_id": "j29vEXRSAd", "auth_code": "" } }, "signature": "7bxR3Ssoemv3o5mpabmg529+/NkpdYPLMN1sBw==" } ``` В следующем примере оповещение свидетельствует об отклонённой выплате. ```language-json { "project_id": 4990, "payment": { "id": "21571027", "type": "payout", "status": "decline", "date": "2021-02-22T13:30:44+0000", "method": "world", "sum": { "amount": 30400, "currency": "EUR" }, "description": "test description" }, "account": { "number": "1234567" }, "customer": { "id": "customer2" }, "operation": { "id": 9698000000069, "type": "payout", "status": "decline", "date": "2021-02-22T13:30:44+0000", "created_date": "2021-02-22T13:30:23+0000", "request_id": "3c6027f04491e63df2d67f755e3b45f64-00009699", "sum_initial": { "amount": 30400, "currency": "EUR" }, "sum_converted": { "amount": 30400, "currency": "EUR" }, "code": "20000", "message": "General decline", "provider": { "id": 2945, "payment_id": "j29KmZH29J", "auth_code": "" } }, "signature": "KTCGrXiG/cQzANBw2s730kE6toB+EDa619tqB9qQeg==" } ``` ### Дополнительные материалы {#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 можно проводить *одиночные* и *массовые*выплатыметодом «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)» с единичной и пакетной отправкой запросов, называемые соответственно *одиночными* и *массовыми*. - Для проведения одиночной выплаты необходимо открыть форму выплаты, задать все необходимые параметры \(включая метод\), отправить запрос и убедиться в проведении выплаты. - Для проведения массовой выплаты необходимо подготовить и загрузить файл с информацией обо всех целевых выплатах, отправить пакет запросов и убедиться в проведении выплат. При этомдолжен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе [Сведения о массовых платежах](ru_dbl_payments.md#), а параметры выплат— требованиям, представленным в разделе [Выплаты через Gate](pm_bankpayout_sepa.md#) этой статьи \(за исключением пункта о подписи\). Более подробная информация о проведении выплат через Dashboard представлена в [отдельной статье](ru_dbl_payments.md#). ## Анализ результатов проведения платежей {#ru_pm_bankpayout_sepa_dash_analysis} Для анализа информации о платежах и операциях, как в отдельности по методу «Выплаты на банковские счета в ЕЗПЕ \(SEPA\)», так и в совокупности с другими методами, можно использовать: - инструментарийинтерфейса Dashboard, с различными реестрами и аналитическими панелями; - отчёты в формате CSV, выгружаемые\(как разово, так и периодически\) черезраздел **Отчёты** интерфейса Dashboard; - данные в формате JSON, получаемыепо программным запросам черезинтерфейс Data API. С вопросами по анализу информации можно обращаться к разделам документации \([Dashboard](ru_dbl_about.md) и [Использование Data API](ru_dbl_api_protocol.md)\) и специалистам Ecommpay.