WB Кошелёк

Обзор

Введение

«WB Кошелёк» — метод, позволяющий проводить платежи в российских рублях с использованием электронных кошельков в России. Для этого метода в платёжной платформе EtoPlatezhi поддерживаются оплаты и возвраты.

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

Характеристика


Тип платёжного метода	платежи с использованием электронных кошельков
Платёжные инструменты	электронные кошельки
Регионы использования	RU
Валюты платежей	RUB
Конвертация валют	на стороне EtoPlatezhi
Разовые оплаты	+
Повторяемые оплаты	+
Полные возвраты	+
Частичные возвраты	–
Выплаты	–
Опротестования	–
Особенности	–
Организация и стоимость подключения	по согласованию с курирующим менеджером EtoPlatezhi

Схема работы

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

Основные операции

Для проведения платежей и выполнения операций с использованием метода «WB Кошелёк» могут применяться различные интерфейсы платёжной платформы. Так, оплаты могут проводиться через Payment Page, Gate и Dashboard (с применением платёжных ссылок), возвраты — через Gate и Dashboard. При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения.

При работе с методом «WB Кошелёк», независимо от используемых интерфейсов, актуальны следующие свойства и ограничения.


	Суммы, RUB		Время ¹
	минимум	максимум	базовое	предельное
Оплаты	1,00	600 000,00	1 минута	3 часа
Возвраты	–	–	–	–

Прим.:

Базовое и предельное время определяются следующим образом:
- Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время определяется для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя (там, где они необходимы). Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа (подробнее).
- Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус decline. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки EtoPlatezhi.

Сценарии использования

Проведение оплат с использованием метода «WB Кошелёк» осуществляется с перенаправлением пользователей к сервису провайдера, выполнение возвратов — с заявкой со стороны пользователя и уведомлением со стороны веб-сервиса.

Сценарии выполнения операций через основные интерфейсы платёжной платформы соответствуют представленным на схемах. При использовании дополнительных возможностей (таких как оплаты по платёжным ссылкам) сценарии выполнения операций методом «WB Кошелёк» соответствуют специфике этих возможностей.

Оплаты через Payment Page

Общая информация

Для проведения оплаты через Payment Page с использованием метода «WB Кошелёк» со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL EtoPlatezhi и принять оповещение о результате. Полная схема проведения оплаты выглядит следующим образом.

Рис. 4. Проведение оплаты через Payment Page. Описание шагов

Пользователь на стороне веб-сервиса инициирует оплату.
От веб-сервиса на заданный URL EtoPlatezhi передаётся запрос на проведение оплаты через Payment Page.
Запрос на проведение оплаты поступает в платёжную платформу.
В платёжной платформе выполняется приём запроса, с проверкой наличия обязательных параметров и корректной подписи.
Осуществляется подготовка к открытию платёжной формы согласно параметрам проекта и вызова.
Пользователю отображается платёжная форма.
Пользователь выбирает для оплаты метод «WB Кошелёк».
В платёжную платформу передаётся запрос на проведение оплаты с использованием метода «WB Кошелёк».
В платёжной платформе выполняются обработка полученного запроса и его отправка в сервис провайдера.
В сервисе провайдера выполняется обработка запроса на оплату.
От сервиса провайдера пользователю направляется информация для подтверждения оплаты.
Пользователь выполняет необходимые действия для оплаты.
В сервисе провайдера выполняется обработка платежа.
Информация о результате оплаты отображается пользователю в сервисе провайдера.
Пользователь перенаправляется к Payment Page.
От сервиса провайдера к платёжной платформе направляется информация о результате оплаты.
От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
От платёжной платформы к Payment Page направляется информация о результате оплаты.
Информация о результате оплаты отображается пользователю на Payment Page.

Информация о форматах запросов и оповещений, используемых для проведения оплат методом «WB Кошелёк» через Payment Page, приведена далее в этом разделе; общая информация о работе с Payment Page API — в отдельной статье Организация взаимодействия.

