WebMoney

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

Схема работы

В проведении отдельного платежа с использованием метода WebMoney задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа ecommpay, а также сервис WebMoney.

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

* Каждый участник сервиса WebMoney имеет свой WM-аттестат — цифровое свидетельство, составленное на основании предоставленных участником персональных данных. Ограничения на максимальные суммы варьируются в зависимости от типа WM-аттестата, поэтому информацию об ограничениях следует уточнять в сервисе WebMoney.

** Базовое и предельное время определяются следующим образом:

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

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

Рис.: Оплата WebMoneyLight через Payment Page

Рис.: Оплата WebMoneyClassic через Payment Page

Рис.: Оплата WebMoneyClassic с использованием интерфейса X20 через Payment Page

Рис.: Оплата WebMoneyLight через Gate

Рис.: Оплата WebMoneyClassic через Gate

Рис.: Выплата через Gate

Рис.: Возврат через Gate

Детальные сведения о том, что необходимо делать со стороны мерчанта для проведения оплат, выплат и возвратов, а также о том, что можно использовать для анализа информации о проведённых платежах и операциях, представлены далее.

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

Вы можете подключать разные способы для проектов, за более подробной информацией обращайтесь к курирующему менеджеру ecommpay. Для любого способа оплаты через Payment Page со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате оплаты. При этом все варианты оплат можно делать предварительно выбранными (подробнее — в разделе Предварительный выбор платёжных методов). Полные схемы проведения оплат WebMoneyLight, WebMoneyClassic и с использованием интерфейса X20 представлены далее.

Информация о формате запросов и параметрах вызова Payment Page при работе с вариантами оплат метода WebMoney, а также о формате оповещений о результатах оплат приведена далее; общая информация о работе с API — в разделе Описание Payment Page API.

Формат запросов для оплат с использованием WebMoneyLight и WebMoneyClassic

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

1. Должен использоваться базовый минимум параметров — параметры, обязательные для любого платёжного метода:
   • project_id — идентификатор проекта, полученный от ecommpay при интеграции;
   • payment_id — идентификатор платежа, уникальный в рамках проекта;
   • payment_currency — валюта платежа в формате ISO-4217 alpha-3;
   • payment_amount — сумма платежа в дробных единицах валюты;
   • customer_id — идентификатор пользователя, уникальный в рамках проекта.
2. Дополнительно необходимо использовать следующие параметры:
   • payment_description — описание платежа.

     Описание платежа необходимо составлять в виде записи следующего формата: Пополнение лицевого счета №<номер счёта пользователя> на сайте <URL веб-сервиса>. Например: Пополнение лицевого счета №01234567890 на сайте https://merchant.example.ru/.

3. Для предварительного выбора метода WebMoney необходимо указывать способ проведения оплаты в параметре force_payment_method:
   • webmoney-light для оплат WebMoneyLight,
   • webmoney для оплат WebMoneyClassic.
4. Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page.
5. После определения всех параметров необходимо составить подпись (подробнее).

Таким образом, корректный запрос на открытие платёжной формы с применением метода WebMoney должен содержать идентификаторы проекта, пользователя и платежа, сумму и валюту платежа, описание платежа и подпись:

EPayWidget.run({
        payment_id: 'ECT_TEST_1534835032773', 
        payment_amount: 100,
        payment_currency: 'RUB',
        project_id: 238,
        customer_id: 'customer1',
        payment_description: 'Пополнение лицевого счета №01234567890 на сайте https://merchant.example.ru/',
        signature: "2tlMuYxLW9Yu6RETr8pdCfmi0UPE8euD+2QgJ...=="
})

Детальная информация обо всех указанных параметрах приведена в разделе Параметры вызова платёжной формы.

Формат запросов для оплат WebMoneyClassic с использованием интерфейса X20

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

1. Должен использоваться базовый минимум параметров — параметры, обязательные для любого платёжного метода:
   • project_id — идентификатор проекта, полученный от ecommpay при интеграции;
   • payment_id — идентификатор платежа, уникальный в рамках проекта;
   • payment_currency — валюта платежа в формате ISO-4217 alpha-3;
   • payment_amount — сумма платежа в дробных единицах;
   • customer_id — идентификатор пользователя, уникальный в рамках проекта.
2. Дополнительно должны использоваться следующие параметры:
   • customer_account_number — идентификатор пользователя в WebMoney (WMID, адрес электронной почты или номер телефона в формате +7XXXXXXXXXX или 7XXXXXXXXXX);
   • payment_description — описание платежа.

     Описание платежа необходимо составлять в виде записи следующего формата: Пополнение лицевого счета №<номер счёта пользователя> на сайте <URL веб-сервиса>. Например: Пополнение лицевого счета №01234567890 на сайте https://merchant.example.ru/.

