Документация

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

Процесс оплаты услуг с помощью мобильной коммерции, банковской картой или электронной валютой происходит простым способом через безопасное соединение, что делает всю операцию не только надежной и конфиденциальной, но и быстрой.
  • Покупатель выбирает товар и способ оплаты в Вашем он-лайн магазине и магазин, в свою очередь, подсчитывает сумму к оплате.
  • Сервер системы AnyPAY получает требуемую информацию о сумме и валюте для осуществления платежа.
  • При необходимости, наша система приема платежей производит титульный обмен, и Вы получаете требуемую сумму в желаемой валюте на кошелек, указанный при регистрации. После оплаты, Ваш покупатель перенаправляется на страницу с оплаченным товаром (на страницу Success URL).
CMS модули
Форма оплаты
Для инициализации оплаты, магазин должен отправить покупателя по данному адресу с передачей параметров.
Предварительно заполнив параметры (номер счета, сумма, ID магазина)

Action - https://any-pay.org/merchant
Method - POST/GET
Fields - поля передаваемые в форме, описаны в таблице ниже:

Название HTML Field Form Обязательный? Описание
ID магазина id Да ID магазина в системе
Сумма платежа summ Да Сумма к оплате
Валюта платежа currency Нет Валюта платежа по стандарту ISO 4217 (RUB, USD, EUR)
Номер счета pay_id Да Идентификатор платежа в вашей системе
Описание desc Нет Описание платежа
Email email Нет Почтовый ящик покупателя
Платёжная система curr Нет Способ оплаты платежа (смотрите список платежных систем)
Дополнительный параметр pay1 Нет Дополнительный параметр продавца
Дополнительный параметр #2 pay2 Нет Дополнительный параметр продавца
Дополнительный параметр #3 pay3 Нет Дополнительный параметр продавца
Дополнительный параметр #4 pay4 Нет Дополнительный параметр продавца
Дополнительный параметр #5 pay5 Нет Дополнительный параметр продавца

Пример:
                       <form action='https://any-pay.org/merchant' accept-charset='utf-8' method='post'>
<input type=hidden name=id value=1>
<input type=hidden name=summ value=9.9>
<input type=hidden name=currency value='RUB'>
<input type=hidden name=pay_id value=1>
<input type=hidden name=desc value='Техническая документация AnyPAY'>
<input type=hidden name=email value='example@mail.com'>
<input type=hidden name=curr value=qw>
<input type=submit value='Купить'>
</form>
Оповещение об оплате (Result URL)
После поступления платежа от ваших покупателей, наш Сервис отправляет запрос на Result URL который Вы указали в настройках сервиса.
На стороне магазина по адресу Rusult URL должен быть установлен скрипт-обработчик, который проверяет поступившие данные (сумма, номер счета, контрольная подпись).

Action - Result URL
Method - POST/GET
Fields - поля передаваемые в форме, описаны в таблице ниже:

Название HTML Field Form Описание
ID магазина id ID магазина в системе
Сумма платежа summ Сумма к оплате в рублях
Номер счета pay_id Идентификатор платежа в вашей системе
Email email Почтовый ящик покупателя
Валюта платежа curr Способ оплаты платежа (смотрите список платежных систем)
Контрольная подпись sign Контрольная сумма md5 (формирование подписи secret_key)
Дополнительный параметр pay1 Дополнительный параметр продавца
Дополнительный параметр #2 pay2 Дополнительный параметр продавца
Дополнительный параметр #3 pay3 Дополнительный параметр продавца
Дополнительный параметр #4 pay4 Дополнительный параметр продавца
Дополнительный параметр #5 pay5 Дополнительный параметр продавца

Проверка IP

Рекомендуем так же проверять IP сервера отправляющего Вам информацию, наш IP - 185.104.11.152
Пример функции:
function getIP() {
if(isset($_SERVER['HTTP_X_REAL_IP'])) return $_SERVER['HTTP_X_REAL_IP'];
   return $_SERVER['REMOTE_ADDR'];
}
if (!in_array(getIP(), array('185.104.11.152'))) {
    die("hacking attempt!");
}            


