Crypto
Обзор
Введение
Crypto — метод, позволяющий проводить платежи в долларах США и евро с использованием криптокошелька в разных странах. Для этого метода в платёжной платформе ecommpay поддерживаются оплаты и выплаты.
В этой статье представлена информация о работе с методом Crypto: обзорный раздел с общими сведениями и последующие разделы с информацией о действиях, необходимых со стороны мерчанта для решения разных задач.
Характеристика
Тип платёжного метода | платежи с использованием криптовалют |
---|---|
Платёжные инструменты | криптокошельки |
Регионы использования | все страны, кроме DZ, BO, EC, NP, PK, KH, IR, KP * |
Валюты платежей | EUR, USD |
Конвертация валют | на стороне ecommpay * |
Разовые оплаты | + |
Повторяемые оплаты | – |
Полные возвраты | – |
Частичные возвраты | – |
Выплаты | + |
Опротестования | – |
Особенности |
|
Организация и стоимость подключения | по согласованию с курирующим менеджером ecommpay |
* Информацию следует уточнять у курирующего менеджера ecommpay.
Схема работы
В проведении отдельного платежа с использованием метода Crypto задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа ecommpay, а также технические средства сервиса провайдера.
Основные операции
Для проведения платежей и выполнения операций с использованием метода Crypto могут применяться различные интерфейсы платёжной платформы. Так, оплаты могут проводиться через Payment Page и Dashboard (с применением платёжных ссылок), а выплаты — через Gate. При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения.
При работе с методом Crypto, независимо от используемых интерфейсов, актуальны следующие свойства и ограничения.
Суммы ¹ | Время ² | |||
---|---|---|---|---|
минимум | максимум | базовое | предельное | |
Оплаты | * | * | * | * |
Выплаты | 45,00 EUR | – | – | – |
- Информацию следует уточнять у курирующего менеджера ecommpay.
- Базовое и предельное время определяются следующим образом:
- Базовое время — среднее расчётное время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Это время определяется для условий штатной работы всех технических средств и каналов связи, а также типичных действий со стороны пользователя (там, где они необходимы). Базовое время рекомендуется использовать для реагирования на отсутствие оповещений о результате платежа и выполнения опроса состояния платежа (подробнее).
- Предельное время — максимально допустимое время проведения платежа от момента его инициирования на стороне платёжной платформы до момента отправки инициатору оповещения о результате. Если платёж не был проведён или отклонён за это время, он автоматически переводится в статус
decline
. Для индивидуальной настройки предельного времени следует обращаться к специалистам технической поддержки ecommpay.
Сценарии использования
Проведение оплат с использованием метода Crypto осуществляется с перенаправлением пользователей к сервису Crypto, проведение выплат — с уведомлением пользователей через веб-сервис мерчанта.
Оплаты через Payment Page
Общая информация
Для проведения оплаты через Payment Page с использованием метода Crypto со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате. Полная схема проведения оплаты выглядит следующим образом.
Информация о форматах запросов и оповещений, используемых для проведения оплат методом Crypto через Payment Page, приведена далее в этом разделе; общая информация о работе с Payment Page API — в отдельной статье Организация взаимодействия.
Формат запросов
При формировании запросов на открытие платёжной формы с применением метода Crypto необходимо учитывать следующее:
- Должен использоваться базовый минимум параметров, обязательный для любого платежа:
project_id
— идентификатор проекта, полученный от ecommpay при интеграции;payment_id
— идентификатор платежа, уникальный в рамках проекта;payment_currency
— код валюты платежа в формате ISO-4217 alpha-3;payment_amount
— сумма платежа в дробных единицах валюты;customer_id
— идентификатор пользователя в рамках проекта.
- Должен использоваться базовый минимум параметров:
project_id
,payment_id
,payment_currency
,payment_amount
,customer_id
. - Дополнительно могут потребоваться передаваться следующие данные пользователя, которые необходимо указать на Payment Page. Необходимость использования этих параметров следует уточнять у курирующего менеджера ecommpay.
customer_first_name
— имя пользователя;customer_last_name
— фамилия пользователя;customer_email
— адрес электронной почты пользователя;customer_country
—код страны пользователя в формате ISO 3166-1 alpha-2;customer_day_of_birth
— дата рождения пользователя в формате ДД-ММ-ГГГГ.
Если какие-либо из этих параметров отсутствуют в запросе, в платёжной форме могут отображаться поля для ввода пользователем недостающих значений (подробнее — в разделе Дополнение информации о платежах).
- Для предварительного выбора метода Crypto необходимо указывать код платёжного метода
crypto
в параметреforce_payment_method
. Также в этом случае, в зависимости от провайдера, обрабатывающего платёж, можно задать криптовалюту (вследствие пользователь не сможет поменять заданную криптовалюту при оплате). Для этого в запросе необходимо указать код (тикер) криптовалюты в параметреpayment_methods_options
. Значение этого параметра имеет формат"{"currency_id":["..."]}"
, где...
это символ одной из доступных криптовалют. Пример корректного значения —"{"currency_id":["BTC"]}"
. За информацией о возможности задания криптовалюты следует обращаться к курирующему менеджеру ecommpay. - В некоторых случаях (в зависимости от провайдера, обрабатывающего платёж), если в запросе указывается адрес электронной почты пользователя в параметре
customer_email
, то после проведённого или отклонённого платежа со стороны платёжной платформы на этот адрес отправляется письмо с информацией о результате оплаты. - Дополнительно могут использоваться любые другие параметры из числа доступных для работы с Payment Page (подробнее).
- После указания всех целевых параметров необходимо составлять подпись (подробнее).
Таким образом, корректный запрос на открытие платёжной формы с применением метода Crypto должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), информацию о пользователе и подпись.
Формат оповещений
Для оповещений о результатах оплат с применением метода Crypto используется типовой формат, описание которого представлено в статье Оповещения.
При успешной оплате через некоторых провайдеров, в оповещении в объекте crypto
содержатся следующие параметры с дополнительной информацией о платеже:
blockchain_url
— ссылка для отслеживания информации об оплате в стороннем сервисе;exchange_rate
— курс криптовалюты к фиатной валюте, который использовался при платеже;address
— крипто-адрес, используемый пользователем для проведения оплаты;crypto_currency
— символ криптовалюты, используемой для оплаты.
В следующем примере оповещение свидетельствует о том, что в рамках проекта 398
была успешно проведена оплата в размере 15,00 EUR
.
В следующем примере оповещение свидетельствует об отклонённой оплате.
Дополнительные материалы
Для организации работы с оплатами через Payment Page также могут быть полезны следующие материалы:
- Организация взаимодействия — о том, как организовать взаимодействие веб-сервиса с платёжной платформой через Payment Page.
- Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
- Модель проведения платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
- Разовая оплата в одну стадию — о том, как проводить разовые оплаты через Payment Page.
- Информация о выполнении операций — о служебных кодах, которые используются в платёжной платформе, чтобы фиксировать информацию о выполнении операций.
Выплаты через Gate
Общая информация
Для проведения выплаты через Gate с использованием метода Crypto со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате. Полная схема проведения выплаты выглядит следующим образом.
Информация о форматах запросов и оповещений, используемых для проведения выплат методом Crypto через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье Организация взаимодействия.
Формат запросов
При работе с запросами на выплаты с применением метода Crypto необходимо учитывать следующее:
- Для инициирования каждой выплаты должен использоваться отдельный POST-запрос к конечной точке /v2/payment/crypto/payout.
- В каждом запросе должны использоваться следующие объекты и параметры:
general
— объект, содержащий основные идентификационные сведения запроса:project_id
— идентификатор проекта, полученный от ecommpay при интеграции;,payment_id
— идентификатор платежа, уникальный в рамках проекта;,signature
— подпись запроса, составленная после указания всех целевых параметров (подробнее — в разделе Работа с подписью к данным); (подробнее),
payment
— объект, содержащий сведения о платеже:amount
— сумма выплаты в дробных единицах валюты;,currency
— код валюты платежа в формате ISO-4217 alpha-3;,
customer
— объект, содержащий сведения о пользователе:id
— идентификатор пользователя, уникальный в рамках проекта;,ip_address
— IP-адрес пользователя, актуальный для инициируемой выплаты;,first_name
— имя пользователя;,last_name
— фамилия пользователя;,email
— электронная почта пользователя;,country
— код страны пользователя в формате ISO 3166-1 alpha-2;,
account
— объект, содержащий сведения о счёте пользователя:wallet_address
— адрес электронного кошелька, поддерживающего криптовалюты;crypto_currency
— символ криптовалюты, поддерживаемой электронным кошельком, например:BTC
,BCH
,USDT
,ETH
(информацию о поддерживаемых криптовалютах следует уточнять у курирующего менеджера ecommpay).
- Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.
Таким образом, корректный запрос на выплату с применением метода Crypto должен содержать идентификатор проекта, базовые сведения о платеже (его идентификатор, сумму и код валюты), информацию о пользователе и счёте, а также подпись.
Формат оповещений
Для оповещений о результатах выплат с применением метода Crypto используется типовой формат, описание которого представлено в разделе Оповещения.
В следующем примере оповещение свидетельствует о том, что в рамках проекта 398
была успешно проведена выплата в размере 50,00 EUR
.
В следующем примере оповещение свидетельствует об отклонённой выплате.
Дополнительные материалы
Для организации работы с выплатами через Gate также могут быть полезны следующие материалы:
- Организация взаимодействия — о том, как взаимодействовать с платёжной платформой через Gate.
- Работа с подписью к данным — о порядке создания и проверки подписи в программных запросах и оповещениях при взаимодействии с платёжной платформой.
- Модель проведения платежей — о типах, схемах проведения и возможных статусах поддерживаемых платежей и операций.
- Выплаты — о том, как проводить выплаты через Gate.
- Информация об операциях — о служебных кодах, используемых в платёжной платформе для фиксации информации о выполнении операций.
Анализ результатов проведения платежей
Для анализа информации о платежах и операциях, как в отдельности по методу Crypto, так и в совокупности с другими методами, можно использовать:
- инструментарий интерфейса Dashboard, с различными реестрами и аналитическими панелями;,
- отчёты в формате CSV, выгружаемые (как разово, так и периодически) через раздел Отчёты интерфейса Dashboard;,
- данные в формате JSON, получаемые по программным запросам через интерфейс Data API.
С вопросами по анализу информации можно обращаться к разделам документации (Dashboard и Использование Data API) и специалистам ecommpay.