3. Для предварительного выбора метода WebMoney необходимо указывать код платёжного метода webmoney в параметре force_payment_method.
4. Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page.
5. После определения всех параметров необходимо составить подпись (подробнее).

Таким образом, корректный запрос на открытие платёжной формы с применением метода WebMoney должен содержать идентификаторы проекта, пользователя и платежа, сумму и валюту платежа, описание платежа, идентификатор пользователя в сервисе WebMoney и подпись:

EPayWidget.run({
        project_id: 123456,
        payment_id: '1234123',
        customer_id: '456QWE',
        payment_amount: 1000,
        payment_currency: 'RUB',
        payment_description: 'Пополнение лицевого счета №01234567890 на сайте https://merchant.example.ru/',
        customer_account_number: '01234567890',
        signature: "rVCiAULmqzRsNiVm2I8l3ip03YdAnpY%2F%2F7dKte36gD2GNNfu%2FrAGIAhfTQ8..."
})

Детальная информация обо всех указанных параметрах приведена в разделе Параметры вызова платёжной формы.

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

Для оповещений о результатах оплат с применением метода WebMoney используется стандартный формат, описание которого представлено в разделе Оповещения.

К особенностям метода WebMoney можно отнести то, что идентификатор платежа (в сервисе WebMoney) в оповещениях о проведённом платеже передаётся всегда, но может не передаваться в оповещениях об отказе в проведении платежа. Для этого используется параметр payment_id в объекте provider. В оповещениях об отказе значение параметра payment_id может быть пустым.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 238 была успешно проведена оплата WebMoneyClassic с выставлением счёта. Платёж в размере 1,00 RUB выполнен пользователем с WM-кошелька R123456890000. Идентификатор платежа в сервисе WebMoney — 1592901328.

{
	"project_id": 238,
	"payment": {
		"id": "ECT_TEST_1534835032773",
		"type": "purchase",
		"status": "success",
		"date": "2018-08-21T07:05:53+0000",
		"method": "webmoney",
		"sum": {
			"amount": 100,
			"currency": "RUB"
		},
		"description": "ECT_TEST_1534835032773"
	},
	"account": {
		"number": "R703276019842"
	},
	"operation": {
		"id": 167000001094,
		"type": "sale",
		"status": "success",
		"date": "2018-08-21T07:05:53+0000",
		"created_date": "2018-08-21T07:05:12+0000",
		"request_id": "765fc31fbb98a4ac937bbdadb3303f1d13eead
		ec - 917 f825e85cce20981b0686599cb14b7f383d0e6 ",
		"sum_initial": {
			"amount": 100,
			"currency": "RUB"
		},
		"sum_converted": {
			"amount": 100,
			"currency": "RUB"
		},
		"provider": {
			"id": 1082,
			"payment_id": "1592901328",
			"date": "2018-08-21T10:05:51+0000",
			"auth_code": ""
		},
		"code": "0",
		"message": "Success"
	},
	"signature": "nEIk8lTBATPQXhZAqkiEzraA88Tgjx45cPP18thE/9iEkS
	lE9TS20z01H7 / 8 nvHU2Dz + Dp1goRozWpQRXmL6jA == "
}

В следующем примере оплата WebMoneyLight с перенаправлением пользователя к форме WebMoney была отклонена из-за нарушения ограничения на сумму или частоту оплаты. Идентификатор платежа в сервисе WebMoney не передан.

{
	"project_id": 238,
	"payment": {
		"id": "ECT_TEST_154477095843411111",
		"type": "purchase",
		"status": "decline",
		"date": "2018-12-14T09:41:30+0000",
		"method": "webmoney-light",
		"sum": {
			"amount": 1000000000,
			"currency": "RUB"
		},
		"description": "ECT_TEST_154477095843411111"
	},
	"operation": {
		"id": 13290000002280,
		"type": "sale",
		"status": "decline",
		"date": "2018-12-14T09:41:30+0000",
		"created_date": "2018-12-14T08:41:29+0000",
		"request_id": "a52dc11e9d57fa3a8649671e5599544fcfc50d
		0 f - ebbce425f52073d89f96c67686feefe5ab01c1fd ",
		"sum_initial": {
			"amount": 100,
			"currency": "RUB"
		},
		"sum_converted": {
			"amount": 100,
			"currency": "RUB"
		},
		"provider": {
			"id": 1083,
			"payment_id": "",
			"auth_code": ""
		},
		"code": "20101",
		"message": "Decline due to amount or frequency limit"
	},
	"signature": "ukUg6gJ6RtUc2qeXTNE+iDyEh4HdikHuMaCZ4Hju
	sN + uJA8Ze7RVztvlyWhtiXUjrL14pplG7ustFhJIJdDkvw == "
}

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

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

