# Bizum {#pm_bizum} статья о работе с платёжным методом Bizum, который позволяет проводить платежи в евро с использованием банковских счетов в Испании и для которого в платформе Ecommpay поддерживаются оплаты и возвраты **На уровень выше:**[Банковские платежи](ru_pm_bankpayments.md) ## Обзор {#ru_pm_bizum_overview} ### Введение {#section_ql3_5fj_stb .section} Bizum — метод, позволяющий проводить платежи в евро с использованием банковских счетов в Испании. Для этого метода в платёжной платформе Ecommpay поддерживаются оплаты и возвраты. Bizum является одним из наиболее популярных локальных платёжных методов в Испании. Он широко известен среди испанских пользователей, которые активно используют его для безналичных оплат и ценят за удобство и надёжность. В этой статье представлена информация о работе с методом Bizum: обзорный раздел с общими сведениями и последующие разделы с информацией о действиях, необходимых со стороны мерчанта для решения разных задач. ### Характеристика {#section_tbf_2zk_ggb .section} |Тип платёжного метода|банковские платежи| |Платёжные инструменты|банковские счета| |Регионы использования|[ES](references/ru/countries/ES.md)| |Валюты платежей|[EUR](references/ru/currencies/EUR.md)| |Конвертация валют|на стороне Ecommpay| |Разовые оплаты|+| |Повторяемые оплаты|–| |Полные возвраты|+| |Частичные возвраты|+| |Выплаты|–| |Опротестования|–| |Особенности|инициирование частичных возвратов допускаются только спустя 24 часа после проведения оплаты| |Организация и стоимость подключения|по согласованию с курирующим менеджером Ecommpay| ### Схема работы {#section_tsp_gzk_ggb .section} В проведении отдельного платежа с использованием метода Bizum задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа Ecommpay, а также технические средства сервиса Bizum. ![](images/pm/ru_bizum_functional_1.svg) ### Основные операции {#section_rnx_4cl_ggb .section} Для проведения платежей и выполнения операций с использованием метода Bizum могут применяться различные интерфейсы платёжной платформы. Так, оплаты могут проводиться через Payment Page, Gate и Dashboard \(с применением платёжных ссылок\), возвраты — через Gate и Dashboard. При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения. ||Суммы, EUR¹|Время²| |минимум|максимум|базовое|предельное| |--|-----------|------| |-------|--------|-------|----------| |Оплаты|0,05|1 000,00|2 минуты|4 минуты| |Возвраты|–|–|–|–| **Прим.:** 1. Существуют дневные и месячные максимальные ограничения для пользователя на совокупные суммы оплат: - 2 000 EUR в день. - 5 000 EUR в месяц. 2. Базовое и предельное время определяются следующим образом: - Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время определяется для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя. Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа \([подробнее](ru_Gate_payment_status_request.md)\). - Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус `decline`. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки Ecommpay. ### Сценарии использования {#section_fgt_sdl_ggb .section} Проведение оплат с использованием метода Bizum осуществляется с отображением пользователям платёжной инструкции, выполнение возвратов — с заявкой со стороны пользователя и уведомлением со стороны веб-сервиса. ![](images/pm/ru_bizum_interfaces_pp_1.svg "Оплата через Payment Page") ![](images/pm/ru_bizum_interfaces_gate_1.svg "Оплата через Gate") ![](images/pm/ru_bizum_interfaces_gate_refund.svg "Возврат через Gate") Сценарии выполнения операций через основные интерфейсы платёжной платформы соответствуют представленным на схемах.При использовании дополнительных возможностей \(таких как платёжные ссылки\) сценарии выполнения операций методом Bizum соответствуют специфике этих возможностей. ## Оплаты через Payment Page {#ru_pm_bizum_pp_purchase} ### Общая информация {#section_gtg_vxk_m2b .section} Для проведения оплаты через Payment Pageс использованием метода Bizum со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay и принять оповещение о результате.Полная схема проведения оплаты выглядит следующим образом. ![](images/pm/ru_bizum_uml_pp_1.svg) 1. Пользователь на стороне веб-сервиса инициирует оплату. 2. От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение оплаты через Payment Page. 3. Запрос на проведение оплаты поступает в платёжную платформу. 4. В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи. 5. Осуществляется подготовка Payment Page согласно параметрам проекта и вызова. 6. Пользователю отображается платёжная форма. 7. Пользователь выбирает для оплаты метод Bizum. 8. В платёжную платформу передаётся запрос на проведение оплаты с использованием метода Bizum. 9. В платёжной платформе выполняются обработка полученного запроса и его отправка в сервис Bizum. 10. В сервисе Bizum выполняются обработка полученного запроса и его отправка в сервис банка. 11. В сервисе банка выполняется обработка запроса на оплату. 12. От сервиса банка к сервису Bizum отправляется уведомление о необходимости выполнения подтверждающих действий. 13. От сервиса Bizum к платёжной платформе отправляется уведомление о необходимости выполнения подтверждающих действий со стороны пользователя. 14. Данные для отображения платёжной инструкции пользователю передаются к Payment Page. 15. Пользователю отображается платёжная инструкция. 16. От платёжной платформы к веб-сервису направляется оповещение с информацией о необходимости выполнения подтверждающих действий и переводе операции `sale` в промежуточное состояние `awaiting customer action` до выполнения необходимых действий пользователем. 17. От сервиса банка к устройству пользователя отправляется уведомление о необходимости выполнения подтверждающих действий. 18. Пользователь выполняет необходимые действия для оплаты на стороне банка согласно инструкции. 19. В сервисе банка выполняется обработка платежа. 20. Информация о результате оплаты отображается пользователю в сервисе банка. 21. От сервиса банка к сервису Bizum направляется информация о результате оплаты. 22. От сервиса Bizum к платёжной платформе направляется информация о результате оплаты. 23. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты. 24. От платёжной платформы к Payment Page направляется информация о результате оплаты. 25. Информация о результате оплаты отображается пользователю на Payment Page. Информация о форматах запросов и оповещений, используемых для проведения оплат методом Bizum через Payment Page, приведена далее в этом разделе; общая информация о работе с Payment Page API — в отдельной статье [Организация взаимодействия](ru_pp_interaction_organisation.md). ### Формат запросов {#section_p5j_fgl_ggb .section} При формировании запросов на открытие платёжной формы с применением метода Bizum необходимо учитывать следующее: 1. Должен использоваться базовый минимум параметров, обязательный для любого платежа: - `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции; - `payment_id` — идентификатор платежа, уникальный в рамках проекта \(и допускающий использование только букв и цифр в кодировке UTF-8, без специальных символов и знаков пунктуации\); - `payment_currency` — буквенный код валюты платежа в формате ISO-4217 alpha-3; - `payment_amount` — сумма платежа в дробных единицах валюты; - `customer_id` — идентификатор пользователя в рамках проекта. 2. Дополнительно рекомендуется указывать телефона пользователя в параметре `customer_phone` \(в международном формате, с кодом страны\). Если этот параметр отсутствует в запросе, в платёжной форме может отобразиться поле для ввода пользователем недостающего значения \(подробнее — в разделе [Дополнение информации о платежах](ru_pp_clarification.md)\). 3. Для предварительного выбора метода Bizum необходимо указывать код этого метода в параметре `force_payment_method` — `bizum`. 4. Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page \([подробнее](ru_PP_Parameters.md)\). 5. После указания всех целевых параметров необходимо составлять подпись \([подробнее](ru_platform_signature.md)\). Таким образом, корректный запрос на открытие платёжной формы с применением метода Bizum должен содержать идентификатор проекта, базовые сведения о платеже \(идентификатор, сумму и код валюты\), информацию о пользователе и подпись, а также может содержать различные дополнительные параметры. ``` {#codeblock_fyz_mnn_w3c .language-json} { "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "EUR", "customer_id": "customer1", "customer_phone": "+11234567889", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" } ``` ``` {#codeblock_cht_mk3_xjc .language-json} { "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "EUR", "customer_id": "customer1", "customer_phone": "+11234567889", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" } ``` ### Формат промежуточных оповещений с информацией о необходимости выполнения подтверждающих действий {#section_fq5_ryf_r4b .section} При проведении каждого платежа с использованием метода Bizum необходимо принять промежуточное оповещение от платёжной платформыФормат таких оповещений является типовым \([подробнее](ru_platform_callbacks.md)\), при этом в оповещении содержится информация о переводе операции `sale` в промежуточное состояние `awaiting customer action`. ``` {#codeblock_v1l_hnq_lhc .language-json} "customer": { "id": "id213" }, "decision": { "message": "Transaction has been checked by RCS" }, "operation": { "id": 7280000015348, "type": "sale", "status": "awaiting customer action", "date": "2025-11-19T06:46:13+0000", "created_date": "2025-11-19T06:46:02+0000", "request_id": "83f70191f842cbb1-00007281", "sum_initial": { "amount": 10000, "currency": "EUR" }, "sum_converted": { "amount": 10000, "currency": "EUR" }, "code": "9999", "message": "Awaiting processing", "provider": { "id": 21624, "payment_id": "", "auth_code": "" } }, "signature": "n/UPMi4E+dqlU8bPP5dsoFyWPEufQ==" } } ``` ### Формат итоговых оповещений {#section_dpx_2hl_ggb .section} Для оповещений о результатах оплат с применением метода Bizum используется типовой формат, описание которого представлено в статье [Работа с оповещениями](ru_platform_callbacks.md). В следующем примере оповещение свидетельствует о том, что в рамках проекта `442` была проведена оплата в размере `10,00 EUR`. ``` {#codeblock_gyz_mnn_w3c .language-json} { "project_id": 442, "payment": { "id": "Bizum_SALE_42:05_IIx8U", "type": "purchase", "status": "success", "date": "2026-04-14T10:42:18+0000", "method": "Bizum", "sum": { "amount": 1000, "currency": "EUR" }, "description": "" }, "operation": { "id": 2882000012699, "type": "sale", "status": "success", "date": "2026-04-14T10:42:18+0000", "created_date": "2026-04-14T10:42:06+0000", "request_id": "f56c90e7c8d597fd77116313-00008328", "sum_initial": { "amount": 1000, "currency": "EUR" }, "sum_converted": { "amount": 1000, "currency": "EUR" }, "code": "0", "message": "Success", "provider": { "id": 21460, "payment_id": "1747996932112", "auth_code": "" } }, "signature": "6RUL34SFfqATQ3jKtzdoUfXMebAEajM5ktBziSsqaNHQQ14A==" } ``` В следующем примере оповещение свидетельствует об отклонённой оплате. ``` {#codeblock_hyz_mnn_w3c .language-json} { "sum_request": { "amount": 150000, "currency": "EUR" }, "request_id": "5f15df63d-00000651", "transaction": { "id": 655000012161, "date": "2026-04-14T10:42:30+0000", "type": "purchase" }, "payment": { "method": "Bizum", "date": "2026-04-14T10:42:30+0000", "result_code": "20000", "result_message": "General decline", "status": "decline", "is_new_attempts_available": false, "attempts_timeout": 0, "id": "Bizum_SALE_cDR7O", "cascading_with_redirect": false, "is_cascading": false, "split_with_redirect": false, "method_id": 1824, "provider_id": 21460 }, "sum_real": { "amount": 150000, "currency": "EUR" }, "rrn": "", "company": { "id": 1, "title": "QA Company" }, "general": { "project_id": 442, "payment_id": "Bizum_cDR7O", "signature": "7rmkfAJsjl/kklkKMy/n1YuCiHZQwbYCfJd1vp0SjXJt7LQ==" }, "description": "", "operations": [ { "id": 655000012671, "type": "sale", "status": "decline", "date": "2026-04-14T10:42:30+0000", "processing_time": null, "request_id": "5f140c1cb3e54832a4edc7f3606420000651", "sum": { "amount": 150000, "currency": "EUR" }, "code": "20000", "message": "General decline", "provider": { "id": 21460, "payment_id": "1747996944360" } } ] } ``` ### Дополнительные материалы {#section_xpz_thl_ggb .section} Для организации работы с оплатами через Payment Page также могут быть полезны следующие материалы: - [Организация взаимодействия](ru_pp_interaction_organisation.md)— о том, как организовать взаимодействие веб-сервиса с платёжной платформой через Payment Page. - [Работа с подписью к данным](ru_platform_signature.md)— о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой. - [Проведение платежей](ru_platform_payment_model.md)— о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций. - [Проведение оплат](ru_pp_purchase.md)— о том, как проводить разовые оплаты с незамедлительным списанием средств через Payment Page. - [Работа с информацией об операциях](ru_platform_payment_info_codes.md)— о служебных кодах, которые используются в платёжной платформе, чтобы фиксировать информацию о выполнении операций. ## Оплаты через Gate {#ru_pm_bizum_gate_purchase} ### Общая информация {#section_lsx_3jl_ggb .section} Для проведения оплаты через Gate с использованием метода Bizum со стороны веб-сервиса необходимо: 1. Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay. 2. Принять промежуточное оповещение от платёжной платформы и отобразить пользователю платёжную инструкцию. 3. Принять итоговое оповещение от платёжной платформы. Полная схема проведения оплаты выглядит следующим образом. ![](images/pm/ru_bizum_uml_gate_1.svg) 1. Пользователь на стороне веб-сервиса инициирует оплату с использованием метода Bizum. 2. От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение оплаты через Gate. 3. Запрос на проведение оплаты поступает в платёжную платформу Ecommpay. 4. В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи. 5. От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности \([подробнее](ru_gate_interaction_organisation.md)\). 6. В платёжной платформе выполняются обработка полученного запроса и его отправка в сервис Bizum. 7. В сервисе Bizum выполняются обработка полученного запроса и его отправка в сервис банка. 8. В сервисе банка выполняется обработка запроса на оплату. 9. От сервиса банка к сервису Bizum отправляется уведомление о необходимости выполнения подтверждающих действий. 10. От сервиса Bizum к платёжной платформе передаётся информация об ожидании подтверждающих действий со стороны пользователя. 11. От платёжной платформы к веб-сервису направляется оповещение с информацией о необходимости выполнения подтверждающих действий и переводе операции `sale` в промежуточное состояние `awaiting customer action` до выполнения необходимых действий пользователем. 12. Пользователю на стороне веб-сервиса отображается платёжная инструкция. 13. От сервиса банка к устройству пользователя отправляется уведомление о необходимости выполнения подтверждающих действий. 14. Пользователь выполняет необходимые действия для оплаты на стороне банка согласно инструкции. 15. В сервисе банка выполняется обработка платежа. 16. Информация о результате оплаты отображается пользователю в сервисе банка. 17. От сервиса банка к сервису Bizum направляется информация о результате оплаты. 18. От сервиса Bizum к платёжной платформе направляется информация о результате оплаты. 19. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты. 20. На стороне веб-сервиса обеспечивается информирование пользователя о результате оплаты. Информация о форматах запросов и оповещений, используемых для проведения оплат методом Bizum через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье [Организация взаимодействия](ru_gate_interaction_organisation.md). ### Формат запросов {#section_osx_3jl_ggb .section} При работе с запросами на оплаты с применением метода Bizum необходимо учитывать следующее: 1. Для инициирования каждой оплаты должен использоваться отдельный POST-запрос к конечной точке `/v2/payment/banks/bizum/sale`, которая относится к группе [/v2/payment/banks/\{payment\_method\}/sale](https://api-developers.ecommpay.com/api-specification/banks/post-v2-payment-banks-payment-method-sale). 2. В каждом запросе должны использоваться следующие объекты и параметры: - `general` — объект, содержащий основные идентификационные сведения запроса: - `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции; - `payment_id` — идентификатор платежа, уникальный в рамках проекта \(и допускающий использование только букв и цифр в кодировке UTF-8, без специальных символов и знаков пунктуации\); - `signature` — подпись запроса, составленная после указания всех целевых параметров \(подробнее — в разделе [Работа с подписью к данным](ru_platform_signature.md)\); - `payment` — объект, содержащий сведения о платеже: - `amount` — сумма платежа в дробных единицах валюты; - `currency` — буквенный код валюты платежав формате ISO-4217 alpha-3; - `customer` — объект, содержащий сведения о пользователе: - `id` — идентификатор пользователя, уникальный в рамках проекта; - `ip_address` — IP-адрес пользователя, актуальный для инициируемого платежа. 3. Дополнительно рекомендуется указывать следующие объекты и параметры: - `customer` — объект, содержащий сведения о пользователе: - `phone` — номер телефона пользователя \(в международном формате, с кодом страны\). Если этот параметр отсутствует в запросе, его название может отправляться в оповещении на уточнение \(подробнее — в статье [Дополнение информации о платеже](ru_Gate_Clarification.md)\). 4. Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации. Таким образом, корректный запрос на оплату с применением метода Bizum должен содержать идентификатор проекта, базовые сведения о платеже \(идентификатор, сумму и код валюты\), информацию о пользователе, подпись, а также может содержать различные дополнительные параметры. ``` {#codeblock_kwl_vnn_w3c .language-json} { "general": { "project_id": 210, "payment_id": "test_payment", "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 1000, "currency": "EUR" }, "customer": { "id": "customer123", "ip_address": "192.0.2.0", "phone": "+11234567889" } } ``` ``` {#codeblock_gbn_bl3_xjc .language-json} { "general": { "project_id": 210, "payment_id": "test_payment", "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 1000, "currency": "EUR" }, "customer": { "id": "customer123", "ip_address": "192.0.2.0", "phone": "+11234567889" } } ``` ### Формат промежуточных оповещений с информацией о необходимости выполнения подтверждающих действий {#section_fq5_ryf_r4b .section} При проведении каждого платежа с использованием метода Bizum необходимо принять промежуточное оповещение от платёжной платформыФормат таких оповещений является типовым \([подробнее](ru_platform_callbacks.md)\), при этом в оповещении содержится информация о переводе операции `sale` в промежуточное состояние `awaiting customer action`. ``` {#codeblock_v1l_hnq_lhc .language-json} "customer": { "id": "id213" }, "decision": { "message": "Transaction has been checked by RCS" }, "operation": { "id": 7280000015348, "type": "sale", "status": "awaiting customer action", "date": "2025-11-19T06:46:13+0000", "created_date": "2025-11-19T06:46:02+0000", "request_id": "83f70191f842cbb1-00007281", "sum_initial": { "amount": 10000, "currency": "EUR" }, "sum_converted": { "amount": 10000, "currency": "EUR" }, "code": "9999", "message": "Awaiting processing", "provider": { "id": 21624, "payment_id": "", "auth_code": "" } }, "signature": "n/UPMi4E+dqlU8bPP5dsoFyWPEufQ==" } } ``` ### Формат итоговых оповещений {#section_wsx_3jl_ggb .section} Для итоговых оповещений об оплатах с применением метода Bizum используется типовой формат, описание которого представлено в статье [Работа с оповещениями](ru_platform_callbacks.md). В следующем примере оповещение свидетельствует о том, что в рамках проекта `442` была проведена оплата в размере `10,00 EUR`. ``` {#codeblock_gyz_mnn_w3c .language-json} { "project_id": 442, "payment": { "id": "Bizum_SALE_42:05_IIx8U", "type": "purchase", "status": "success", "date": "2026-04-14T10:42:18+0000", "method": "Bizum", "sum": { "amount": 1000, "currency": "EUR" }, "description": "" }, "operation": { "id": 2882000012699, "type": "sale", "status": "success", "date": "2026-04-14T10:42:18+0000", "created_date": "2026-04-14T10:42:06+0000", "request_id": "f56c90e7c8d597fd77116313-00008328", "sum_initial": { "amount": 1000, "currency": "EUR" }, "sum_converted": { "amount": 1000, "currency": "EUR" }, "code": "0", "message": "Success", "provider": { "id": 21460, "payment_id": "1747996932112", "auth_code": "" } }, "signature": "6RUL34SFfqATQ3jKtzdoUfXMebAEajM5ktBziSsqaNHQQ14A==" } ``` В следующем примере оповещение свидетельствует об отклонённой оплате. ``` {#codeblock_hyz_mnn_w3c .language-json} { "sum_request": { "amount": 150000, "currency": "EUR" }, "request_id": "5f15df63d-00000651", "transaction": { "id": 655000012161, "date": "2026-04-14T10:42:30+0000", "type": "purchase" }, "payment": { "method": "Bizum", "date": "2026-04-14T10:42:30+0000", "result_code": "20000", "result_message": "General decline", "status": "decline", "is_new_attempts_available": false, "attempts_timeout": 0, "id": "Bizum_SALE_cDR7O", "cascading_with_redirect": false, "is_cascading": false, "split_with_redirect": false, "method_id": 1824, "provider_id": 21460 }, "sum_real": { "amount": 150000, "currency": "EUR" }, "rrn": "", "company": { "id": 1, "title": "QA Company" }, "general": { "project_id": 442, "payment_id": "Bizum_cDR7O", "signature": "7rmkfAJsjl/kklkKMy/n1YuCiHZQwbYCfJd1vp0SjXJt7LQ==" }, "description": "", "operations": [ { "id": 655000012671, "type": "sale", "status": "decline", "date": "2026-04-14T10:42:30+0000", "processing_time": null, "request_id": "5f140c1cb3e54832a4edc7f3606420000651", "sum": { "amount": 150000, "currency": "EUR" }, "code": "20000", "message": "General decline", "provider": { "id": 21460, "payment_id": "1747996944360" } } ] } ``` ### Дополнительные материалы {#section_xsx_3jl_ggb .section} Для организации работы с оплатами через Gate также могут быть полезны следующие материалы: - [Организация взаимодействия](ru_gate_interaction_organisation.md)— о том, как организовать взаимодействие с платёжной платформой через Gate. - [Работа с подписью к данным](ru_platform_signature.md)— о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой. - [Проведение платежей](ru_platform_payment_model.md)— о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций. - [Разовая оплата в одну стадию](ru_platform_sms_model.md)— о том, как проводить разовые оплаты с незамедлительным списанием средств через Gate. - [Работа с информацией об операциях](ru_platform_payment_info_codes.md)— о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций. ## Возвраты через Gate {#ru_pm_bizum_gate_refund} ### Общая информация {#section_lsx_3jl_ggb .section} Для выполнения возврата через Gate с использованием метода Bizum со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay и принять оповещение о результате.Полная схема выполнения возврата выглядит следующим образом. ![](images/pm/ru_bizum_uml_gate_refund.svg) 1. Пользователь инициирует возврат. 2. От веб-сервиса на заданный URL Ecommpay передаётся запрос на выполнение возврата. 3. Запрос на выполнение возврата поступает в платёжную платформу Ecommpay. 4. В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи. 5. От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности \([подробнее](ru_gate_interaction_organisation.md)\). 6. В платёжной платформе обеспечиваются дальнейшая обработка запроса \(с проверкой согласованности параметров\) и его отправка в сервис Bizum. 7. В сервисе Bizum выполняется обработка возврата. 8. От сервиса Bizum к платёжной платформе направляется информация о результате возврата. 9. От платёжной платформы к веб-сервису направляется оповещение о результате возврата. 10. На стороне веб-сервиса обеспечивается информирование пользователя о результате возврата. Информация о форматах запросов и оповещений, используемых для выполнения возвратов методом Bizum через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье [Организация взаимодействия](ru_gate_interaction_organisation.md). ### Формат запросов {#section_osx_3jl_ggb .section} При работе с запросами на возвраты с применением метода Bizum необходимо учитывать следующее: 1. Для инициирования каждого возврата должен использоваться отдельный POST-запрос к конечной точке [/v2/payment/refund](https://api-developers.ecommpay.com/api-specification/direct-debit/post-v2-payment-refund). 2. В каждом запросе должны использоваться следующие объекты и параметры: - `general` — объект, содержащий основные идентификационные сведения запроса: - `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции; - `payment_id` — идентификатор платежа, для которого необходимо выполнить возврат; - `signature` — подпись запроса, составленная после указания всех целевых параметров \(подробнее — в разделе [Работа с подписью к данным](ru_platform_signature.md)\); - `payment` — объект, содержащий сведения о возврате: - `description` — комментарий к возврату или его описание; - `amount` — сумма возврата в дробных единицах валюты \(является обязательной при частичном возврате\); - `currency` — код валюты возврата в формате ISO-4217 alpha-3\(является обязательным при частичном возврате\); 3. Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации. Таким образом, корректный запрос на возврат с применением метода Bizum должен содержать идентификаторы проекта и платежа, описание возврата, подпись, а также, при необходимости, код валюты и сумму возврата. ``` {#codeblock_qqn_14n_w3c .language-json} { "general": { "project_id": 210, "payment_id": "test_payment", "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA==" }, "payment": { "description": "test refund", "amount": 1000, "currency": "EUR" } } ``` ``` {#codeblock_dmf_c42_ggc .language-json} { "general": { "project_id": 210, "payment_id": "test_payment", "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA==" }, "payment": { "description": "test refund", "amount": 1000, "currency": "EUR" } } ``` ### Формат оповещений {#section_wsx_3jl_ggb .section} Для оповещений о результатах возвратов с применением метода Bizum используется типовой формат, описание которого представлено в разделе [Работа с оповещениями](ru_platform_callbacks.md). В следующем примере оповещение свидетельствует о том, что в рамках проекта `442` для пользователя был выполнен частичный возврат в размере `400,00 EUR`. ``` {#codeblock_rqn_14n_w3c .language-json} { "project_id": 442, "payment": { "id": "Bizum_SA_r5raf", "type": "purchase", "status": "refunded", "date": "2026-04-14T10:41:49+0000", "method": "Bizum", "sum": { "amount": 0, "currency": "EUR" }, "description": "" }, "operation": { "id": 1315000012748, "type": "refund", "status": "success", "date": "2026-04-14T10:41:49+0000", "created_date": "2026-04-14T10:41:37+0000", "request_id": "0e241237b73aee5fd263edcff230eb77e38-00001316", "sum_initial": { "amount": 40000, "currency": "EUR" }, "sum_converted": { "amount": 40000, "currency": "EUR" }, "code": "0", "message": "Success", "provider": { "id": 21460, "payment_id": "1747996908248", "auth_code": "" } }, "signature": "n7SrAOilMAiKTSYjSWZs3IJrg61Z80oT6KX6hNd2A+nXXQ==" } ``` В следующем примере оповещение свидетельствует об отклонённом возврате. ``` {#codeblock_sqn_14n_w3c .language-json} { "project_id": 433772, "payment": { "id": "TEST_PAYMENT_832327", "type": "purchase", "status": "success", "date": "2026-04-14T06:44:10+0000", "method": "Bizum", "sum": { "amount": 1000, "currency": "EUR" }, "description": "TEST_PAYMENT_832327" }, "customer": { "id": "1" }, "errors": [ { "code": "2701", "message": "Rules Failed Code", "description": "fatal: RULES_FAILED_CODE" }, { "code": "3358", "message": "Operation amount is less than limit", "description": "Operation amount is less than limit" } ], "operation": { "id": 2764000012860, "type": "refund", "status": "decline", "date": "2026-04-14T06:44:10+0000", "created_date": "2026-04-14T06:44:09+0000", "request_id": "bf5881904060b767f36d20001711", "sum_initial": { "amount": 100, "currency": "MXN" }, "sum_converted": { "amount": 18, "currency": "USD" }, "code": "2701", "message": "Rules Failed Code", "provider": { "id": 21460, "payment_id": "" } }, "signature": "zAmT6dAKwcgu07ZNvA2q+kt53WDPRIRv/yBak0GA==" } ``` ### Дополнительные материалы {#section_xsx_3jl_ggb .section} Для организации работы с возвратами через Gate также могут быть полезны следующие материалы: - [Организация взаимодействия](ru_gate_interaction_organisation.md)— о том, как взаимодействовать с платёжной платформой через Gate. - [Работа с подписью к данным](ru_platform_signature.md)— о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой. - [Проведение платежей](ru_platform_payment_model.md)— о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций. - [Возвраты средств после оплат](ru_Gate_Refund.md)— о том, как выполнять возвраты через Gate. - [Работа с информацией об операциях](ru_platform_payment_info_codes.md)— о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций. ## Возвраты через Dashboard {#ru_pm_dash_refund} При использовании интерфейса Dashboard можно выполнять возвратыметодом Bizum с единичной и пакетной отправкой запросов, называемые соответственно *одиночными* и *массовыми*. - Для выполнения одиночного возврата необходимо выбрать целевую оплату, открыть карточку этой оплаты, указать сумму возврата, отправить запрос и убедиться в выполнении возврата. - Для выполнения массового возврата необходимо подготовить и загрузить файл с информацией обо всех целевых возвратах, отправить пакет запросов и убедиться в выполнении возвратов. При этом должен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе [Сведения о массовых платежах](ru_dbl_payments.md), а параметры возвратов — требованиям, представленным в разделе этой статьи \(за исключением пункта о подписи\). Более подробная информация о выполнении возвратов через Dashboard представлена в [отдельном разделе](ru_dbl_payments.md). ## Анализ результатов проведения платежей {#ru_pm_bizum_dash_analysis} Для анализа информации о платежах и операциях, как в отдельности по методу Bizum, так и в совокупности с другими методами, можно использовать: - инструментарийинтерфейса Dashboard, с различными реестрами и аналитическими панелями; - отчёты в формате CSV, выгружаемые\(как разово, так и периодически\) черезраздел **Отчёты** интерфейса Dashboard; - данные в формате JSON, получаемыепо программным запросам черезинтерфейс Data API. С вопросами по анализу информации можно обращаться к разделам документации \([Dashboard](ru_dbl_about.md) и [Использование Data API](ru_dbl_api_protocol.md)\) и специалистам Ecommpay.