# Neteller {#pm_neteller} статья о работе с платёжным методом Neteller, который позволяет проводить платежи в разных валютах с использованием электронного кошелька в разных странах и для которого в платформе Ecommpay поддерживаются оплаты и выплаты **На уровень выше:**[Платежи с использованием электронных кошельков](ru_pm_ewallet.md) ## Обзор {#ru_pm_neteller_overview} статья о работе с платёжным методом Neteller, который позволяет проводить платежи в разных валютах с использованием электронного кошелька в разных странах и для которого в платформе Ecommpay поддерживаются оплаты и выплаты ### Введение {#section_ql3_5fj_stb .section} Neteller — метод, позволяющий проводить в разных валютах с использованием электронного кошелька в разных странах. Для этого метода в платёжной платформе Ecommpay поддерживаются оплаты и выплаты. В этой статье представлена информация о работе с методом Neteller: обзорный раздел с общими сведениями и последующие разделы с информацией о действиях, необходимых со стороны мерчанта для решения разных задач. ### Характеристика {#section_tbf_2zk_ggb .section} |Тип платёжного метода|платежи с использованием электронных кошельков| |Платёжные инструменты|электронные кошельки| |Регионы использования|все страны, кроме [AF](references/ru/countries/AF.md), [BJ](references/ru/countries/BJ.md), [BQ](references/ru/countries/BQ.md), [BI](references/ru/countries/BI.md), [BL](references/ru/countries/BL.md), [CF](references/ru/countries/CF.md), [CG](references/ru/countries/CG.md), [CU](references/ru/countries/CU.md), [DJ](references/ru/countries/DJ.md), [ER](references/ru/countries/ER.md), [EH](references/ru/countries/EH.md), [GA](references/ru/countries/GA.md), [GM](references/ru/countries/GM.md), [GN](references/ru/countries/GN.md), [GQ](references/ru/countries/GQ.md), [GW](references/ru/countries/GW.md), [GY](references/ru/countries/GY.md), [IR](references/ru/countries/IR.md), [IQ](references/ru/countries/IQ.md), [KN](references/ru/countries/KN.md), [KZ](references/ru/countries/KZ.md), [KG](references/ru/countries/KG.md), [LA](references/ru/countries/LA.md), [LR](references/ru/countries/LR.md), [LY](references/ru/countries/LY.md), [MG](references/ru/countries/MG.md), [MF](references/ru/countries/MF.md), [MW](references/ru/countries/MW.md), [ML](references/ru/countries/ML.md), [MR](references/ru/countries/MR.md), [MN](references/ru/countries/MN.md), [MS](references/ru/countries/MS.md), [MM](references/ru/countries/MM.md), [NR](references/ru/countries/NR.md), [NE](references/ru/countries/NE.md), [NU](references/ru/countries/NU.md), [NF](references/ru/countries/NF.md), [KP](references/ru/countries/KP.md), [PW](references/ru/countries/PW.md), [PG](references/ru/countries/PG.md), [SX](references/ru/countries/SX.md), [SL](references/ru/countries/SL.md), [SS](references/ru/countries/SS.md), [SD](references/ru/countries/SD.md), [SR](references/ru/countries/SR.md), [SY](references/ru/countries/SY.md), [TD](references/ru/countries/TD.md), [TJ](references/ru/countries/TJ.md), [TL](references/ru/countries/TL.md), [TG](references/ru/countries/TG.md), [TM](references/ru/countries/TM.md), [US](references/ru/countries/US.md), [UZ](references/ru/countries/UZ.md), [YE](references/ru/countries/YE.md) \*| |Валюты платежей|необходимо уточнять у курирующего менеджера Ecommpay| |Конвертация валют|на стороне Ecommpay \*| |Разовые оплаты|+| |Повторяемые оплаты|–| |Полные возвраты|–| |Частичные возвраты|–| |Выплаты|+| |Опротестования|–| |Особенности|способ открытия Payment Page — любой, кроме [открытия платёжной формы, встроенной в веб-страницу](ru_PP_method_Embedded.md)| |Организация и стоимость подключения|по согласованию с курирующим менеджером Ecommpay; дополнительную информацию можно получить в [Ecommpay shop](https://ecommpay.com/shop/payment-methods/neteller/)| \* Информацию следует уточнить у курирующего менеджера Ecommpay. ### Схема работы {#section_tsp_gzk_ggb .section} В проведении отдельного платежа с использованием метода Neteller задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа Ecommpay, а также технические средства сервиса Neteller. ![](images/pm/ru_neteller_functional_new.svg) ### Основные операции {#section_rnx_4cl_ggb .section} Для проведения платежей и выполнения операций с использованием метода Neteller могут применяться различные интерфейсы платёжной платформы. Так, оплаты могут проводиться через Payment Page, Gate и Dashboard \(с применением платёжных ссылок\), а выплаты — через Gate и Dashboard. ### Сценарии использования {#section_fgt_sdl_ggb .section} Проведение оплат с использованием метода Neteller осуществляется с перенаправлением пользователей к сервису Neteller, проведение выплат — с уведомлением пользователей через веб-сервис мерчанта. Пользовательский сценарий оплаты через Payment Page выглядит следующим образом. ![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_neteller_1.svg "Переход к оплате") ![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_neteller_2.svg "Выбор метода") ![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_neteller_3.svg "Аутентификация") ![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_neteller_4.svg "Подтверждение платежа") ![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_neteller_5.svg "Возвращение к форме") ![](images/ecommpay/pm_pp_scenario/ru_pp_customer_scenario_neteller_6.svg "Возвращение к веб-сервису") Общие сценарии проведения оплат и выплат можно представить следующим образом. ![](images/pm/ru_neteller_interfaces_pp_new.svg "Оплата через Payment Page") ![](images/pm/ru_neteller_interfaces_gate_new.svg "Оплата через Gate") ![](images/pm/ru_neteller_interfaces_gate_payout_new.svg "Выплата через Gate") ## Оплаты через Payment Page {#ru_pm_neteller_pp_purchase} ### Общая информация {#section_gtg_vxk_m2b .section} Для проведения оплаты через Payment Pageс использованием метода Neteller со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay и принять оповещение о результате.Полная схема проведения оплаты выглядит следующим образом. ![](images/pm/ru_neteller_uml_pp_new.svg) 1. Пользователь на стороне веб-сервиса инициирует оплату. 2. От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение оплаты через Payment Page. 3. Запрос на проведение оплаты поступает в платёжную платформу. 4. В платёжной платформе выполняется приём запроса, с проверкой наличия обязательных параметров и корректной подписи. 5. Осуществляется подготовка Payment Page согласно параметрам проекта и вызова. 6. Пользователю отображается платёжная форма. 7. Пользователь выбирает для оплаты метод Neteller. 8. В платёжную платформу передаётся запрос на проведение оплаты с использованием метода Neteller. 9. В платёжной платформе выполняются обработка полученного запроса и его отправка в сервис Neteller. 10. В сервисе Neteller выполняется обработка запроса на оплату. 11. От сервиса Neteller к платёжной платформе передаются данные для перенаправления пользователя к сервису Neteller. 12. Данные для перенаправления пользователя передаются к Payment Page. 13. Пользователь перенаправляется к сервису Neteller. 14. Пользователь выполняет необходимые действия для оплаты. 15. В сервисе Neteller выполняется обработка платежа. 16. Информация о результате оплаты отображается пользователю в сервисе Neteller. 17. Пользователь перенаправляется к Payment Page. 18. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты. 19. От платёжной платформы к Payment Page направляется информация о результате оплаты. 20. Информация о результате оплаты отображается пользователю на Payment Page. Информация о форматах запросов и оповещений, используемых для проведения оплат методом Neteller через Payment Page, приведена далее в этом разделе; общая информация о работе с Payment Page API — в отдельной статье [Организация взаимодействия](ru_pp_interaction_organisation.md). ### Формат запросов {#section_p5j_fgl_ggb .section} При формировании запросов на открытие платёжной формы с применением метода Neteller необходимо учитывать следующее: 1. Должен использоваться базовый минимум параметров, обязательный для любого платежа: - `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции; - `payment_id` — идентификатор платежа, уникальный в рамках проекта; - `payment_currency` — код валюты платежа в формате ISO-4217 alpha-3; - `payment_amount` — сумма платежа в дробных единицах валюты; - `customer_id` — идентификатор пользователя в рамках проекта. 2. Дополнительно рекомендуется указывать адрес электронной почты, на которую зарегистрирована учетная запись пользователя в сервисе Neteller в параметре `customer_account_number`. Если этот параметр отсутствует в запросе, в платёжной форме может отобразиться поле для ввода пользователем недостающего значения \(подробнее — в разделе [Дополнение информации о платежах](ru_pp_clarification.md)\). 3. Для предварительного выбора метода Neteller необходимо указывать код платёжного метода в параметре `force_payment_method` — `neteller-wallet`. 4. Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page \([подробнее](ru_PP_Parameters.md)\). 5. После указания всех целевых параметров необходимо составлять подпись \([подробнее](ru_platform_signature.md)\). Таким образом, корректный запрос на открытие платёжной формы с применением метода Neteller должен содержать идентификатор проекта, базовые сведения о платеже \(идентификатор, сумму и код валюты\), идентификатор и адрес электронной почты пользователя и подпись. ```language-json { "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "USD", "customer_id": "customer1", "customer_account_number": "test@example.com", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" } ``` ```language-json { "project_id": 120, "payment_id": "580", "payment_amount": 1000, "payment_currency": "USD", "customer_id": "customer1", "customer_account_number": "test@example.com", "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg==" } ``` ### Формат оповещений {#section_dpx_2hl_ggb .section} Для оповещений о результатах оплат с применением метода Neteller используется типовой формат, описание которого представлено в разделе [Работа с оповещениями](ru_platform_callbacks.md). В следующем примере оповещение свидетельствует о том, что в рамках проекта `210` была проведена оплата в размере `10,00 EUR`. ```language-json { "project_id": 210, "payment": { "id": "ORDER_ID_1584627953", "type": "purchase", "status": "success", "date": "2020-03-19T14:26:25+0000", "method": "neteller", "sum": { "amount": 1000, "currency": "EUR" }, "description": "Neteller purchase success" }, "account": { "number": "netellertest@example.com" }, "customer": { "id": "123" }, "operation": { "id": 202, "type": "sale", "status": "success", "date": "2020-03-19T14:26:25+0000", "created_date": "2020-03-19T14:25:54+0000", "request_id": "55e5e198a2580e9ddb1756169dd960b47aeb-00000001", "sum_initial": { "amount": 1000, "currency": "EUR" }, "sum_converted": { "amount": 1000, "currency": "EUR" }, "code": "0", "message": "Success", "provider": { "id": 1987, "payment_id": "1584627957265", "auth_code": "", "date": "2020-03-19T14:26:24+0000" } }, "signature": "rv9EhRK3W1eRPzvlzZ3e3tttjgANs3z0Vi5OmH7GJ4qFqg==" } ``` В следующем примере оповещение свидетельствует об отклонённой оплате. ```language-json { "project_id": 210, "payment": { "id": "ORDER_ID_1584627954", "type": "purchase", "status": "decline", "date": "2020-03-19T14:26:25+0000", "method": "neteller", "sum": { "amount": 1000, "currency": "EUR" }, "description": "Neteller purchase decline" }, "account": { "number": "netellertest@example.com" }, "customer": { "id": "123" }, "operation": { "id": 203, "type": "sale", "status": "decline", "date": "2020-03-19T14:26:25+0000", "created_date": "2020-03-19T14:25:54+0000", "request_id": "55e5e1989ddb1756169dd960b47aeb-00000001", "sum_initial": { "amount": 1000, "currency": "EUR" }, "sum_converted": { "amount": 1000, "currency": "EUR" }, "code": "20602", "message": "Time-out", "provider": { "id": 1988, "payment_id": "1584627957266", "auth_code": "", "date": "2020-03-19T14:26:24+0000" } }, "signature": "rv9EhRK3W1eRPzvlzZ3e3tttjgANs3z0Vi5OmH7GJ4qFqg==" } ``` ### Дополнительные материалы {#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_neteller_gate_purchase} ### Общая информация {#section_lsx_3jl_ggb .section} Для проведения оплаты через Gate с использованием метода Neteller со стороны веб-сервиса необходимо: 1. Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay. 2. Принять промежуточное оповещение от платёжной платформы и осуществить перенаправление пользователя к сервису Neteller. 3. Принять итоговое оповещение от платёжной платформы. Полная схема проведения оплаты выглядит следующим образом. ![](images/pm/ru_neteller_uml_gate_new.svg) 1. Пользователь на стороне веб-сервиса инициирует оплату с использованием метода Neteller. 2. От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение оплаты через Gate. 3. Запрос на проведение оплаты поступает в платёжную платформу Ecommpay. 4. В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи. 5. От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности \([подробнее](ru_gate_interaction_organisation.md)\). 6. В платёжной платформе выполняются дальнейшая обработка запроса \(с проверкой согласованности параметров\) и его отправка в сервис Neteller. 7. В сервисе Neteller выполняется обработка запроса на оплату. 8. От сервиса Neteller к платёжной платформе передаются данные для перенаправления пользователя к сервису Neteller. 9. От платёжной платформы к веб-сервису направляется оповещение с данными для перенаправления пользователя к сервису Neteller. 10. Пользователь перенаправляется к сервису Neteller. 11. Пользователь выполняет необходимые действия для оплаты. 12. В сервисе Neteller выполняется обработка платежа. 13. Пользователю отображается информация о результате оплаты. 14. Пользователь перенаправляется к веб-сервису. 15. От платёжной платформы к веб-сервису направляется оповещение о результате оплаты. 16. На стороне веб-сервиса обеспечивается информирование пользователя о результате оплаты. Информация о форматах запросов и оповещений, используемых для проведения оплат методом Neteller через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье [Организация взаимодействия](ru_gate_interaction_organisation.md). ### Формат запросов {#section_osx_3jl_ggb .section} При работе с запросами на оплаты с применением метода Neteller необходимо учитывать следующее: 1. Для инициирования каждой оплаты должен использоваться отдельный POST-запрос к конечной точке `/v2/payment/wallet/neteller/sale`. Эта точка относится к группе [/v2/payment/wallet/\{payment\_method\}/sale](https://api-developers.ecommpay.com/api-specification/wallet/post-v2-payment-wallet-payment-method-sale). 2. В каждом запросе должны использоваться следующие объекты и параметры: - `general` — объект, содержащий основные идентификационные сведения запроса: - `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции; - `payment_id` — идентификатор платежа, уникальный в рамках проекта; - `signature` — подпись запроса, составленная после указания всех целевых параметров \(подробнее — в разделе [Работа с подписью к данным](ru_platform_signature.md)\); - `payment` — объект, содержащий сведения о платеже: - `amount` — сумма платежа в дробных единицах валюты; - `currency` — код валюты платежав формате ISO-4217 alpha-3; - `customer` — объект, содержащий сведения о пользователе: - `id` — идентификатор пользователя, уникальный в рамках проекта; - `ip_address` — IP-адрес пользователя, актуальный для инициируемого платежа; - `account` — объект, содержащий сведения об учётной записи пользователя: - `number` — адрес электронной почты, на которую зарегистрирована учетная запись пользователя в сервисе Neteller. В соответствии с протоколом работы сервиса Neteller требуется настроить проверку вводимых пользователями значений на стороне веб-сервиса и допускать ввод только таких значений, которые соответствуют формату адреса электронной почты. 3. Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации. Таким образом, корректный запрос на оплату с применением метода Neteller должен содержать идентификатор проекта, базовые сведения о платеже \(идентификатор, сумму и код валюты\), идентификатор, IP-адрес и адрес электронной почты пользователя, а также подпись. ```language-json { "general": { "project_id": 123, "payment_id": "ID_178", "signature": "PJkV8ej\/UG0Di8hTng6JvC7Y3Tv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 100, "currency": "EUR" }, "customer": { "ip_address": "192.0.2.0", "id": "customer123" }, "account": { "number": "test@example.com" } } ``` ```language-json { "general": { "project_id": 123, "payment_id": "ID_178", "signature": "PJkV8ej\/UG0Di8hTng6JvC7Y3Tv+AWoXW\/9MTO8yJA==" }, "payment": { "amount": 100, "currency": "EUR" }, "customer": { "ip_address": "192.0.2.0", "id": "customer123" }, "account": { "number": "test@example.com" } } ``` ### Формат промежуточных оповещений для перенаправления пользователей {#section_x23_cpg_vgb .section} Для перенаправления пользователей от веб-сервиса мерчанта к сервису Neteller при проведении каждого платежа с использованием метода Neteller необходимо принять промежуточное оповещение от платёжной платформы и использовать информацию из него, включённую в объект `redirect_data`. Формат таких оповещений является типовым \([подробнее](ru_platform_callbacks.md)\), при этом в состав объекта `redirect_data` включаются следующие объекты и параметры: - `body` — объект с данными для отправки в теле запроса; - `method` — параметр с указанием HTTP-метода отправки запроса\(`GET` или `POST`\); - `url` — параметр со ссылкой для перенаправления. ```language-json "redirect_data": { "body": {}, "method": "GET", "url": "https://www.example.com/pay" } ``` ### Формат итоговых оповещений {#section_wsx_3jl_ggb .section} Для оповещений о результатах оплат с применением метода Neteller используется типовой формат, описание которого представлено в разделе [Работа с оповещениями](ru_platform_callbacks.md). В следующем примере оповещение свидетельствует о том, что в рамках проекта `210` была проведена оплата в размере `10,00 EUR`. ```language-json { "project_id": 210, "payment": { "id": "ORDER_ID_1584627953", "type": "purchase", "status": "success", "date": "2020-03-19T14:26:25+0000", "method": "neteller", "sum": { "amount": 1000, "currency": "EUR" }, "description": "Neteller purchase success" }, "account": { "number": "netellertest@example.com" }, "customer": { "id": "123" }, "operation": { "id": 202, "type": "sale", "status": "success", "date": "2020-03-19T14:26:25+0000", "created_date": "2020-03-19T14:25:54+0000", "request_id": "55e5e198a2580e9ddb1756169dd960b47aeb-00000001", "sum_initial": { "amount": 1000, "currency": "EUR" }, "sum_converted": { "amount": 1000, "currency": "EUR" }, "code": "0", "message": "Success", "provider": { "id": 1987, "payment_id": "1584627957265", "auth_code": "", "date": "2020-03-19T14:26:24+0000" } }, "signature": "rv9EhRK3W1eRPzvlzZ3e3tttjgANs3z0Vi5OmH7GJ4qFqg==" } ``` В следующем примере оповещение свидетельствует об отклонённой оплате. ```language-json { "project_id": 210, "payment": { "id": "ORDER_ID_1584627954", "type": "purchase", "status": "decline", "date": "2020-03-19T14:26:25+0000", "method": "neteller", "sum": { "amount": 1000, "currency": "EUR" }, "description": "Neteller purchase decline" }, "account": { "number": "netellertest@example.com" }, "customer": { "id": "123" }, "operation": { "id": 203, "type": "sale", "status": "decline", "date": "2020-03-19T14:26:25+0000", "created_date": "2020-03-19T14:25:54+0000", "request_id": "55e5e1989ddb1756169dd960b47aeb-00000001", "sum_initial": { "amount": 1000, "currency": "EUR" }, "sum_converted": { "amount": 1000, "currency": "EUR" }, "code": "20602", "message": "Time-out", "provider": { "id": 1988, "payment_id": "1584627957266", "auth_code": "", "date": "2020-03-19T14:26:24+0000" } }, "signature": "rv9EhRK3W1eRPzvlzZ3e3tttjgANs3z0Vi5OmH7GJ4qFqg==" } ``` ### Дополнительные материалы {#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_neteller_gate_payout} ### Общая информация {#section_lsx_3jl_ggb .section} Для проведения выплаты через Gate с использованием метода Neteller со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL Ecommpay и принять оповещение о результате.Полная схема проведения выплаты выглядит следующим образом. ![](images/pm/ru_neteller_uml_gate_payout_new.svg) 1. Пользователь на стороне веб-сервиса инициирует выплату через Neteller. 2. От веб-сервиса на заданный URL Ecommpay передаётся запрос на проведение выплаты через Gate. 3. Запрос на проведение выплаты поступает в платёжную платформу. 4. В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи. 5. От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности. Подробнее — в разделе [Формат ответа](ru_gate_interaction_organisation.md). 6. В платёжной платформе обеспечиваются дальнейшая обработка запроса \(с проверкой согласованности параметров\) и его отправка в сервис Neteller. 7. В сервисе Neteller выполняется обработка выплаты. 8. От сервиса Neteller к платёжной платформе направляется информация о результате выплаты. 9. От платёжной платформы к веб-сервису направляется оповещение о результате выплаты. 10. На стороне веб-сервиса обеспечивается информирование пользователя о результате выплаты. Информация о форматах запросов и оповещений, используемых для проведения выплат методом Neteller через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье [Организация взаимодействия](ru_gate_interaction_organisation.md). ### Формат запросов {#section_osx_3jl_ggb .section} При работе с запросами на выплаты с применением метода Neteller необходимо учитывать следующее: 1. Для инициирования каждой выплаты должен использоваться отдельный POST-запрос к конечной точке `/v2/payment/wallet/neteller/payout`. Эта точка относится к группе [/v2/payment/wallet/\{payment\_method\}/payout](https://api-developers.ecommpay.com/api-specification/wallet/post-v2-payment-wallet-payment-method-payout). 2. В каждом запросе должны использоваться следующие объекты и параметры: - `general` — объект, содержащий основные идентификационные сведения запроса: - `project_id` — идентификатор проекта, полученный от Ecommpay при интеграции; - `payment_id` — идентификатор платежа, уникальный в рамках проекта; - `signature` — подпись запроса, составленная после указания всех целевых параметров \(подробнее — в разделе [Работа с подписью к данным](ru_platform_signature.md)\); - `payment` — объект, содержащий сведения о платеже: - `amount` — сумма выплаты в дробных единицах валюты; - `currency` — код валюты платежав формате ISO-4217 alpha-3; - `customer` — объект, содержащий сведения о пользователе: - `id` — идентификатор пользователя, уникальный в рамках проекта; - `ip_address` — IP-адрес пользователя, актуальный для инициируемой выплаты; - `account` — объект, содержащий сведения об учётной записи пользователя: - `number` — адрес электронной почты, на которую зарегистрирована учетная запись пользователя в сервисе Neteller. В соответствии с протоколом работы сервиса Neteller требуется настроить проверку вводимых пользователями значений на стороне веб-сервиса и допускать ввод только таких значений, которые соответствуют формату адреса электронной почты. 3. Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации. Таким образом, корректный запрос на выплату с применением метода Neteller должен содержать идентификатор проекта, базовые сведения о платеже \(его идентификатор, сумму и код валюты\), идентификатор, IP-адрес и адрес электронной почты пользователя, а также подпись. ```language-json "general": { "project_id": 200, "payment_id": "123", "signature": "8ff12bcdfa8496f8e93fd94bbe4c527be==" }, "payment": { "amount": 1000, "currency": "EUR" }, "customer": { "id": "customer1", "ip_address": "192.0.2.0" }, "account":{ "number": "netellertest@example.com" } ``` ```language-json "general": { "project_id": 200, "payment_id": "123", "signature": "8ff12bcdfa8496f8e93fd94bbe4c527be==" }, "payment": { "amount": 1000, "currency": "EUR" }, "customer": { "id": "customer1", "ip_address": "192.0.2.0" }, "account":{ "number": "netellertest@example.com" } ``` ### Формат оповещений {#section_wsx_3jl_ggb .section} Для оповещений о результатах выплат с применением метода Neteller используется типовой формат, описание которого представлено в разделе [Работа с оповещениями](ru_platform_callbacks.md). В следующем примере оповещение свидетельствует о том, что в рамках проекта `210` была проведена выплата в размере `10,00 EUR`. ```language-json { "project_id": 210, "payment": { "id": "ORDER_ID_1584628087", "type": "payout", "status": "success", "date": "2020-03-19T14:28:57+0000", "method": "neteller", "sum": { "amount": 1000, "currency": "EUR" }, "description": "Neteller payout success" }, "account": { "number": "netellertest@example.com" }, "customer": { "id": "123" }, "operation": { "id": 1000000201, "type": "payout", "status": "success", "date": "2020-03-19T14:28:57+0000", "created_date": "2020-03-19T14:28:11+0000", "request_id": "e03c2b85a7f816f0ecfdcb0a3de74525-00000002", "sum_initial": { "amount": 1000, "currency": "EUR" }, "sum_converted": { "amount": 1000, "currency": "EUR" }, "code": "0", "message": "Success", "provider": { "id": 1987, "payment_id": "1595720491729", "auth_code": "", "date": "2020-03-19T14:28:56+0000" } }, "signature": "uQEJSDLG1wgoVwMwrbOPS9o+EV09aBakCA8xoeSkDpF/CCIYl1xbVw==" } ``` В следующем примере оповещение свидетельствует об отклонённой выплате. ```language-json { "project_id": 210, "payment": { "id": "ORDER_ID_1584628087", "type": "payout", "status": "decline", "date": "2020-03-19T14:28:57+0000", "method": "neteller", "sum": { "amount": 1000, "currency": "EUR" }, "description": "Neteller payout decline" }, "account": { "number": "netellertest@example.com" }, "customer": { "id": "123" }, "operation": { "id": 1000000201, "type": "payout", "status": "decline", "date": "2020-03-19T14:28:57+0000", "created_date": "2020-03-19T14:28:11+0000", "request_id": "e03c2b85a7f816f0ecf0ab0a3de74525-00000002", "sum_initial": { "amount": 1000, "currency": "EUR" }, "sum_converted": { "amount": 1000, "currency": "EUR" }, "code": "20602", "message": "Time-out", "provider": { "id": 1988, "payment_id": "1595720491720", "auth_code": "", "date": "2020-03-19T14:28:56+0000" } }, "signature": "uQEJSDLG1wgoVwMwr9o+EV09aBakCA8xoeSkDpF/CCIYl1xbVw==" } ``` ### Дополнительные материалы {#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 можно проводить *одиночные* и *массовые*выплатыметодом Neteller с единичной и пакетной отправкой запросов, называемые соответственно *одиночными* и *массовыми*. - Для проведения одиночной выплаты необходимо открыть форму выплаты, задать все необходимые параметры \(включая метод\), отправить запрос и убедиться в проведении выплаты. - Для проведения массовой выплаты необходимо подготовить и загрузить файл с информацией обо всех целевых выплатах, отправить пакет запросов и убедиться в проведении выплат. При этомдолжен использоваться файл формата CSV, структура которого соответствует требованиям, представленным в разделе [Сведения о массовых платежах](ru_dbl_payments.md), а параметры выплат— требованиям, представленным в разделе [Выплаты через Gate](pm_neteller.md) этой статьи \(за исключением пункта о подписи\). Более подробная информация о проведении выплат через Dashboard представлена в [отдельной статье](ru_dbl_payments.md). ## Тестирование {#ru_pm_neteller_testing} ### Общая информация {#section_ujs_5q4_zjb .section} Для метода Neteller доступно тестирование оплат через Payment Page и Gate, а также выплат через Gate. Тестирование может выполняться в рамках тестового проекта, и для подключения и отключения этой функциональности следует обращаться к специалистам технической поддержки Ecommpay. При тестировании платежей следует учитывать, что в запросах должен указываться идентификатор тестового проекта, в качестве валюты может использоваться только [BRL](references/ru/currencies/BRL.md), [EUR](references/ru/currencies/EUR.md), [GBP](references/ru/currencies/GBP.md), [JPY](references/ru/currencies/JPY.md), [USD](references/ru/currencies/USD.md), а интерфейсы эмулятора платёжных форм Payment Page и Neteller могут отличаться от рабочих. ![](images/pm/pm_neteller_test_new.jpg) ### Статусы тестовых платежей {#section_vjs_5q4_zjb .section} При тестировании оплат их итоговые статусы определяются исходя из сумм, указанных в запросах: - `decline` — при указании суммы `40000` или `40400`, - `success` — при указании любой другой суммы. При тестировании выплат их итоговые статусы определяются исходя из сумм, указанных в запросах: - `decline` — при указании суммы `40000` или `40400`, - `success` — при указании любой другой суммы. ### Оплаты через Payment Page {#section_syj_bt4_xjb .section} Для проведения тестовой оплаты через Payment Page необходимо: 1. Отправить в платёжную платформу корректный тестовый запрос на открытие Payment Page. 2. Если в запросе не был указан метод `neteller-wallet` — выбрать метод Neteller на странице эмулятора. 3. Указать в поле ввода произвольный адрес электронной почты. 4. Щёлкнуть кнопку **Success** или **Decline** \(в зависимости от запрашиваемой суммы\). 5. Принять итоговое оповещение с информацией о результате оплаты. Более подробная информация о проведении оплат с использованием метода Neteller через Payment Page представлена в разделе [Оплаты через Payment Page](pm_neteller.md) этой статьи. ### Оплаты через Gate {#section_ul5_gt4_xjb .section} Для проведения тестовой оплаты через Gate необходимо: 1. Отправить в платёжную платформу корректный тестовый запрос на оплату. 2. Принять оповещение с данными для перенаправления. 3. Перейти по полученному URL и щёлкнуть кнопку **Success** или **Decline** \(в зависимости от запрашиваемой суммы\) — на странице эмулятора. 4. Принять итоговое оповещение с информацией о результате оплаты. Более подробная информация о проведении оплат с использованием метода Neteller через Gate представлена в разделе [Оплаты через Gate](pm_neteller.md) этой статьи. ### Выплаты через Gate {#section_n22_lt4_xjb .section} Для проведения тестовой выплаты через Gate необходимо отправить в платёжную платформу корректный тестовый запрос и принять итоговое оповещение с информацией о результате. Более подробная информация о проведении выплат с использованием метода Neteller представлена в разделе [Выплаты через Gate](pm_neteller.md) этой статьи. ## Анализ результатов проведения платежей {#ru_pm_neteller_dash_analysis} Для анализа информации о платежах и операциях, как в отдельности по методу Neteller, так и в совокупности с другими методами, можно использовать: - инструментарийинтерфейса Dashboard, с различными реестрами и аналитическими панелями; - отчёты в формате CSV, выгружаемые\(как разово, так и периодически\) черезраздел **Отчёты** интерфейса Dashboard; - данные в формате JSON, получаемыепо программным запросам черезинтерфейс Data API. С вопросами по анализу информации можно обращаться к разделам документации \([Dashboard](ru_dbl_about.md) и [Использование Data API](ru_dbl_api_protocol.md)\) и специалистам Ecommpay.