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

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

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

Action - https://any-pay.org/merchant
Method - POST/GET
Fields - поля передаваемые в форме, описаны в таблице ниже:
Название HTML Field Form Обязательный? Описание
ID магазина id Да ID магазина в системе
Сумма платежа summ Да Сумма к оплате
Номер счета 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=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 Номер счета в магазине
Описание desc Описание платежа
Email email Почтовый ящик покупателя
Контрольная подпись pass Контрольная сумма md5 (формирование подписи secret_key)
Валюта платежа curr Способ оплаты платежа (смотрите список платежных систем)
Дополнительный параметр продавца pay1 Дополнительный параметр
Дополнительный параметр #2 продавца pay2 Дополнительный параметр
Дополнительный параметр #3 продавца pay3 Дополнительный параметр
Дополнительный параметр #4 продавца pay4 Дополнительный параметр
Дополнительный параметр #5 продавца pay5 Дополнительный параметр

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


Формирование подписи secret_key
Формирование подписи производится путем создания контрольной суммы MD5
$secret_key = 'fds6gweg8dHgdKn'; // Секретный пароль, который вы указали в настройках
$signature = md5($secret_key);         


Пример обработчика платежей
$secret_key = 'fds6gweg8dHgdKn';
$signature = md5($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('5.196.214.144'))) {
	die("hacking attempt!");
} 

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

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

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

Action - Success URL
Method - POST/GET
Fields - поля передаваемые в форме, описаны в таблице ниже:
Название HTML Field Form Описание
ID магазина id ID магазина в системе
Сумма платежа summ Сумма к оплате
Номер счета pay_id Номер счета в магазине
Email email Почтовый ящик покупателя
Дополнительный параметр продавца pay1 Дополнительный параметр
Дополнительный параметр #2 продавца pay2 Дополнительный параметр
Дополнительный параметр #3 продавца pay3 Дополнительный параметр
Дополнительный параметр #4 продавца pay4 Дополнительный параметр
Дополнительный параметр #5 продавца pay5 Дополнительный параметр
Переадресация при отказе от оплаты (Fail URL)
После НЕ успешного проведения платежа, Покупатель будет перенаправлен на Fail URL который Вы задали в настройках сервиса.

Action - Fail URL
Method - POST/GET
Fields - поля передаваемые в форме, описаны в таблице ниже:
Название HTML Field Form Описание
ID магазина id ID магазина в системе
Сумма платежа summ Сумма к оплате
Номер счета pay_id Номер счета в магазине
Email email Почтовый ящик покупателя
Дополнительный параметр продавца 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
Visa/MasterCard pc
Приватбанк pv
Сбербанк sb
Альфа Банк ab
Тинькофф Банк tb
Русский Стандарт Банк rs
МТС mts
Билайн beeline
Мегафон mf
Теле2 tele2
Евросеть es
Связной sz
Терминалы term