• Организация взаимодействия
• Работа с подписью к данным
• Модель проведения платежей
• Информация о выполнении операций

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

Проведение оплат с использованием метода WebMoney осуществляется двумя сценариями: в оплатах WebMoneyLight выполняется перенаправление пользователя к форме WebMoney для перевода средств, в оплатах WebMoneyClassic — выставление счёта пользователю в веб-сервисе мерчанта. Вы можете подключать разные сценарии для проектов, за более подробной информацией обращайтесь к курирующему менеджеру ecommpay. Для обоих вариантов оплат через Gate со стороны веб-сервиса необходимо:

1. Отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay.
2. Осуществить взаимодействие с пользователем:
   • Перенаправить пользователя к форме WebMoney для оплат WebMoneyLight.
   • Уведомить пользователя о необходимости оплатить выставленный счёт для оплат WebMoneyClassic.
3. Принять оповещение о результате оплаты.

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

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

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

При формировании запросов на оплату с применением метода WebMoney необходимо учитывать следующее:

1. Должен использоваться запрос, отправляемый методом POST:
   • /v2/payment/webmoney-light/sale для оплат WebMoneyLight;
   • /v2/payment/webmoney/sale для оплат WebMoneyClassic.
2. В запросе должны использоваться следующие объекты и параметры:
   • general — объект, содержащий основные идентификационные сведения запроса:
     • project_id — идентификатор проекта, полученный от ecommpay при интеграции;
     • payment_id — идентификатор платежа, уникальный в рамках проекта;
     • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Использование подписи к данным);
   • payment — сведения о платеже:
     • amount — сумма платежа в дробных единицах валюты,
     • currency — валюта платежа в формате ISO-4217 alpha-3;
   • customer — сведения о пользователе:
     • id — идентификатор пользователя, уникальный в рамках проекта;
   • account — сведения о идентификаторе пользователя в сервисе WebMoney:
     • number — WMID пользователя (идентификатор участника в сервисе WebMoney). Только для оплат WebMoneyClassic.
3. Дополнительно необходимо использовать следующие параметры:
   • payment — сведения о платеже:
     • description — описание платежа.

       Описание платежа необходимо составлять в виде записи следующего формата: Пополнение лицевого счета №<номер счёта пользователя> на сайте <URL веб-сервиса>. Например: Пополнение лицевого счета №01234567890 на сайте https://merchant.example.ru/.

4. Также могут использоваться любые другие параметры, указанные в спецификации.

Таким образом, при работе с методом WebMoney корректный запрос на оплату WebMoneyLight должен содержать идентификаторы проекта, пользователя и платежа, сумму и валюту платежа, описание платежа, а также подпись:

{
	"general": {
		"project_id": 238,
		"payment_id": "ECT_TEST_1534835032773",
		"signature": "W4SOe3ETaHHJ+srgZKwhVn+Zvf0N4ph6/0Z/owTLt
		9 o4Cepk7kmjlf5ql9UlsSi6zR25jGy7Ywkv2QLRRs3tmw == "
	},
       "customer": {
		"id": "customer1"
	},
       "payment": {
		"amount": 100,
		"currency": "RUB"
             "description": "Пополнение лицевого счета №01234567890 на сайте https://merchant.example.ru/",
       }
}

В следующем примере приведён корректный запрос на оплату WebMoneyClassic, содержащий идентификаторы проекта, пользователя и платежа, сумму и валюту платежа, описание платежа, WMID пользователя, а также подпись:

{
	"general": {
		"project_id": 238,
		"payment_id": "ECT_TEST_1534835032773",
		"signature": "2tlMuYxLW9Yu6RETr8pdCfmi0UPE8euD+2QgJ...=="
	},
       "customer": {
		"id": "customer1"
	},
	"payment": {
		"amount": 100,
		"currency": "RUB",
             "description": "Пополнение лицевого счета №01234567890 на сайте https://merchant.example.ru/"
	},
	"account": {
		"number": "377094062589"
	}
}

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

Для перенаправления пользователя от веб-сервиса к форме оплаты WebMoney необходимо:

1. Принять от платёжной платформы оповещение с объектом redirect_data.
2. Сформировать POST-запрос из параметров, переданных в объекте body, в кодировке x-www-form-urlencoded.
3. Осуществить перенаправление на URL, указанный в параметре url.