Формат запросов

При формировании запросов на открытие платёжной формы с применением метода «WB Кошелёк» необходимо учитывать следующее:

Должен использоваться базовый минимум параметров, обязательный для любого платежа:
- project_id — идентификатор проекта, полученный от EtoPlatezhi при интеграции;
- payment_id — идентификатор платежа, уникальный в рамках проекта;
- payment_currency — буквенный код валюты платежа в формате ISO-4217 alpha-3;
- payment_amount — сумма платежа в дробных единицах валюты;
- customer_id — идентификатор пользователя в рамках проекта.
Должен использоваться базовый минимум параметров: project_id, payment_id, payment_currency, payment_amount, customer_id.
Дополнительно необходимо указывать номер телефона пользователя, ассоциируемый с учётной записью в сервисе «WB Кошелёк» в параметре customer_account_number.
Для предварительного выбора метода «WB Кошелёк» необходимо указывать в параметре force_payment_method код платёжного метода — wildberries.
Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page (подробнее).
После указания всех целевых параметров необходимо составлять подпись (подробнее).

Таким образом, корректный запрос на открытие платёжной формы с применением метода «WB Кошелёк» должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), идентификатор, номер телефона пользователя и подпись, а также может содержать различные дополнительные параметры.

{
   "project_id": 120,
   "payment_id": "580",
   "payment_amount": 1000,
   "payment_currency": "RUB",
   "customer_id": "customer1",
   "customer_account_number": "79991234567",
   "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg=="
}

Рис. 5. Пример достаточного набора данных для запроса на оплату

{
   "project_id": 120,
   "payment_id": "580",
   "payment_amount": 1000,
   "payment_currency": "RUB",
   "customer_id": "customer1",
   "customer_account_number": "79991234567",
   "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg=="
}

Формат оповещений

Для оповещений о результатах оплат с применением метода «WB Кошелёк» используется типовой формат, описание которого представлено в статье Работа с оповещениями (подробнее).

В следующем примере оповещение свидетельствует о том, что в рамках проекта 129103 была проведена оплата в размере 10,00 RUB.

Рис. 6. Пример данных из оповещения о проведении оплаты

{
    "payment": {
        "date": "2025-11-13T08:34:42+0000",
        "method": "wildberries",
        "sum": {
            "amount": 1000,
            "currency": "RUB"
        },
        "id": "testwb1",
        "type": "purchase",
        "status": "success",
        "description": ""
    },
    "customer": {
        "id": "1"
    },
    "account": {
        "number": "***4471"
    },
    "project_id": 129103,
    "operation": {
        "provider": {
            "id": 18791,
            "payment_id": "a103d070-ab7628f82a8f",
            "auth_code": ""
        },
        "id": 5026717010142355,
        "type": "sale",
        "status": "success",
        "date": "2025-11-13T08:34:42+0000",
        "sum_initial": {
            "amount": 1000,
            "currency": "RUB"
        },
        "created_date": "2025-11-13T08:34:29+0000",
        "request_id": "3d55427b78f80c0da8e8-05026718",
        "sum_converted": {
            "amount": 1000,
            "currency": "RUB"
        },
        "code": "0",
        "message": "Success"
    },
    "signature": "gw3d4qL5Yu1n/YhIhpMXZHnLbnLZ/ziI0LO8TPslOfA=="
}

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

Рис. 7. Пример данных из оповещения об отклонении оплаты

