- Описание настройки платежей
Настройка параметров приема платежа выполняется на странице настройка для каждого сайта отдельно. Форму настройки можно получить нажав  на странице управления сайтами или при добавлении нового сайта.
Форма настройки содержит следующие параметры:
Параметр |
Обязательный |
Описание |
|
Название сайта | Да | Название вашего сайта показывается пользователям при осуществлении платежа.
| | Result URL | Нет | URL-адрес страницы, на которую будет отправлена форма оповещения о успешном выполнении платежа. Форма отправляется без использования веб-браузера посетителя методом POST. URL должен начинаться с http:// или https://. Если Result URL не задан, то уведомление о платеже отправляется на E-Mail. Result URL или E-Mail должен быть обязательно задан.
| | Success URL | Да | URL-адрес сайта, на который будет отправлена форма о удачном совершении платежа. Форма отправляется методом Success URL Method с использованием веб-браузера посетителя. Должен начинаться с http:// или https://
| | Success URL Method | Да | Метод, используемый для отправки формы удачного выполнения платежа. Может быть GET или POST.
| | Middle URL | Да | URL-адрес сайта, на который будет отправлен посетитель в случае выбора полуавтоматического метода оплаты. Форма отправляется методом Middle URL Method с использованием веб-браузера посетителя (форме аналогична форме успешного выполнения платежа). Должен начинаться с http:// или https://
| | Middle URL Method | Да | Метод, используемый для отправки формы выполнения платежа в полуавтоматическом режиме (ничем не отличается от формы удачного выполнения платежа). Может быть GET или POST.
| | Fail URL | Да | URL-адрес сайта, на который будет отправлена форма о неудачном совершении платежа. Форма отправляется методом Fail URL Method с использованием веб-браузера посетителя. Должен начинаться с http:// или https://
| | Fail URL Method | Да | Метод, используемый для отправки формы неудачного выполнения платежа. Может быть GET или POST.
| | E-Mail | Нет | E-Mail, на который будет отправляться уведомление о успешном выполнении платежа. Если не введено, уведомление о платеже будет отправляться только на Result URL. Result URL или E-Mail должен быть обязательно введен, иначе вы не сможете получать уведомления о платеже.
| | Разрешить изменение URL | Нет | Разрешить использовать Success URL, Middle URL и Fail URL, передаваемые в форме запроса платежа.
| | Сайт включен | Нет | Отметьте, чтобы включить прием средств для этого сайта.
| | Платежи из внешних п/с | Нет | Отметьте, чтобы включить прием средств из внешний платежных систем (в противном случае будут приниматься только внутренние переводы JetSwap). Кроме установки этой опции, вам следует внести залог для использования приема средств из внешних платежных систем.
|
- Описание алгоритма работы
Сервис JetSwap Merchant функционирует следующим образом:
- Продавец создает на своем сайте форму запроса платежа, которая отправляется покупателем на сайт JetSwap Merchant методом POST.
- Покупатель выбирает наиболее подходящий способ оплаты и направляется на платеж в выбранную платежную систему.
- В процессе оплаты покупателем сайт JetSwap Merchant получает сообщение от выбранной платежной системы об успешной оплате счета, после чего сайт JetSwap Merchant отправляет форму оповещения о платеже на Result URL.
- Если при оплате покупатель выбрал неавтоматический способ оплаты (например через банк), то он направляется на Middle URL. После обработки его платежа операторами он получает сообщение на E-mail, в котором указана ссылка на продолжение операции. После перехода по ссылке он отправляется по Success URL.
- После оплаты покупатель возвращается на сайт JetSwap Merchant, откуда переходит на сайт продавца по SuccessURL.
- Если в процессе оплаты произошла ошибка, либо покупатель отказался от совершения платежа, он возвращается на сайт продавца по Fail URL.
- HTML-формы, используемые при осуществлении платежей
Осуществление связи сайта продавца с сервисом JetSwap Merchant осуществляется путем отправки HTML-форм.
Отправляется покупателем с веб-сайта продавца для начала процесса приема платежа.
Форма должна иметь следующие параметры:
Action: http://go.jetswap.com/payment
Method: POST
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
| PAY_SITE | Да | ID сайта продавца. Можно получить на странице Управления сайтами или при нажатии на картинку  .
| | PAY_CR | Нет/при PAY_WM | Определяет сумму оплаты в кредитах системы JetSwap. Если параметр не задан, оплата в кредитах системы JetSwap невозможна. Хотя бы один из параметров PAY_CR или PAY_WM должен быть передан.
| | PAY_WM | Нет/при PAY_CR | Определяет сумму оплаты в условных единицах (долларах США). Если параметр не задан, оплата в условных единицах невозможна. Конвертируется по текущему курсу ввода средств в систему JetSwap. Хотя бы один из параметров PAY_CR или PAY_WM должен быть передан.
| | PAY_ORDER | Нет | Уникальный номер счета в системе учета продавца. Должен иметь целочисленное значение
| | PAY_DESC | Нет | Описание покупки. Может иметь не более 250 символов.
| | PAY_NAME | Нет | ФИО покупателя. Если не указано, будет запрошено в процессе оплаты сервисом JetSwap Merchant.
| | PAY_EMAIL | Нет | E-Mail покупателя. Если не указан, будет запрошен в процессе оплаты сервисом JetSwap Merchant.
| | PAY_SUCCESS | Нет | Заменяет Success URL, если это разрешено в настройках сайта.
| | PAY_SUCCESSMETHOD | Нет | Заменяет Success URL Method, если это разрешено в настройках сайта.
| | PAY_FAIL | Нет | Заменяет Fail URL, если это разрешено в настройках сайта.
| | PAY_FAILMETHOD | Нет | Заменяет Fail URL Method, если это разрешено в настройках сайта.
| | PAY_MIDDLE | Нет | Заменяет Middle URL, если это разрешено в настройках сайта.
| | PAY_MIDDLEMETHOD | Нет | Заменяет Middle URL Method, если это разрешено в настройках сайта.
| | Любые параметры, не имеющие префикса PAY_ | Нет | Количество и формат параметров определяется продавцом. Суммарное количество информации, определяемой пользователем, не должно превышать 10000 байт.
|
Пример формы запроса платежа
<form action=http://go.jetswap.com/payment method=post>
<input name=PAY_SITE value=111 type=hidden>
<input name=PAY_CR value=1000 type=hidden>
<input name=PAY_WM value=1 type=hidden>
<input name=PAY_DESC value='Payment Description' type=hidden>
<input name=PAY_ORDER value='222' type=hidden>
<input name=somefield value=somevalue type=hidden>
<input name=anotherfield value=anothervalue type=hidden>
</form>
- Форма оповещения о платеже
Отправляется в случае успешного проведения платежа на Result URL продавца и/или E-Mail. Имеет следующие параметры:
Action: Result URL или E-Mail
Method: POST
Поля, передаваемые в форме:
Параметр |
Описание |
| PAY_SITE | ID сайта продавца
| | PAY_CR | Сумма оплаты в кредитах (если была произведена оплата в кредитах).
| | PAY_WM | Сумма оплаты в условных единицах (долларах США) (если была произведена оплата в любой электронной валюте)
| | PAY_ID | Внутренний номер выписанного счета в сервисе JetSwap Merchant
| | PAY_ORDER | Номер счета в системе учета платежей продавца
| | PAY_NAME | Имя покупателя, введенное им на сайте либо переданное в форме запроса платежа продавцом.
| | PAY_EMAIL | E-Mail покупателя, введенный им на сайте либо переданный в форме запроса платежа продавцом.
| | PAY_DESC | Описание платежа, переданное сервису JetSwap Merchant продавцом.
| | PAY_TIME | Время совершения платежа в формате UNIX_TIMESTAMP
| | PAY_METHOD | Метод оплаты, выбранный покупателем. Может быть:
- 0 - кредиты системы JetSwap
- 1 - внутренний перевод средств в системе JetSwap
| | PAY_PURSE | Реквизиты покупателя, с использованием которых был оплачен счет.
| | PAY_CODE | Хеш-код, подтверждающий, что отправка формы осуществлена сервисом JetSwap Merchant. Подробнее.
| | Любые параметры, не имеющие префикса PAY_ | Количество и формат параметров определяется продавцом. Эти параметры были переданы веб-сайтом продавца при отправке формы запроса платежа.
|
Если поле E-Mail в настройках сайта задано, то аналогичная форма отправляется на E-Mail
Пример формы уведомления о платеже:
<form action=http://www.merchant_site.ru/resulturl.php method=post>
<input name=PAY_SITE value=111 type=hidden>
<input name=PAY_CR value=0 type=hidden>
<input name=PAY_WM value=5 type=hidden>
<input name=PAY_DESC value='Payment Description' type=hidden>
<input name=PAY_ORDER value='222' type=hidden>
<input name=PAY_ID value='1111' type=hidden>
<input name=PAY_TIME value='1129373557' type=hidden>
<input name=PAY_MERHOD value='1' type=hidden>
<input name=PAY_PURSE value='jetswapuserlogin' type=hidden>
<input name=PAY_NAME value='Vasya' type=hidden>
<input name=PAY_EMAIL value='vasya@vasya.ru' type=hidden>
<input name=PAY_CODE value='11b29cbd3c73s52d313ade147effa557' type=hidden>
<input name=somefield value=somevalue type=hidden>
<input name=anotherfield value=anothervalue type=hidden>
</form>
- Форма успешного выполнения платежа
Форма отправляется в случае успешного прохождения платежа через веб-браузер покупателя на Success URL продавца.
Action: Success URL
Method: Success URL Method
Поля, передаваемые в форме:
Параметр |
Описание |
| PAY_ID | Номер счета, выставленного для оплаты покупателю сервисом JetSwap Merchant
| | PAY_ORDER | Номер счета, выставленного для оплаты покупателю продавцом.
| | PAY_METHOD | Метод оплаты, выбранный пользователем.
| | Любые параметры, не имеющие префикса PAY_ | Количество и формат параметров определяется продавцом. Эти параметры были переданы веб-сайтом продавца при отправке формы запроса платежа.
|
Пример формы успешного выполнения платежа:
<form action="Success URL" method="Success URL Method">
<input type=hidden name=PAY_ID value='34623'>
<input type=hidden name=PAY_ORDER value='343'>
<input type=hidden name=PAY_METHOD value='3'>
...
<input type=hidden name=somename value=somevalue>
...
</form>
- Форма неудачного результата платежа
Отправляется через веб-браузер покупателя при возникновении ошибки на одном из шагов оплаты либо отказе от платежа покупателем. Форма имеет следующие параметры:
Action: Fail URL
Method: Fail URL Method
Поля, передаваемые в форме:
Параметр |
Описание |
| PAY_ID | Номер счета, выставленного для оплаты покупателю сервисом JetSwap Merchant
| | PAY_ORDER | Номер счета, выставленного для оплаты покупателю продавцом.
| | Любые параметры, не имеющие префикса PAY_ | Количество и формат параметров определяется продавцом. Эти параметры были переданы веб-сайтом продавца при отправке формы запроса платежа.
|
Пример формы успешного выполнения платежа:
<form action="Fail URL" method="Fail URL Method">
<input type=hidden name=PAY_ID value='34623'>
<input type=hidden name=PAY_ORDER value='343'>
...
<input type=hidden name=somename value=somevalue>
...
</form>
- Проверка информации о платеже
Важным этапом автоматического приема средств является проверка информации о платеже перед предоставлением покупателю товаров и услуг. Следует проверить:
- Сумму оплаты - покупатель мог ее изменить перед передачей формы запроса платежа.
- Контрольную подпись - переменную PAY_CODE, переданную на Result URL. PAY_CODE=md5("PAYMENT::PAY_SITE::SECRET_KEY::PAY_CR::PAY_WM::PAY_ID::PAY_ORDER::PAY_TIME::PAY_NAME::PAY_EMAIL::PAY_DESC::PAY_METHOD::PAY_PURSE")
- ID сайта - проверьте соответствие идентификатора вашего сайта с переданным в форме PAY_ID.
Пример проверки этих параметров на PHP вы можете получить, нажав на ссылку на странице Управление сайтами.
Вам следует тестировать сервис до тех пор, пока не убедитесь, что ваш сайт работает правильно! К сожалению, возможность тестирования сервиса не предусмотрена стандартными средствами, но вы можете производить внутренние платежи на ваш счет со своего аккаунта, при этом затраты будут минимальны и составят только комиссию сервиса на перевод. Переводить можно от 1 кредита.
|
