litceysel.ru
добавить свой файл
1


МЕРЧАНТ-ИНТЕРФЕЙС для внешних магазинов с выплатой возмещения по принятым платежам на внутренний счёт в Системе и на внешний расчётный счёт организации-владельца магазина


Версия 1.13 (30 мая 2009 г.)

I. Общие положения



Описываемый мерчант-интерфейс предназначен для организации приёма платежей за ведущие электронные валюты на сайтах электронных магазинов и провайдеров услуг в онлайн- и оффлайн-режимах.


Для использования интерфейса необходимо зарегистрироваться в Платёжном терминале e-POS в качестве магазина, выбрав одну из схем выплаты возмещения по принятым платежам:

  1. перечислением на внутренний счёт в Платёжном терминале e-POS;

  2. перечислением на банковский расчётный счёт организации-владельца интернет-магазина или провайдера услуг.


В случае работы по схеме (1) возмещение в режиме онлайн зачисляется на внутренний счёт и в дальнейшем может быть использовано для оплаты услуг в рамках нашего Сервиса, а также выведено по электронным реквизитам владельца магазина, указанным при регистрации (кошелёк к Системе WebMoney Transfer, счёт RBK Money, MoneyMail RUR, WebCreds, Яндекс.Деньги).


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

II. Электронные валюты, базовые тарифы и правила расчёта комиссионного вознаграждения



В следующей таблице перечислены электронные валюты, поддерживаемые мерчант-интерфейсом, и базовый размер комиссионного вознаграждения, взимаемый Платёжным терминалом e-POS за обеспечение возможности приёма платежей.

Электронная валюта


Код валюты

Комиссия *)

WMR (WebMoney R)

WMR

3%

WMZ (WebMoney Z)

WMZ

3%

WME (WebMoney E)

WME

3%

WMU (WebMoney U)

WMU

10%

WMB (WebMoney B)

WMB

10%

WMG (WebMoney G)

WMG

5%

MoneyMail RUR (Деньги@Mail.Ru)

MMR

5%

RBK Money

RMR

5% **)

WebCreds

WCR

5%

Яндекс.Деньги

YDR

9%

Системой предоставляются три способа расчёта и взимания комиссии:


  1. увеличение суммы счёта, выставляемого магазином на величину комиссии;

  2. вычет комиссионного вознаграждения из суммы оплаченного счёта;

  3. сочетание (1) и (2).


В случае (1) владелец магазина получает возмещение в размере выставленного для оплаты счёта (например, магазином выставлен счёт на сумму 50 RUR; на счёт владельца магазина будет зачислен эквивалент 50 руб.; необходимая комиссия полностью оплачивается плательщиком).


В случае (2) размер комиссии вычитается из суммы произведённой оплаты (например, магазином выставлен счёт на сумму 50 RUR, оплата произведена плательщиком в WMR; на счёт владельца магазина будет зачислено
50 руб. – 3% = 48.54 руб.)


В случае (3) владелец магазина предварительно определяет, какую часть комиссии будет оплачивать плательщик, а какую – магазин (например, при оплате в WMR устанавливается, что счёт будет дороже для плательщика на 1%, а 2% будет покрывать магазин; при этом, если магазин выставляет счёт на 50 RUR, а плательщик оплачивает в WMR, сумма оплаты составит для плательщика эквивалент 50 руб. + 1% = 50.5 руб., а на счёт владельца магазина поступит 50 руб. – 2% = 49.02 руб.).


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


Набор принимаемых к оплате валют и размер комиссионного вознаграждения устанавливается для каждого магазина в индивидуальном порядке.

III. Описание мерчант-интерфейса



Общая схема работы мерчант-интерфейса:

  • магазин выставляет счёт на оплату (переключением на сайт Сервиса e-POS);

  • плательщик выполняет оплату счёта (обеспечивается Сервисом e-POS);
  • магазин, при необходимости, анализирует корректность произведённой оплаты по адресу, заданному в Личном кабинете (дополнительно в случае успешной оплаты осуществляется отправка электронного письма с подтверждением оплаты по адресу владельца магазина);


  • магазин уведомляется об успешной или неуспешной оплате счёта (в т.ч. отмене) возвратом на заданные страницы магазина.



1. Выставление счёта



Передача информации Сервису e-POS о выставленном счёте осуществляется POST-вызовом по адресу: http://www.e-pos.ru/ext/dopay.php


При этом должны быть корректно заданы следующие обязательные параметры:


Название

Описание

Примеры

amount

стоимость товара в рублях или долларах США равная цене, указанной на сайте

100, 100.2, 100.25

amountcurr

валюта, в которой задана стоимость товара (amount)

RUR или USD

currency

код электронной валюты, в которой производится оплата (список кодов см. в п. II)

WMR, WMZ и т.п.

number

уникальный внутренний номер заказа (целое число, большее нуля)

5412

description

текстовое описание заказа, представленное в виде URL-encoded строки


%37%31+%56%77

account

номер счёта магазина в Системе e-POS (УНП, отображаемый в Личном кабинете владельца магазина)




shoptype

тип магазина ("n” – для магазинов с выплатой возмещения на внутренний счёт; "m” – для магазинов с выплатой возмещения на р/с)

m или n

signature

цифровая подпись *)




firstname

имя плательщика *)

Иван

