EasyPay — оплата товаров и услуг в Интернет

Агенты по распространению электронных денег (Агенты)


Общие сведения

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

Описание входных и выходных параметров функций

Название полейФормат полейОписание полей
codeцелое числокод ответа от сервера EasyPay
messageпроизвольное число алфавитно-цифровых символов кроме "<" и ">"комментарий на code ошибки от сервера на русском языке. Формируется сервером EasyPay, поясняет код ошибки
balanceчисло больше нулясумма в белорусских рублях
mer_no6 алфавитно-цифровых символов вида okXXXX, где X – число от 0 до 9номер Агента в EasyPay. Выдается Администратором EasyPay при регистрации
passот 8 до 25 алфавитно-цифровых символовпароль Агента в EasyPay. Выдается Администратором EasyPay при регистрации
pay_idот 1 до 32 алфавитно-цифровых символов кроме "<" и ">"уникальный идентификатор платежа. Формируется Агентом
card8 цифридентификатор электронного кошелька EasyPay
sumчисло больше нуля сумма в белорусских рублях
разделитель ,. или отсутствует
purposeпроизвольное число (но не более 255) алфавитно-цифровых символов кроме "<" и ">"назначение перевода. Формируется Агентом
xmlОт 0 до 64 килобайта текстовой информации в произвольной формедополнительный XML или другие текстовые данные

Проверка достаточности средств на счету Агента в EasyPay

(code, message, balance) = EP_MerchantBalance(mer_no, pass)

Перевод денег в указанный кошелек Пользователя в EasyPay

(code, message) = EP_CreatePayment(mer_no, pass, pay_id, card, sum, purpose, xml)

Проверка прохождения платежа от Агента в кошелек Пользователя

(code, message) = EP_CheckPayment(mer_no, pass, pay_id)

Описание полученных кодов

В случае успешно проведенной операции возвращается code = 200 или code = 211 - счет не оплачен. Ниже приведен список некоторых встречающихся кодов:

code = 200 - успешное выполнение операции
code = 211 - счет не оплачен
code = 306 - Идентификатор (номер) электронного кошелька EasyPay содержит недопустимые символы
code = 364 - Несуществующий pay_id. Такого платежа нет в системе
code = 501 - несуществующий Идентификатор (номер) электронного кошелька EasyPay
code = 330 - сумма меньше 100 руб. Необходимо увеличить сумму для проведения операции
code = 30 - неверный формат переданных данных
code = 31 - ошибка соединения с сервером EasyPay
code = 32 - неверный формат ответа сервера EasyPay
code = 500 - неизвестная внутренняя ошибка. При возврате ошибки с кодом "500" обратитесь к Администратору

*Рабочая кодировка в системе Windows-1251. Все принимаемые/передаваемые данные должны быть в этой кодировке, комментарии на ошибки система отправляет тоже в этой кодировке. Внешний xml- обмен происходит в кодировке utf-8.

Схема взаимодействия Агента с Процессинговым центром