ДеньгиOnline

2017-01-16 19:48:04

Выставление счета при упрощенной интеграции

Выставление счета при упрощенной интеграции 

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

 

Обратите внимание!
Упрощенная интеграция позволяет значительно сократить затраты на установку и поддержку комплекса ПО, взаимодействующего с процессинговым решением ДОЛ.
В то же время проект должен осознавать, что упрощенная интеграция не является безопасным решением — вся ответственность по проверке входящих платежей на предмет соответствия их параметров (особенно — суммы платежа и исходных параметров товара, приобретаемого пользователем) лежит на проекте.

 

Исходная ссылка, на которую отправляются запросы: https://paymentgateway.ru/pgw/. Могут передаваться следующие параметры (все параметры передаются в get, кодировка utf-8):
Параметр Описание Формат данных Обязательность
project идентификатор Проекта в Системе, выданный техническим специалистом Системы после завершения технического подключения int (например, 294) Обязательный параметр
paymentCurrency валюта платежа (передается в соответствии с ISO 4217, трёхбуквенный код)

string (данные передаются в соответствии с ISO 4217)

Возможные значения: USD, RUB, EUR, UAH

Обязательный параметр.

Базовое значение — RUB.

nickname идентификатор пользователя или заказа string (например, test) Если не передан, данные будут запрошены у Пользователя.
amount сумма платежа decimal (например,10.00) Если не передан, данные будут запрошены у Пользователя.
order_id идентификатор платежа/заказа в учётной системе Проекта string (например,asd1234) Опциональный параметр
nick_extra дополнительные сведения, необходимые для совершения платежа или сбора статистики на стороне Проекта (до 500 символов) string (например,Природой здесь нам суждено В Европу прорубить окно) Опциональный параметр
comment комментарий к платежу string (например, Над омраченным Петроградом Дышал ноябрь осенним хладом. Опциональный параметр
return_url_success URL возврата пользователя на сайт проекта в случае успешно выставленного/оплаченного счета http://dengionline.com/success Опциональный параметр
return_url_fail URL возврата пользователя на сайт проекта в случае неуспешно выставленного/оплаченного счета http://dengionline.com/fail Опциональный параметр

Примеры ссылок, сгенерированных на основании различных наборов параметров:

Пример формы, передающей параметры платежа:

<form action="https://paymentgateway.ru/pgw/" id="pgw_payments" method="get">
<input id="project" name="project" type="hidden" value="294" />
<!-- Идентификатор проекта, выдается при интеграции -->
<input id="paymentCurrency" name="paymentCurrency" type="hidden" value="RUB" />
Аккаунт:
<input id="nickname" name="nickname" type="text" value="test_nickname" />
Сумма: 
<input id="amount" name="amount" type="text" value="100" />
<input id="pgw_payment_submit" name="submit" type="submit" value="Оплатить" />
</form>

Общий вид страницы платежа

Страница состоит из нескольких блоков: 

  • Логотип проекта (передается Проектом в процессе интеграции в формате png с прозрачным фоном, размер от 200х200)
  • Информация о платеже (получатель, сумма, номер заказа)
  • Топовые платежные системы (список ранжируется автоматически: в верхнюю часть страницы выводится ТОП платежных систем – максимум 10 – с максимальным оборотом по этому проекту за последние 2 недели)
  • Полный список доступных для оплаты через страницу платежных систем

Запрос недостающих параметров

В случае, если проектом были переданы не все обязательные параметры, они будут запрошены у пользователя:


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