{
    "payment": {
        "date": "2025-11-13T08:33:49+0000",
        "method": "wildberries",
        "sum": {
            "amount": 1000,
            "currency": "RUB"
        },
        "id": "testwb",
        "type": "purchase",
        "status": "decline",
        "description": ""
    },
    "customer": {
        "id": "1"
    },
    "account": {
        "number": "578954******5254"
    },
    "project_id": 129103,
    "operation": {
        "provider": {
            "id": 18791,
            "payment_id": "",
            "auth_code": ""
        },
        "id": 5008838010142407,
        "type": "sale",
        "status": "decline",
        "date": "2025-11-13T08:33:49+0000",
        "sum_initial": {
            "amount": 1000,
            "currency": "RUB"
        },
        "created_date": "2025-11-13T08:33:46+0000",
        "request_id": "b5ee59190f3ceae5ffee-05008839",
        "sum_converted": {
            "amount": 1000,
            "currency": "RUB"
        },
        "code": "20000",
        "message": "General decline"
    },
    "signature": "9m4ZK9fWYHIeIR/tRzo/bGP14gSQWtaiKNuEA=="
}

Дополнительные материалы

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

Организация взаимодействия — о том, как организовать взаимодействие веб-сервиса с платёжной платформой через Payment Page.
Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
Проведение платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
Проведение оплат — о том, как проводить разовые оплаты с незамедлительным списанием средств через Payment Page.
Работа с информацией об операциях — о служебных кодах, которые используются в платёжной платформе, чтобы фиксировать информацию о выполнении операций.

Повторяемые оплаты через Payment Page

Общая информация

Повторяемые оплаты через «WB Кошелёк» — это метод проведения повторных платежей со списанием по запросам или рекуррентных операций с использованием сохраненных платёжных данных. Подробная информация представлена в разделе Повторяемая оплата со списаниями по запросам. Через Payment Page доступна регистрация повторяемой оплаты, для этого со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, а также данные для регистрации повторяемой оплаты в объекте recurring, на рабочий URL EtoPlatezhi и принять оповещение о результате. В оповещении о регистрации повторяемой оплаты вы получите её идентификатор, который нужно использовать для проведения или отмены регулярной оплаты через Gate. Подробная информация об этом представлена в разделе Повторяемые оплаты через Gate.

Информация о форматах запросов и оповещений, используемых для проведения оплат методом «WB Кошелёк» через Payment Page, приведена далее в этом разделе; общая информация о работе с Payment Page API — в отдельной статье Организация взаимодействия.

Формат запросов

При формировании запросов на открытие платёжной формы для регистрации повторяемой оплаты с применением метода «WB Кошелёк» необходимо учитывать следующее:

Должен использоваться базовый минимум параметров, обязательный для любого платежа.
Дополнительно необходимо указывать номер телефона пользователя, ассоциируемый с учётной записью в сервисе «WB Кошелёк» в параметре customer_account_number.
Для регистрации повторяемой оплаты необходимо передавать признак такой регистрации в объекте recurring и пояснение к характеру оказываемых услуг в параметре payment_description.
При использовании JavaScript-библиотеки EtoPlatezhi объект recurring в таком запросе может представлять собой JSON-объект, включающий в себя параметр register со значением true. В других случаях объект recurring, как и тело запроса в целом, должен указываться в виде URL-строки, полученной из исходного JSON-объекта с помощью преобразования URL-encoding.
Для предварительного выбора метода «WB Кошелёк» необходимо указывать код этого метода в параметре force_payment_method — wildberries.
Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page (подробнее).
После указания всех целевых параметров необходимо составлять подпись (подробнее).

Таким образом, корректный запрос на открытие платёжной формы с применением метода «WB Кошелёк» должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор платежа, сумму и код валюты), идентификатор пользователя, признак регистрации повторяемой оплаты, а также подпись.

{
   "project_id": 120,
   "payment_id": "580",
   "payment_amount": 100000,
   "payment_currency": "RUB",
   "customer_id": "customer1",
   "customer_account_number": "79991234567",
   "recurring": {"register":true},
   "payment_description": "example reason",
   "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg=="
}

Рис. 8. Пример достаточного набора данных для запроса на регистрацию повторяемой оплаты