Формирование подписи secret_key

Формирование подписи производится путем склеивания параметров через ":" и создание контрольной суммы MD5. Склеиваются параметры id, summ, pay_id и секретный пароль.
$shop_id = '399'; // ID магазина
$secret_key = 'fds6gweg8dHgdKn'; // Секретный пароль
$signature = md5($shop_id.':'.$_REQUEST['summ'].':'.$_REQUEST['pay_id'].':'.$secret_key);        


Подтверждение платежа

Подтверждение платежа - данная функция предназначена для автоматического повтора запроса от нашего сервиса к Вашему Result URL.
При включении этой функции наш сервис будет повторять запрос каждую минуту в течение часа, до тех пор пока не получит ответ OK (латиница).

Пример обработчика платежей
$shop_id = '399';
$secret_key = 'fds6gweg8dHgdKn';
$signature = md5($shop_id.':'.$_REQUEST['summ'].':'.$_REQUEST['pay_id'].':'.$secret_key);  

function getIP() {
if(isset($_SERVER['HTTP_X_REAL_IP'])) return $_SERVER['HTTP_X_REAL_IP'];
   return $_SERVER['REMOTE_ADDR'];
}
if (!in_array(getIP(), array('185.104.11.152'))) {
    die("hacking attempt!");
} 

if ($signature != $_REQUEST['sign']) {
    die('ERROR_bad sign');
}

// Оплата прошла успешно, можно проводить операцию  

die('OK');   
Переадресация при успешной оплате (Success URL)
После успешного проведения платежа, Покупатель будет перенаправлен на Success URL который Вы задали в настройках сервиса.

Не используйте Success URL как скрипт-обработчик!

Action - Success URL
Method - POST/GET
Fields - поля передаваемые в форме, описаны в таблице ниже:

Название HTML Field Form Описание
Номер счета pay_id Идентификатор платежа в вашей системе
Сумма платежа summ Сумма к оплате в рублях
Дополнительный параметр pay1 Дополнительный параметр продавца
Дополнительный параметр #2 pay2 Дополнительный параметр продавца
Дополнительный параметр #3 pay3 Дополнительный параметр продавца
Дополнительный параметр #4 pay4 Дополнительный параметр продавца
Дополнительный параметр #5 pay5 Дополнительный параметр продавца
Переадресация при отказе от оплаты (Fail URL)
После НЕ успешного проведения платежа, Покупатель будет перенаправлен на Fail URL который Вы задали в настройках сервиса.

Action - Fail URL
Method - POST/GET
Fields - поля передаваемые в форме, описаны в таблице ниже:
Название HTML Field Form Описание
Номер счета pay_id Номер счета в магазине
Сумма платежа summ Сумма к оплате в рублях
Дополнительный параметр pay1 Дополнительный параметр продавца
Дополнительный параметр #2 pay2 Дополнительный параметр продавца
Дополнительный параметр #3 pay3 Дополнительный параметр продавца
Дополнительный параметр #4 pay4 Дополнительный параметр продавца
Дополнительный параметр #5 pay5 Дополнительный параметр продавца
Список платежных систем
Платежная система Значение
Webmoney wm
Qiwi qw
Яндекс.Деньги ym
Payeer payeer
Единая касса w1
Bitcoin btc
Btc-e btce
Perfect Money pm
OKpay okpay
AdvCash advcash
Paxum paxum
Exmo exmo
eCoin ecoin
Visa/MasterCard pc
Приватбанк pv
Сбербанк sb
Альфа Банк ab
Тинькофф Банк tb
Русский Стандарт Банк rs
МТС mts
Билайн beeline
Мегафон mf
Теле2 tele2
Евросеть es
Связной sz
Терминалы России term
Банковский перевод bank
CONTACT contact
Юнистрим unistream