Далее приведён фрагмент оповещения от платёжной платформы, в котором содержатся метод запроса, параметры и URL для перенаправления.

"redirect_data": {
	"method": "POST",
	"body": {
		"LMI_PAYEE_PURSE": "R710575666925",
		"LMI_PAYMENT_AMOUNT": "1.00",
		"LMI_PAYMENT_NO": 10,
		"LMI_PAYMENT_DESC": "ECT_TEST_1534835188533",
		"LMI_SIM_MODE": 0,
		"LMI_SHOP_ID": 123456,
		"LMI_RESULT_URL": "https://site.com/apswebmoney/purchaseCallback/",
		"LMI_SUCCESS_METHOD": 1,
		"LMI_SUCCESS_URL": "https://site.com/process/complete-redirect?wsid=58oe0pnj86f8nm12p5mvqblc04",
		"LMI_FAIL_METHOD": 1,
		"LMI_FAIL_URL": "https://site.com/process/complete-redirect?wsid=58oe0pnj86f8nm12p5mvqblc04"
	},
	"encrypted": [],
	"url": "https://merchant.webmoney.ru/lmi/payment.asp?at=authtype_8"
}

Формат оповещений о результатах оплат

Для оповещений о результатах оплат с применением метода WebMoney используется стандартный формат, описание которого представлено в разделе Оповещения.

К особенностям метода WebMoney можно отнести то, что идентификатор платежа (в сервисе WebMoney) в оповещениях о проведённом платеже передаётся всегда, но может не передаваться в оповещениях об отказе в проведении платежа. Для этого используется параметр payment_id в объекте provider. В оповещениях об отказе значение параметра payment_id может быть пустым.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 238 была успешно проведена оплата WebMoneyClassic с выставлением счёта. Платёж в размере 1,00 RUB выполнен пользователем с WM-кошелька R123456890000. Идентификатор платежа в сервисе WebMoney — 1592901328.

{
	"project_id": 238,
	"payment": {
		"id": "ECT_TEST_1534835032773",
		"type": "purchase",
		"status": "success",
		"date": "2018-08-21T07:05:53+0000",
		"method": "webmoney",
		"sum": {
			"amount": 100,
			"currency": "RUB"
		},
		"description": "ECT_TEST_1534835032773"
	},
	"account": {
		"number": "R703276019842"
	},
	"operation": {
		"id": 167000001094,
		"type": "sale",
		"status": "success",
		"date": "2018-08-21T07:05:53+0000",
		"created_date": "2018-08-21T07:05:12+0000",
		"request_id": "765fc31fbb98a4ac937bbdadb3303f1d13eead
		ec - 917 f825e85cce20981b0686599cb14b7f383d0e6 ",
		"sum_initial": {
			"amount": 100,
			"currency": "RUB"
		},
		"sum_converted": {
			"amount": 100,
			"currency": "RUB"
		},
		"provider": {
			"id": 1082,
			"payment_id": "1592901328",
			"date": "2018-08-21T10:05:51+0000",
			"auth_code": ""
		},
		"code": "0",
		"message": "Success"
	},
	"signature": "nEIk8lTBATPQXhZAqkiEzraA88Tgjx45cPP18thE/9iEkS
	lE9TS20z01H7 / 8 nvHU2Dz + Dp1goRozWpQRXmL6jA == "
}

В следующем примере оплата WebMoneyLight с перенаправлением пользователя к форме WebMoney была отклонена из-за нарушения ограничения на сумму или частоту оплаты. Идентификатор платежа в сервисе WebMoney не передан.

{
	"project_id": 238,
	"payment": {
		"id": "ECT_TEST_154477095843411111",
		"type": "purchase",
		"status": "decline",
		"date": "2018-12-14T09:41:30+0000",
		"method": "webmoney-light",
		"sum": {
			"amount": 1000000000,
			"currency": "RUB"
		},
		"description": "ECT_TEST_154477095843411111"
	},
	"operation": {
		"id": 13290000002280,
		"type": "sale",
		"status": "decline",
		"date": "2018-12-14T09:41:30+0000",
		"created_date": "2018-12-14T08:41:29+0000",
		"request_id": "a52dc11e9d57fa3a8649671e5599544fcfc50d0
		f - ebbce425f52073d89f96c67686feefe5ab01c1fd ",
		"sum_initial": {
			"amount": 100,
			"currency": "RUB"
		},
		"sum_converted": {
			"amount": 100,
			"currency": "RUB"
		},
		"provider": {
			"id": 1083,
			"payment_id": "",
			"auth_code": ""
		},
		"code": "20101",
		"message": "Decline due to amount or frequency limit"
	},
	"signature": "ukUg6gJ6RtUc2qeXTNE+iDyEh4HdikHuMaCZ4HjusN+uJA8Ze7R
	VztvlyWhtiXUjrL14pplG7ustFhJIJdDkvw == "
}

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

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