{
   "project_id": 120,
   "payment_id": "580",
   "payment_amount": 100000,
   "payment_currency": "RUB",
   "customer_id": "customer1",
   "customer_account_number": "79991234567",
   "recurring": {"register":true},
   "signature": "kUi2x9dKHAVNU0FYldOcZzUCwX6R\/ekpZhkIQg=="
}

Дополнительные материалы

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

Организация взаимодействия — о том, как организовать взаимодействие веб-сервиса с платёжной платформой через Payment Page.
Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
Проведение платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
Работа с информацией об операциях — о служебных кодах, которые используются в платёжной платформе, чтобы фиксировать информацию о выполнении операций.

Оплаты через Gate

Общая информация

Для проведения оплаты через Gate с использованием метода «WB Кошелёк» со стороны веб-сервиса необходимо:

Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL EtoPlatezhi.
Принять итоговое оповещение от платёжной платформы.

Полная схема проведения оплаты выглядит следующим образом.

Рис. 9. Проведение оплаты через Gate. Описание шагов

Пользователь на стороне веб-сервиса инициирует оплату с использованием метода «WB Кошелёк».
От веб-сервиса на заданный URL EtoPlatezhi передаётся запрос на проведение оплаты через Gate.
Запрос на проведение оплаты поступает в платёжную платформу EtoPlatezhi.
В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи.
От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности (подробнее).
В платёжной платформе выполняются дальнейшая обработка запроса (с проверкой согласованности параметров) и его отправка в сервис провайдера.
В сервисе провайдера выполняется обработка запроса на оплату.
От сервиса провайдера пользователю направляется информация для подтверждения оплаты.
Пользователь выполняет необходимые действия для оплаты.
В сервисе провайдера выполняется обработка платежа.
Пользователю отображается информация о результате оплаты.
Пользователь перенаправляется к веб-сервису.
От сервиса провайдера к платёжной платформе направляется информация о результате оплаты.
От платёжной платформы к веб-сервису направляется оповещение о результате оплаты.
На стороне веб-сервиса обеспечивается информирование пользователя о результате оплаты.

Информация о форматах запросов и оповещений, используемых для проведения оплат методом «WB Кошелёк» через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье Организация взаимодействия.

Формат запросов

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

Для инициирования каждой оплаты должен использоваться отдельный POST-запрос к конечной точке /v2/payment/wallet/wildberries/sale. Эта точка относится к группе /v2/payment/wallet/{payment_method}/sale.
В каждом запросе должны использоваться следующие объекты и параметры:
- general — объект, содержащий основные идентификационные сведения запроса:
  - project_id — идентификатор проекта, полученный от EtoPlatezhi при интеграции;,
  - payment_id — идентификатор платежа, уникальный в рамках проекта;,
  - signature — подпись запроса, составленная после указания всех целевых параметров (подробнее — в статье Работа с подписью к данным); (подробнее),
- payment — объект, содержащий сведения о платеже:
  - amount — сумма платежа в дробных единицах валюты;,
  - currency — буквенный код валюты платежа в формате ISO-4217 alpha-3;,
- customer — объект, содержащий сведения о пользователе:
  - id — идентификатор пользователя, уникальный в рамках проекта;,
  - ip_address — IP-адрес пользователя, актуальный для инициируемого платежа;,
- account — объект, содержащий сведения о счёте пользователя:
  - number — номер телефона пользователя, ассоциируемый с учётной записью в сервисе «WB Кошелёк».
Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.

Таким образом, корректный запрос на оплату с применением метода «WB Кошелёк» должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), идентификатор, IP-адрес и номер телефона пользователя, подпись, а также может содержать различные дополнительные параметры.

{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA=="
  },
  "payment": {
    "amount": 1000,
    "currency": "RUB"
  },
  "account": {
    "number": "79991234567"
  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0"
  }
}

Рис. 10. Пример достаточного набора данных для запроса на оплату