lastname

фамилия плательщика *)

Иванов

email

электронный адрес плательщика *)

ivan.ivan@host.com


*) Цифровая подпись формируется по следующему правилу: через символ "двоеточие" производится сцепление параметров amount, amountcurr, number, description, account, секретный ключ (указывается в Личном кабинете владельца магазина), shoptype. После этого вычисляется md5-хэш полученной строки в верхнем регистре.

В случае, если какие-либо параметры не заполнены или заполнены неверно, в данный момент выводится соответствующее сообщение.



Пример. Форма выставления счёта (PHP/HTML).



$amount = "10.23";

$amountcurr = "RUR";

$currency = "WMZ";

$number = "5412";

$description = urlencode("Тестовая оплата на $amount $amountcurr");

$account = "..."; // вместо многоточия – УНП из Личного кабинета

$shoptype = "m"; // m – для магазинов с выплатой возмещения на р/с

// n – для магазинов с выплатой возмещения

// внутренний счёт


$signature = "$amount:$amountcurr:$number:$description";

$signature = $signature.":$account:секретный ключ:$shoptype";

$signature = strtoupper(md5($signature));

?>

























2. Проверка оплаты счёта



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


Если в Личном кабинете владельца магазина заполнено поле «URL для изменения статуса платежа», после успешно произведённой оплаты осуществляется POST-вызов адреса, содержащегося в нём, с передачей следующих параметров:

Название


Описание

Примеры

amount, amountcurr, number, shoptype

содержат те же значения, что и при формировании счёта




currency

код электронной валюты, в которой была произведена оплата (список кодов см. в п. II)

WMR, WMZ и т.п.

payamount

сумма, оплаченная покупателем в данной валюте

100, 100.2, 100.25

percentplus

процент (комиссия), взимаемый Системой дополнительно к сумме счёта

2.0, 3.5

percentminus

процент (комиссия), который будет вычтен Системой из суммы счёта

2.0, 3.5

signature

цифровая подпись *)





*
) Цифровая подпись формируется по следующему правилу: через символ "двоеточие" производится сцепление параметров amount, amountcurr, number,

payamount, currency, секретный ключ (указывается в Личном кабинете владельца магазина), shoptype. После этого вычисляется md5-хэш полученной строки в верхнем регистре.



В качестве дополнительной проверки можно использовать анализ IP-адреса – все вызовы со стороны Сервиса e-POS осуществляются с адреса 90.156.158.53.


Пример. Проверка оплаты счёта (PHP).



$amount = $_POST["amount"];

$amountcurr = $_POST["amountcurr"];

$number = $_POST["number"];

$payamount = $_POST["payamount"];

$currency = $_POST["currency"];

$percentplus = $_POST["percentplus"];

$percentminus = $_POST["percentminus"];

$shoptype = $_POST["shoptype"];

$signature = $_POST["signature"];


$testsig = "$amount:$amountcurr:$number:$payamount:";

$testsig = $testsig."$currency:секретный ключ:$shoptype";

$testsig = strtoupper(md5($testsig ));


if ($signature==$testsig)

{

// Цифровая подпись корректна, счёт оплачен,

// произвести изменение статуса заказа

}

?>

3. Возврат на сервер магазина после успешной или неуспешной оплаты



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

  • в случае успешной оплаты – «URL для успешного платежа»;

  • в случае неуспешной оплаты – «URL для неуспешного платежа».


Данные поля могут содержать адрес одной и той же страницы.


Вызов осуществляется с передачей следующих GET-параметров:


Название

Описание

Примеры

amount, amountcurr, number, description


содержат те же значения, что и при формировании счёта





В случае неуспешной оплаты также передаются два дополнительных параметра:


Название

Описание

Примеры

errorcode

код ошибки

1000

errortext

текстовое сообщение об ошибке; c представлением символов в виде %XX

"платёж отменён"


Внимание! Факт перехода на страницу успешной оплаты нельзя использовать в качестве подтверждения совершённой оплаты. При необходимости получать информацию об оплате в режиме онлайн, пожалуйста, обратитесь к п. 2 («Проверка оплаты счёта»).


Пример. Обработка успешного/неуспешного платежа (PHP/HTML).



$amount = $HTTP_GET_VARS["amount"];

$amountcurr = $HTTP_GET_VARS["amountcurr"];

$number = $HTTP_GET_VARS["number"];

$description = $HTTP_GET_VARS["description"];

$errorcode = $HTTP_GET_VARS["errorcode"];

$errortext = $HTTP_GET_VARS["errortext"];

?>


Amount:


Amountcurr:


Number:

Description:



Errorcode:


Errortext:


*) ВНИМАНИЕ! Величины комиссии, приведённые в данной таблице, могут быть изменены со стороны e-POS в одностороннем порядке в случае существенной волатильности курса каждой конкретной электронной валюты. При этом в случае увеличения комиссии соответствующая сумма увеличения перекладывается на Плательщика, а в случае уменьшения комиссии – осуществляется уменьшение суммы счёта, выставляемого Плательщику. Размер комиссии с суммы оплаченного счёта (способ (2)) и в том, и в другом случае не изменяется.

**) При выставлении счёта к окончательной сумме добавляется 1 рубль, который снимается с Плательщика.

Универсальный платёжный сервис e-POS http://www.e-pos.ru