• Организация взаимодействия
• Работа с подписью к данным
• Модель проведения платежей
• Информация об операциях

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

Метод WebMoney поддерживает проведение полных и частичных возвратов. Для возврата через Gate со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате возврата. Полная схема проведения возврата представлена далее.

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

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

При формировании запросов на возврат с применением метода WebMoney необходимо учитывать следующее:

1. Должны использоваться запросы к следующим конечным точкам, отправляемые методом POST:
   • /v2/payment/webmoney/refund для оплат, реализованных по сценарию WebMoneyClassic;
   • /v2/payment/webmoney-light/refund для оплат, реализованных по сценарию WebMoneyLight;
2. В запросе должны использоваться следующие объекты и параметры:
   • general — объект, содержащий основные идентификационные сведения о запросе:
     • project_id — идентификатор проекта;
     • payment_id — идентификатор платежа;
     • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Использование подписи к данным);
   • payment — объект, содержащий сведения о возврате :
     • description — комментарий или описание возврата,
     • amount — сумма возврата в дробных единицах валюты (обязательный при частичном возврате),
     • currency — валюта возврата в формате ISO-4217 alpha-3 (обязательный при частичном возврате).
3. Дополнительно могут использоваться любые другие параметры, указанные в спецификации.

Таким образом, при использовании метода WebMoney корректный запрос на возврат должен содержать идентификаторы проекта и платежа, подпись, сумму и валюту платежа.

{
	"general": {
		"project_id": 35,
		"payment_id": "Payment 12",
		"signature": "2tlMuYxLW9Yu6RETr8pdCfmi0UPE8euD+2QgJ...=="
	},
	"payment": {
		"amount": 100,
		"currency": "RUB",
             "description": "refund"
	}
}

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

Для оповещений о результатах возврата с применением метода WebMoney используется стандартный формат, описание которого представлено в разделе Оповещения.

К особенностям метода WebMoney можно отнести то, что идентификатор платежа (в сервисе WebMoney) в оповещениях о проведённом платеже передаётся всегда, но может не передаваться в оповещениях об отказе в проведении платежа. Для этого используется параметр payment_id в объекте provider. В оповещениях об отказе значение параметра payment_id может быть пустым.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 238 успешно проведён частичный возврат в размере 1,00 RUB на WM-кошелёк R703276019842. Идентификатор платежа в сервисе WebMoney — 1592975261.

{
        "project_id": 238,
        "payment": {
            "id": "ECT_TEST_1534835032773",
            "type": "purchase",
            "status": "partially refunded",
            "date": "2018-08-21T12:23:59+0000",
            "method": "webmoney",
            "sum": {
                "amount": 90,
                "currency": "RUB"
            },
            "description": "ECT_TEST_1534835032773"
        },
        "account": {
            "number": "R703276019842"
        },
        "operation": {
            "id": 167000001097,
            "type": "refund",
            "status": "success",
            "date": "2018-08-21T12:23:59+0000",
            "created_date": "2018-08-21T12:23:58+0000",
            "request_id": "ba1d13a9346e271b0c38e73be0a93b71bb91c383-4
                                514983dd65d182656477cb8d37f91ab94fd43f9",
            "sum_initial": {
                "amount": 10,
                "currency": "RUB"
            },
            "sum_converted": {
                "amount": 10,
                "currency": "RUB"
            },
            "provider": {
                "id": 1082,
                "payment_id": "1592975261",
                "auth_code": ""
            },
            "code": "0",
            "message": "Success"
        },
        "signature": "n/KY3iKZpYObSsUj76BsSElFHi8DRlc1I3SwV
                    5zwuI5kGh/xy4UktZwdhtUWTZPJUnVyYAuURR2d9JWiQ9QJjQ=="
    }

В следующем примере возврат был отклонён. Идентификатор платежа в сервисе WebMoney не передан.