{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA=="
  },
  "payment": {
    "amount": 1000,
    "currency": "RUB"
  },
  "account": {
    "number": "79991234567"
  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0"
  }
}

Формат итоговых оповещений

Для итоговых оповещений об оплатах с применением метода «WB Кошелёк» используется типовой формат, описание которого представлено в статье Работа с оповещениями (подробнее).

В следующем примере оповещение свидетельствует о том, что в рамках проекта 129103 была проведена оплата в размере 10,00 RUB.

Рис. 11. Пример данных из оповещения о проведении оплаты

{
    "payment": {
        "date": "2025-11-13T08:34:42+0000",
        "method": "wildberries",
        "sum": {
            "amount": 1000,
            "currency": "RUB"
        },
        "id": "testwb1",
        "type": "purchase",
        "status": "success",
        "description": ""
    },
    "customer": {
        "id": "1"
    },
    "account": {
        "number": "***4471"
    },
    "project_id": 129103,
    "operation": {
        "provider": {
            "id": 18791,
            "payment_id": "a103d070-ab7628f82a8f",
            "auth_code": ""
        },
        "id": 5026717010142355,
        "type": "sale",
        "status": "success",
        "date": "2025-11-13T08:34:42+0000",
        "sum_initial": {
            "amount": 1000,
            "currency": "RUB"
        },
        "created_date": "2025-11-13T08:34:29+0000",
        "request_id": "3d55427b78f80c0da8e8-05026718",
        "sum_converted": {
            "amount": 1000,
            "currency": "RUB"
        },
        "code": "0",
        "message": "Success"
    },
    "signature": "gw3d4qL5Yu1n/YhIhpMXZHnLbnLZ/ziI0LO8TPslOfA=="
}

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

Рис. 12. Пример данных из оповещения об отклонении оплаты

{
    "payment": {
        "date": "2025-11-13T08:33:49+0000",
        "method": "wildberries",
        "sum": {
            "amount": 1000,
            "currency": "RUB"
        },
        "id": "testwb",
        "type": "purchase",
        "status": "decline",
        "description": ""
    },
    "customer": {
        "id": "1"
    },
    "account": {
        "number": "578954******5254"
    },
    "project_id": 129103,
    "operation": {
        "provider": {
            "id": 18791,
            "payment_id": "",
            "auth_code": ""
        },
        "id": 5008838010142407,
        "type": "sale",
        "status": "decline",
        "date": "2025-11-13T08:33:49+0000",
        "sum_initial": {
            "amount": 1000,
            "currency": "RUB"
        },
        "created_date": "2025-11-13T08:33:46+0000",
        "request_id": "b5ee59190f3ceae5ffee-05008839",
        "sum_converted": {
            "amount": 1000,
            "currency": "RUB"
        },
        "code": "20000",
        "message": "General decline"
    },
    "signature": "9m4ZK9fWYHIeIR/tRzo/bGP14gSQWtaiKNuEA=="
}

Дополнительные материалы

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

Организация взаимодействия — о том, как организовать взаимодействие с платёжной платформой через Gate.
Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
Проведение платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
Оплата в одну стадию — о том, как проводить разовые оплаты с незамедлительным списанием средств через Gate.
Работа с информацией об операциях — о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.

Повторяемые оплаты через Gate

Общая информация

Повторяемые оплаты через «WB Кошелёк» — это метод проведения повторных платежей со списанием по запросам или рекуррентных операций с использованием сохраненных платёжных данных. Подробная информация представлена в разделе Повторяемая оплата со списаниями по запросам.

Информация о форматах запросов, используемых для проведения оплат методом «WB Кошелёк» через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье Организация взаимодействия.

Регистрация повторяемой оплаты

Для регистрации повторяемых оплат со стороны веб-сервиса необходимо отправить запрос на оплату, содержащий требуемые параметры и подпись, а также признак регистрации повторяемой оплаты в параметре register объекта recurring со значением true, на заданный URL EtoPlatezhi и принять оповещение с информацией о результате. Если вы укажете в параметре register какое-либо другое значение, будет проведена разовая оплата, а повторяемая оплата зарегистрирована не будет.

