ДеньгиOnline

2017-07-29 03:29:05

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

Упрощённая техническая интеграция предлагает взаимодействие с Системой по упрощённому протоколу: 

  1. На сайте Проекта размещается кнопка оплаты со ссылкой на страницу Проекта на сайте Системы (Платежная страница). 
  2. Нажав кнопку "Оплатить", Пользователь автоматически переходит на Платежную страницу, расположенную на сайте Системы, где самостоятельно выбирает метод оплаты и вводит сумму платежа или идентификатор пользователя, если те не были переданы.

Параметры запроса от Проекта в Систему

Кнопка "Оплатить" отправляет запрос на адрес https://paymentgateway.ru/pgw/ 

Для передачи параметров запроса используются следующие правила:

  • метод передачи - GET;
  • формат - XML;
  • кодировка - UTF-8.
Параметр Описание параметра Формат параметра Обязательность параметра
project Идентификатор Проекта в Системе, выданный техническим специалистом Системы после завершения интеграции

int

(например, 294)

Да
paymentCurrency

Валюта платежа.

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

string

ISO 4217, alfa-3

Да

 

nickname

Идентификатор пользователя или заказа

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

string(255)

(например, test)

 

 

Если не передан, данные будут запрошены у Пользователя

amount Сумма платежа

decimal(10.2), разделитель - точка

(например, 10.00)

order_id Идентификатор платежа/заказа в учётной системе Проекта

string(64)

(например, asd1234)

Нет
nick_extra Дополнительные сведения, необходимые для совершения платежа или сбора статистики на стороне Проекта (до 500 символов)

string(500)

(например, 12345)

Нет
comment Комментарий к платежу

string(500)

(например, He pays the whole, and yet am I not free)

Нет
return_url_success URL возврата пользователя на сайт проекта в случае успешно выставленного/оплаченного счета http://dengionline.com/success Нет
return_url_fail URL возврата пользователя на сайт проекта в случае неуспешно выставленного/оплаченного счета http://dengionline.com/fail Нет

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

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

<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 недели);
  • Полный список платежных систем доступных для оплаты через Платежную страницу.

 

Если Проектом были переданы не все необходимые для проведения платежа параметры, они будут запрошены у Пользователя. При этом данные будут приняты Системой так, как будто бы их передал Проект.