{
	"project_id": 238,
	"payment": {
		"id": "ECT_TEST_1534835032773",
		"type": "purchase",
		"status": "success",
		"date": "2018-08-21T07:05:53+0000",
		"method": "webmoney",
		"sum": {
			"amount": 100,
			"currency": "RUB"
		},
		"description": "ECT_TEST_1534835032773"
	},
	"account": {
		"number": "R703276019842"
	},
	"errors": [{
		"code": "100",
		"message": "General decline",
		"description": "Gate. Operation was declined. General Gate error"
	}],
	"operation": {
		"id": 167000001095,
		"type": "refund",
		"status": "decline",
		"date": "2018-08-21T07:52:00+0000",
		"created_date": "2018-08-21T07:51:59+0000",
		"request_id": "c1bf7b7f8a73e7564142335cb4abf36a962414
		fe - 6 b28fc600d4eaae0da576cc0629fc12881023ac9 ",
		"sum_initial": {
			"amount": 100,
			"currency": "RUB"
		},
		"sum_converted": {
			"amount": 100,
			"currency": "RUB"
		},
		"provider": {
			"id": 1082,
			"payment_id": ""
		},
		"code": "100",
		"message": "General decline"
	},
	"signature": "GWffIaYEV93mpHO3KtP9mn4HDITfGFx4Fcu/4sr7H
	5 jxGGvJSnG6Y9hmZlaVpdZBAl9AeRHkIkF / RlSZ3R71Vw == "
}

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

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

• Организация взаимодействия
• Работа с подписью к данным
• Модель проведения платежей
• Информация об операциях

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

Для выплаты через Gate с использованием метода WebMoney со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате выплаты. Полная схема проведения выплаты представлена далее.

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

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

При работе с методом WebMoney можно защитить выплату кодом протекции, предназначенным для подтверждения платежа со стороны пользователя. При формировании запросов на выплату необходимо учитывать следующее:

1. Должен использоваться запрос /v2/payment/webmoney/payout, отправляемый методом POST.
2. В запросе должны использоваться следующие объекты и параметры:
   • general — объект, содержащий основные идентификационные сведения запроса:
     • project_id — идентификатор проекта, полученный от ecommpay при интеграции;
     • payment_id — идентификатор платежа, уникальный в рамках проекта;
     • signature — подпись запроса, составленная после указания целевых параметров (подробнее — в разделе Использование подписи к данным);
   • customer — объект, содержащий сведения о пользователе:
     • id — идентификатор,
     • ip_address — IP-адрес;
   • account — объект, содержащий сведения о WM-кошельке пользователя:
     • number — номер WM-кошелька пользователя;
   • payment — объект, содержащий сведения о платеже:
     • amount — сумма платежа в дробных единицах валюты;
     • currency — валюта платежа в формате ISO-4217 alpha-3. Валюта выплаты должна соответствовать валюте кошелька пользователя;
3. Дополнительно необходимо использовать следующие параметры:
   • payment — сведения о платеже:
     • description — описание платежа.

       Описание платежа необходимо составлять в виде записи следующего формата: Вывод средств с лицевого счета №<номер счёта пользователя> на сайте <URL веб-сервиса>. Например: Вывод средств с лицевого счета №01234567890 на сайте https://merchant.example.ru/.

4. Для выплат с протекцией необходимо передавать код и срок протекции.

   Переведённые средства не доступны пользователю без подтверждения платежа с помощью кода, получаемого со стороны веб-сервиса. Если в течение указанного срока пользователь не вводит верный код, средства возвращаются на WM-кошелёк мерчанта, а платёж переходит в статус decline.

   Заданные на стороне веб-сервиса код и срок (в сутках от 1 до 35) протекции необходимо передать в параметрах protection_code и protection_period объекта account, а также самостоятельно сообщить пользователю код протекции.

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

Таким образом, при использовании метода WebMoney корректный запрос на выплату без протекции должен содержать идентификаторы проекта, пользователя и платежа, IP-адрес и WMID пользователя, сумму и валюту платежа, описание платежа, а также подпись:

{
	"general": {
		"project_id": 238,
		"payment_id": "WM-payout-002",
		"signature": "2tlMuYxLW9Yu6RETr8pdCfmi0UPE8euD+2QgJ...=="
	},
	"customer": {
		"id": ABC1234,
		"ip_address": "1.2.3.4"
	},
	"account": {
		"number": "R703276019842"
	},
	"payment": {
		"amount": 100,
		"currency": "RUB",
             "description": "Вывод средств с лицевого счета №01234567890 на сайте https://merchant.example.ru/"
	}
}

При использовании метода WebMoney корректный запрос на выплату с протекцией должен содержать идентификаторы проекта, пользователя и платежа, IP-адрес и WMID пользователя, сумму и валюту платежа, описание платежа, код и период протекции, а также подпись:

{
	"general": {
		"project_id": 238,
		"payment_id": "WM-payout-001",
		"signature": "JeY56160AFuozhpEStl7TtsdcY4A0IlcyWuK
		XTfDH1Eam8bHffOMdED / gOMl2ocIuZVqyF82pt7xb5WWVENFDQ == "
	},
	"customer": {
		"id": "ABC1234",
		"ip_address": "1.2.3.4"
	},
	"account": {
		"number": "R703276019842"
	},
	"payment": {
		"amount": 100,
		"currency": "RUB",
		"protection_code": "code1",
		"protection_period": 1,
             "description": "Вывод средств с лицевого счета №01234567890 на сайте https://merchant.example.ru/"
	}
}

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

Для оповещений о результатах выплат с применением метода WebMoney используется стандартный формат, описание которого представлено в разделе Оповещения.

К особенностям метода WebMoney можно отнести то, что идентификатор платежа (в сервисе WebMoney) в оповещениях о проведённом платеже передаётся всегда, но может не передаваться в оповещениях об отказе в проведении платежа. Для этого используется параметр payment_id в объекте provider. В оповещениях об отказе значение параметра payment_id может быть пустым.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 238 для пользователя ABC1234 была успешно проведена выплата в размере 1,00 RUB на рублевый кошелёк, прикреплённый к WMID 377094062589. Идентификатор платежа в сервисе WebMoney — 1593230877.

{
	"project_id": 238,
	"payment": {
		"id": "WM-payout-121",
		"type": "payout",
		"status": "success",
		"date": "2018-08-22T13:35:41+0000",
		"method": "webmoney",
		"sum": {
			"amount": 100,
			"currency": "RUB"
		},
		"description": "test payout without protection"
	},
	"account": {
		"number": "377094062589"
	},
	"customer": {
		"id": "ABC1234"
	},
	"operation": {
		"id": 16442000001089,
		"type": "payout",
		"status": "success",
		"date": "2018-08-22T13:35:41+0000",
		"created_date": "2018-08-22T13:35:39+0000",
		"request_id": "511bba243a2ef3dcc7865dedc43ea8ff2c6352
		e4 - 0369 a4524fef9b41a71e7c97d23077dec8198cae ",
		"sum_initial": {
			"amount": 100,
			"currency": "RUB"
		},
		"sum_converted": {
			"amount": 100,
			"currency": "RUB"
		},
		"provider": {
			"id": 1082,
			"payment_id": "1593230877",
			"date": "2018-08-22T16:35:39+0000",
			"auth_code": ""
		},
		"code": "0",
		"message": "Success"
	},
	"signature": "uoFrPY6tVRwG9CrOivMaVtOPgLW67cZF/PhGifg1QP
	GYh0Nc3QI / SdCW4fOfAH2uJt + BymQVkYQBkkwZ / aVFfg == "
}

В следующем примере выплата была отклонена, но идентификатор платежа в сервисе WebMoney передан: 1594601738.

{
	"project_id": 238,
	"payment": {
		"id": "WM-payout-001=35",
		"type": "payout",
		"status": "decline",
		"date": "2018-08-29T21:33:22+0000",
		"method": "webmoney",
		"sum": {
			"amount": 10000,
			"currency": "RUB"
		},
		"description": "test payout with protection"
	},
	"account": {
		"number": "377094062589"
	},
	"customer": {
		"id": "cust0007"
	},
	"operation": {
		"id": 9744000001160,
		"type": "payout",
		"status": "decline",
		"date": "2018-08-29T21:33:22+0000",
		"created_date": "2018-08-28T14:33:20+0000",
		"request_id": "3fc02ef403a21531775fa44440a5f6f3372c58
		db - 508e54208 ae977d3bebf875ac3cd2afbf87764bd ",
		"sum_initial": {
			"amount": 10000,
			"currency": "RUB"
		},
		"sum_converted": {
			"amount": 10000,
			"currency": "RUB"
		},
		"provider": {
			"id": 1082,
			"payment_id": "1594601738",
			"date": "2018-08-28T17:33:20+0000",
			"auth_code": ""
		},
		"code": "20101",
		"message": "Decline due to amount or frequency limit"
	},
	"signature": "/hv7zLOiJapRXiDfdDMW6Vlilv13SALr/ZpnIEQi
	QltHxl09271AQI89IfVG5z / y9 + WAHwsBHuPxzjf2CvAx + w == "
}

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

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

• Организация взаимодействия
• Работа с подписью к данным
• Модель проведения платежей
• Информация об операциях

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