В ответном оповещении о регистрации повторяемой оплаты содержится идентификатор повторяемой оплаты, который в дальнейшем можно использовать для проведения повторяемых оплат.

Информация о проведении оплаты через Gate с помощью метода «WB Кошелёк» представлена в разделе Оплаты через Gate.

Таким образом, корректный запрос на регистрацию повторяемой оплаты с применением метода «WB Кошелёк» должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор платежа, сумму и код валюты), идентификатор пользователя и IP-адрес пользователя, признак регистрации повторяемой оплаты, а также подпись.

 {
  "general": {
    "project_id": 208,
    "payment_id": "TEST_15427007172789",
    "signature": "DH0v2pZnkK9hwytOqrWdbltzO5GMSkzd0Iq6lM2...==",
  },
  "customer": {
    "ip_address": "192.0.2.0",
    "id": "123"
  },
  "payment": {
    "amount": 1000,
    "currency": "RUB",
    "description": "example reason"
  },
  "account": {
    "number": "79991234567"
  },
  "recurring": {
    "register": true
  }
}

Рис. 13. Пример достаточного набора данных для запроса на регистрацию повторяемой оплаты

 {
  "general": {
    "project_id": 208,
    "payment_id": "TEST_15427007172789",
    "signature": "DH0v2pZnkK9hwytOqrWdbltzO5GMSkzd0Iq6lM2...==",
  },
  "customer": {
    "ip_address": "192.0.2.0",
    "id": "123"
  },
  "payment": {
    "amount": 1000,
    "currency": "RUB",
    "description": "example reason"
  },
  "account": {
    "number": "79991234567"
  },
  "recurring": {
    "register": true
  }
}

Формат запросов на проведение повторяемой оплаты

После того, как повторяемая оплата зарегистрирована, для инициирования повторяемой оплаты, следует отправить в платёжную платформу запрос с полученным идентификатором повторяемой оплаты, который вы ранее получили в оповещении при регистрации этой повторяемой оплаты.

При работе с запросами на проведение повторяемой оплаты с применением метода «WB Кошелёк» необходимо учитывать следующее:

Для проведения каждой оплаты должен использоваться отдельный POST-запрос к конечной точке /v2/payment/wallet/wildberries/recurring. Эта конечная точка относится к группе /v2/payment/wallet/{payment_method}/recurring.
В каждом запросе должны использоваться следующие объекты и параметры:
- general — объект, содержащий основные идентификационные сведения запроса:
  - project_id — идентификатор проекта, полученный от EtoPlatezhi при интеграции;,
  - payment_id — идентификатор платежа, уникальный в рамках проекта;,
  - signature — подпись запроса, составленная после указания всех целевых параметров (подробнее — в разделе Работа с подписью к данным); (подробнее),
- payment — объект, содержащий сведения о платеже:
  - amount — сумма платежа в дробных единицах валюты;,;
  - currency — код валюты платежа в формате ISO-4217 alpha-3;,
- customer — объект, содержащий сведения о пользователе:
  - ip_address — IP-адрес пользователя, актуальный для инициируемого платежа;
- account — объект, содержащий сведения о счёте пользователя:
  - number — номер телефона пользователя, ассоциируемый с учётной записью в сервисе «WB Кошелёк»;
- recurring — объект, содержащий сведения о повторяемой оплате:
  - id — идентификатор зарегистрированной повторяемой оплаты.
Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.

Таким образом, корректный запрос на проведение повторяемой оплаты с применением метода «WB Кошелёк» должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор платежа, сумму и код валюты), IP-адрес пользователя, идентификатор зарегистрированной регулярной оплаты, а также подпись.

 {
  "general": {
    "project_id": 208,
    "payment_id": "TEST_15427007172789",
    "signature": "DH0v2pZnkK9hwytQ6bltzO5GMSkzd0Iq6lM2...==",
  },
  "customer": {
    "ip_address": "192.0.2.0"
  },
  "payment": {
    "amount": 1000,
    "currency": "RUB"
  },
  "account": {
    "number": "79991234567"
  },
  "recurring": {
    "id": 1234567890
  }
}

Рис. 14. Пример достаточного набора данных для запроса на проведение повторяемой оплаты

 {
  "general": {
    "project_id": 208,
    "payment_id": "TEST_15427007172789",
    "signature": "DH0v2pZnkK9hwytQ6bltzO5GMSkzd0Iq6lM2...==",
  },
  "customer": {
    "ip_address": "192.0.2.0"
  },
  "payment": {
    "amount": 1000,
    "currency": "RUB"
  },
  "account": {
    "number": "79991234567"
  },
  "recurring": {
    "id": 1234567890
  }
}

Дополнительные материалы

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

Организация взаимодействия — о том, как взаимодействовать с платёжной платформой через Gate.
Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
Проведение платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
Работа с информацией об операциях — о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.

Возвраты через Gate

Общая информация

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

Рис. 15. Выполнение возврата через Gate. Описание шагов

Пользователь инициирует возврат.
От веб-сервиса на заданный URL EtoPlatezhi передаётся запрос на выполнение возврата.
Запрос на выполнение возврата поступает в платёжную платформу EtoPlatezhi.
В платёжной платформе выполняется приём запроса с проверкой наличия обязательных параметров и корректной подписи.
От платёжной платформы к веб-сервису направляется ответ с информацией о получении запроса и его корректности (подробнее).
В платёжной платформе обеспечиваются дальнейшая обработка запроса (с проверкой согласованности параметров) и его отправка в сервис провайдера.
В сервисе провайдера выполняется обработка возврата.
От сервиса провайдера к платёжной платформе направляется информация о результате возврата.
От платёжной платформы к веб-сервису направляется оповещение о результате возврата.
На стороне веб-сервиса обеспечивается информирование пользователя о результате возврата.

Информация о форматах запросов и оповещений, используемых для выполнения возвратов методом «WB Кошелёк» через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье Организация взаимодействия.

Формат запросов

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

Для инициирования каждого возврата должен использоваться отдельный POST-запрос к конечной точке /v2/payment/wallet/wildberries/refund. Эта конечная точка относится к группе /v2/payment/wallet/{payment_method}/refund.
В каждом запросе должны использоваться следующие объекты и параметры:
- general — объект, содержащий основные идентификационные сведения запроса:
  - project_id — идентификатор проекта, полученный от EtoPlatezhi при интеграции;,
  - payment_id — идентификатор платежа, для которого необходимо выполнить возврат;,
  - signature — подпись запроса, составленная после указания всех целевых параметров (подробнее — в статье Работа с подписью к данным); (подробнее)),
- payment — объект, содержащий сведения о возврате:
  - description — комментарий к возврату или его описание;,
  - amount — сумма возврата в дробных единицах валюты (является обязательной при частичном возврате);,
  - currency — код валюты возврата в формате ISO-4217 alpha-3 (является обязательным при частичном возврате);,
- customer — объект, содержащий сведения о пользователе:
  - ip_address — IP-адрес пользователя, актуальный для инициируемого возврата.
Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.

Таким образом, корректный запрос на возврат с применением метода «WB Кошелёк» должен содержать идентификаторы проекта и платежа, описание возврата, IP-адрес пользователя, подпись, а также, при необходимости, код валюты и сумму возврата, а также может содержать различные дополнительные параметры.

{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA=="
  },
  "payment": {
    "description": "test refund",
    "amount": 1000,
    "currency": "RUB"
  },
  "customer": {
    "ip_address": "192.0.2.0"
  }
}