Для метода WebMoney доступно тестирование оплат WebMoneyLight и WebMoneyClassic через Payment Page и Gate, оплат WebMoneyClassic с использованием интерфейса X20 через Payment Page, выплат WebMoneyClassic через Gate, а также возвратов WebMoneyLight через Gate.

Тестирование может выполняться в рамках тестового проекта, и для подключения и отключения этой функциональности необходимо обращаться к специалистам технической поддержки ecommpay support@ecommpay.com.

При проведении тестовых платежей следует учитывать, что в запросах должен указываться идентификатор тестового проекта, в качестве валюты может использоваться любая из поддерживаемых: WMB(BYN), WME (EUR), WMK (KZT), WMR(RUB), WMU(VND), WMV(UAH), WMZ(USD) (доступность каждой валюты настраивается отдельно по запросу), а интерфейсы эмулятора платёжных форм Payment Page и WebMoney могут отличаться от рабочих.

Статусы тестовых платежей

При тестировании оплат и выплат их итоговый статус определяется исходя из суммы, указанной в запросе:

• decline — при указании суммы 40000 или 40400,
• success — при указании любой другой суммы.

При тестировании возвратов их итоговые статусы определяются исходя из сумм, указанных в запросах:

• decline — при указании суммы 50000 или 50500,
• success — при указании любой другой суммы.

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

Для проведения тестовой оплаты WebMoneyLight через Payment Page необходимо:

1. Отправить в платёжную платформу корректный тестовый запрос на открытие Payment Page.
2. Если в запросе не был указан метод webmoney-light — выбрать метод WebMoneyLight на странице эмулятора.
3. Перейти по полученному URL и в зависимости от указанной в запросе суммы щелкнуть Success или Decline .
4. Принять оповещение с информацией о результате оплаты.

Для проведения тестовой оплаты WebMoneyClassic через Payment Page необходимо:

1. Отправить в платёжную платформу корректный тестовый запрос на открытие Payment Page.
2. Если в запросе не был указан метод webmoney — выбрать метод WebMoneyClassic на странице эмулятора.
3. Указать в поле ввода произвольный номер кошелька WMID и выбрать валюту кошелька.
4. Принять оповещение с информацией о результате оплаты.

Для проведения тестовой оплаты WebMoneyClassic с использованием интерфейса X20 через Payment Page необходимо:

1. Отправить в платёжную платформу корректный тестовый запрос на открытие Payment Page.
2. Если в запросе не был указан метод webmoney — выбрать метод WebMoneyClassic на странице эмулятора.
3. Указать произвольный способ идентификации, произвольное значение идентификатора и произвольный способ подтверждения.
4. Если был выбран способ подтверждения SMS, то указать произвольный код подтверждения.
5. Принять оповещение с информацией о результате оплаты.

Подробная информация о проведении оплат с использованием метода WebMoney через Payment Page представлена в пункте Оплаты через Payment Page.

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

Для проведения тестовой оплаты WebMoneyLight через Gate необходимо:

1. Отправить в платёжную платформу корректный тестовый запрос на оплату.
2. Принять оповещение с данными для перенаправления.
3. Перейти по полученному URL и на странице эмулятора в зависимости от указанной в запросе суммы щелкнуть Success или Decline .
4. Принять оповещение с информацией о результате оплаты.

Для проведения тестовой оплаты WebMoneyClassic через Gate необходимо:

1. Отправить в платёжную платформу корректный тестовый запрос на оплату.
2. Принять оповещение с информацией о результате оплаты.

Подробная информация о проведении оплат с использованием метода WebMoney через Gate представлена в пункте Оплаты через Gate.

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

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

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

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

Следует учитывать, что выполнение тестового возврата на полную или частичную сумму возможно только в течение суток после проведения оплаты. Подробная информация о проведении возвратов с использованием метода WebMoney через Gate представлена в пункте Возвраты через Gate.

Как и при работе с другими платёжными методами, которые предоставляет ecommpay, при использовании метода WebMoney доступны разные способы анализа информации о платежах и операциях с применением этого метода — как в отдельности, так и в совокупности с другими методами.

Всю необходимую информацию можно получать и анализировать средствами Dashboard, в том числе с помощью аналитических панелей на вкладке Analytics.

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

• Dashboard позволяет выгружать данные в форматах CSV и XLS с помощью инструментов на вкладке Платежи. При этом можно выполнять разовые выгрузки информации на локальный компьютер и задействовать периодическую выгрузку и отправку информации на заданные адреса электронной почты.
• Data API позволяет получать информацию в формате JSON и отправлять ее на заданный URL — для этого применяются запросы /operations/get.

С любыми вопросами о возможностях анализа можно обращаться в службу технической поддержки ecommpay.