Рис. 16. Пример достаточного набора данных для запроса на возврат

{
  "general": {
    "project_id": 210,
    "payment_id": "test_payment",
    "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA=="
  },
  "payment": {
    "description": "test refund",
    "amount": 1000,
    "currency": "RUB"
  },
  "customer": {
    "ip_address": "192.0.2.0"
  }
}

Формат оповещений

Для оповещений о результатах возвратов с применением метода «WB Кошелёк» используется типовой формат, описание которого представлено в разделе Работа с оповещениями.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 129103 был выполнен возврат в размере 10,00 RUB.

Рис. 17. Пример данных из оповещения о выполнении возврата

{
    "payment": {
        "date": "2025-11-27T13:57:38+0000",
        "method": "wildberries",
        "sum": {
            "amount": 0,
            "currency": "RUB"
        },
        "id": "TEST_PAYMENT_596610",
        "type": "purchase",
        "status": "refunded",
        "description": "TEST_PAYMENT_596610"
    },
    "customer": {
        "id": "1"
    },
    "project_id": 129103,
    "operation": {
        "provider": {
            "id": 17361,
            "payment_id": "7e357cc72-4c57cb3d824b",
            "auth_code": ""
        },
        "id": 35054010177128,
        "type": "refund",
        "status": "success",
        "date": "2025-11-27T13:57:38+0000",
        "sum_initial": {
            "amount": 1000,
            "currency": "RUB"
        },
        "created_date": "2025-11-27T13:57:34+0000",
        "request_id": "5c6b1cb2338f47f239784-00035055",
        "sum_converted": {
            "amount": 1000,
            "currency": "RUB"
        },
        "code": "0",
        "message": "Success"
    },
    "signature": "byAApq7igpmeGgQGZjoonzaPgHX7PUGaBQ=="
}

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

Рис. 18. Пример данных из оповещения об отклонении возврата

{
    "payment": {
        "date": "2025-11-13T08:37:57+0000",
        "method": "wildberries",
        "sum": {
            "amount": 1000,
            "currency": "RUB"
        },
        "id": "testwb1",
        "type": "purchase",
        "status": "success",
        "description": ""
    },
    "customer": {
        "id": "1"
    },
    "account": {
        "number": "***4471"
    },
    "project_id": 129103,
    "operation": {
        "provider": {
            "id": 18791,
            "payment_id": "",
            "auth_code": ""
        },
        "id": 5026717010142359,
        "type": "refund",
        "status": "decline",
        "date": "2025-11-13T08:37:57+0000",
        "sum_initial": {
            "amount": 1000,
            "currency": "RUB"
        },
        "created_date": "2025-11-13T08:37:55+0000",
        "request_id": "3cc806ee3b7e672b5cf578-05026718",
        "sum_converted": {
            "amount": 1000,
            "currency": "RUB"
        },
        "code": "20000",
        "message": "General decline"
    },
    "signature": "3fPVj6Q+M6wyPm6AH8vN0RHnC6Q7UxQ=="
}

Дополнительные материалы

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

Организация взаимодействия — о том, как взаимодействовать с платёжной платформой через Gate.
Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
Проведение платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
Возвраты средств после оплат — о том, как выполнять возвраты через Gate.
Работа с информацией об операциях — о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.

Возвраты через Dashboard

При использовании интерфейса Dashboard можно выполнять одиночные и массовые возвраты методом «WB Кошелёк» с единичной и пакетной отправкой запросов, называемые соответственно одиночными и массовыми.

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

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

Более подробная информацияИнформация о выполнении возвратов через Dashboard представлена в отдельном разделе.

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

Для анализа информации о платежах и операциях, как в отдельности по методу «WB Кошелёк», так и в совокупности с другими методами, можно использовать:

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

С вопросами по анализу информации можно обращаться к разделам документации (Dashboard и Использование Data API) и специалистам EtoPlatezhi.