Настройка системы Название системы - используется в заголовках интерфейсов системы и в подписи писем отсылаемых системой. Настройки почты - настройка почтовых возможностей системы. E-mail администратора - почтовый адрес администратора системы. На этот адрес система будет высылать сообщения в случае поступления нового заказа, оплаты заказа, возникновения ошибок или изменения настроек системы. С этого почтового ящика производится отсылка писем пользователям, а также он сообщается пользователю для связи с администратором при возникновении ошибок при оплате заказа. Путь к sendmail или SMTP серверу - путь к почтовой службе sendmail или адрес SMTP сервера. В случае неправильной настройки данного параметра система не сможет оправлять письма. Часовой пояс - настройка часового пояса времени используемого в системе. Использовать переход на летнее время и обратно? - для использования автоматического перевода часов системы на летнее и зимнее время необходимо включить эту опцию. Оповещения. Отсылать сообщение администратору при новом заказе? - необходимо установить эту галочку для отсылки сообщения администратору в случае поступления нового заказа или запроса на пополнение счета. Отсылать сообщение администратору при оплате заказа? - необходимо установить эту галочку для отсылки сообщения администратору в случае оплаты заказа или начислении денег на счет пользователя. Отсылать сообщение администратору при возникновении ошибок? - необходимо установить эту галочку для отсылки сообщения администратору в случае возникновения ошибки при работе системы или ошибки в подключаемых скриптах. Рекомендуется использовать эту опцию. Отсылать сообщение администратору при изменении настроек системы? - рекомендуем установить эту галочку, после того как настройка системы будет завершена. При установке этой опции система будет информировать администратора о каждом изменении настроек системы. Режим работы системы - выбор режима работы системы. Имеются несколько демонстративных режимов для отладки системы и рабочий режим для приема денег. При работе системы в демонстрационном режиме перевод денег с покупателя не требуется, в системе WebMoney средства с кошелька покупателя сниматься не будут. После настройки системы необходимо перевести её в рабочий режим. Демо режим 1 - все платежи будут выполнены успешно. Демо режим 2 - все платежи будут не выполнены. Демо режим 3 - 80% - платежей успешные, 20% - с ошибкой. Рабочий режим - режим, при котором происходит прием денег с покупателя. Внимание! * При приеме денег в системе WebMoney с помощью Web Merchant Interface, используйте его для включения/отключения демонстрационного режима. * В сервисе ROBOKASSA активация аккаунта определяет режим работы. Неактивированные аккаунты могут принимать платежи только в демо режиме, а активированные только в рабочем. Активация заказа и выдача товаров. Команда активации заказа - команда, выполняемая один раз после оплаты заказа и используемая для передачи информации об оплаченном заказе сторонней программе (скрипту) с применением командной строки и потока (stdin). В случае успешной активации сторонняя программа, вызываемая в командной строке должна вернуть код завершения равный нулю, иначе заказ будет считаться не активированным. При запуске сторонней программы, ей могут передаваться различные данные о заказе: заказанные товары ([DFM_GOODS_ID]), номер [DFM_PAYNUM]) и сумма заказа ([DFM_MONEY]), а также информация о плательщике ([DFM_USERID]). При активации заказа желательно использовать пароль, который будет передаваться сторонней программе вместе с информацией о заказе. Передаваемый пароль должен сверяться с паролем заданным в сторонней программе и только при совпадении паролей должна производиться активация заказа. Наличие этого пароля не позволит стороннему пользователю (пользователю способному запускать программу активации на вашем сервере) выполнить активацию заказа. Пароль желательно передавать через поток, чтоб его нельзя было увидеть при просмотре процессов запущенных на сервере. Сторонняя программа не должна ничего выдавать на экран или пытаться выдать оплаченный товар (для выдачи товара используется другая команда). Она может выполнять следующие действия, например: подготовить выдачу заказанного товара при последующем запросе на его получение или пополнить счет пользователя в своей системе. Ниже рассмотрены два примера работы сторонних программ. Получение товара - получение и доставка товаров. Существуют несколько способов доставки купленного товара покупателю, они должны быть реализованы в программном обеспечении, осуществляющем доставку товара. Команда выдачи товара - эта команда определяет, что увидит или куда будет переадресован покупатель, после оплаты заказа или клика по ссылке получения товара. После проверки на правильность уникальной ссылки покупателя система выполняет команду на выдачу товара. Поддерживаются несколько видов команд выдачи товара: - вывод на экран сообщения (Message), что оплата прошла успешно. Применяется в тех случаях, когда происходит пополнение счета и не требуется выдача товара или когда товар оправляется на e-mail покупателя при активации товара. Шаблон выдаваемого сообщения находится в файле mtpl/mpay_success.htm. - переадресация (Location) на заданный интернет-адрес с параметрами (GET). - выполнение командной строки (Execute), система передает управление командной строке, при этом информация, выдаваемая на экран программой запущенной в командной строке, будет передана пользователю. Программа в свою очередь должна выдавать покупателю товар или информацию о том, как он может получить купленный товар. Использование командной строки может быть рассмотрено на примере скрипта доставки товара входящем в комплект системы (gdelivery.cgi). Список макросов используемых для передачи информации о заказе сторонним программам: [DFM_PAYNUM] - номер заказа, присваивается системой автоматически при каждом новом заказе. [DFM_GOODS_ID] - код (идентификатор / краткое название) товара, вводиться при добавлении товаров. В случае если в одном заказе содержится несколько товаров, то их коды перечисляются через запятую. [DFM_MONEY] - сумма заказа без учета комиссии. [DFM_PAYMONEY] - сумма заказа с учетом комиссии (сумма заказа в валюте платежной системы). [DFM_PMNAME] - название платежной системы (Webmoney, RBK Money, Fethard, E-Gold, ROBOKASSA, PayPal, SWREG). [DFM_REMARKS] - примечание, дополнительная информация о платеже. Может состоять из нескольких слов (при передачи в командной строке следует использовать кавычки) или вовсе отсутствовать. [DFM_PAYSES] - уникальный ключ (сессия), который создается при создании заказа и служит для идентификации заказа. [DFM_ USERNAME] - имя плательщика. [DFM_ USERMAIL] - почтовый ящик плательщика (e-mail). [DFM_USERID] - идентификатор плательщика в сторонней системе (например, в трафик-магазине, казино и др.). Передается при заказе на пополнение счета из сторонней системы в DF MultiMerchant с помощью html-формы методом GET/POST (http://mydomain.com/mpay.cgi?DFM_USERID=user_login). Пример подключения DF™ MultiMerchant к интернет-магазину. В поставку системы DF™ MultiMerchant входят скрипты подходящие для организации простого интернет-магазина. Более подробно об их возможностях вы можете прочитать на сайте, а сейчас мы остановимся на принципе работы скрипта активации заказа (gactivate.cgi) и скрипта выдачи товаров (gdelivery.cgi). При активации заказа система вызывает скрипт gactivate.cgi с параметрами, через которые она передает скрипту следующую информацию о заказе: номер заказа ([DFM_PAYNUM]), идентификаторы заказанных товаров ([DFM_GOODS_ID]) и пароль (Password) сверяемый в скрипте активации. perl ./gactivate.cgi Password [DFM_PAYNUM] [DFM_GOODS_ID]В процессе активации заказа скрипт создает базу данных купленных товаров для скрипта выдачи товаров и в случае успешной активации заказа возвращает код завершения равный 0 (exit(0)). После оплаты заказа и успешной активации система вызывает команду выдачи товара, при этом производится вызов скрипта выдающего купленные товары gdelivery.cgi с теми же параметрами что и скрипт активации. perl ./gdelivery.cgi Password [DFM_PAYNUM] [DFM_GOODS_ID]При запросе на выдачу товара, скрипт сверяет пароль и по номеру заказа ищет данный заказ в базе активированных заказов, а после производит выдачу товара покупателям. В зависимости от того к какому виду информации относится товар, покупателю выдается различная информация. При выдаче товара-файла выдается информация о файле и уникальная ссылка, по которой можно скачать данный файл. В случае, когда товаром является доступ к платному сайту, покупателю выдается адрес к защищенной паролем области сайта и данные для входа в эту область (логин и пароль). Пример использования DF™ MultiMerchant для пополнения счета пользователя в сторонней системе. При запросе пользователя на пополнение своего счета в сторонней системе она должна переадресовывать пользователя на модуль оплаты системы DF™ MultiMerchant с обязательной передачей в параметрах его идентификатора (логина) (http://mydomain.com/mpay.cgi?DFM_USERID=user_login). В системе DF MultiMerchant пользователь делает заказ на пополнение счета и самостоятельно назначает сумму пополнения. После успешной оплаты заказа система DF MultiMerchant выполняет активацию заказа, при которой передает сторонней программе идентификатор пользователя и сумму, на которую необходимо пополнить его счет. На основе этих данных сторонняя программа должна пополнить счет данного пользователя и в случае успеха вернуть код завершения равный нулю. При команде выдачи товара система DF MultiMerchant может выдавать сообщение об успешном пополнении счета или переадресовывать пользователя на личный кабинет в сторонней системе. В качестве примера активации рассмотрим командную строку, применяемую для пополнения счета покупателя трафика в системе DF Web-Traffic Shop (WTS). ./wtscrn.cgi pay_buyer Password [DFM_USERID] [DFM_MONEY] "[DFM_USERNAME]"Для пополнения счета покупателя используется программа wtscrn.cgi, входящая в состав системы WTS, которая принимает следующие параметры командной строки: pay_buyer - вызов функции пополнения счета в системе WTS; Password - пароль администратора системы WTS, без знания пароля начисления средств на счета пользователей производиться не будет; [DFM_USERID] - ИД покупателя трафика в системе, передается через html-формы при заказе на пополнение счета; [DFM_MONEY] - сумма, на которую будет производиться пополнение счета покупателя веб-трафика; "[DFM_USERNAME]" - имя пользователя (заключено в кавычки т.к. может состоять из нескольких слов). Получение товара - получение и доставка товаров. Существуют несколько способов доставки купленного товара покупателю, они должны быть реализованы в программном обеспечении, осуществляющем доставку товара. Команда на выдачу товара - эта команда определяет, что увидит или куда будет переадресован покупатель, после клика по ссылке получения товара. После проверки на правильность уникальной ссылки покупателя система выполняет команду на выдачу товара. В настоящее время поддерживаются несколько видов команды выдачи товара. - вывод на экран сообщения(Message), что оплата прошла успешно. Применяется в тех случаях, когда происходит пополнение счета и не требуется выдача товара или когда товар оправляется на e-mail покупателя при активации товара. Шаблон выдаваемого сообщения находится в файле mtpl/mpay_success.htm. - переадресация(Location) на заданный интернет-адрес с параметрами(GET). - выполнение командной строки(Execute). Система передает управление командной строке, при этом информация, выдаваемая на экран программой из командной строки, будет выдана пользователю. Программа в свою очередь должна выдавать покупателю товар или информацию о том, как он может получить купленный товар. В случае успешного выполнения программы она должна вернуть код возврата равный нулю, иначе система будет считать, что при выдаче товара произошла ошибка. Использование командной строки может быть рассмотрено на примере скрипта доставки товара входящем в комплект системы(gdelivery.cgi). Возможна переадресация на заданную страницу или выполнение скрипта. Слова заключенные в [] имена html-форм. Пример1: Location to URL: http://mysite.com?pn=[DFM_PAYNUM]&gid=[DFM_GOODS_ID] Пример2: Execute command: perl ./gdelivery.cgi AdminPassword [DFM_PAYNUM] [DFM_GOODS_ID] Товары - управление товарами. В этом разделе производится назначение товаров, которые можно купить через данную систему. Товары разделяются на два типа: товары с фиксированной ценой и товары без фиксированной цены. Товары без фиксированной цены используются для пополнения счетов пользователей в сторонних системах, в этом случае пользователь (покупатель) сам назначает размер платежа. Поле "Наименование товара" - должно содержать название товара, которое может состоять из нескольких слов на любом языке. Поле "Код товара"- должно содержать краткое название (идентификатор) товара, должно состоять из одного слова из латинских букв. Поле "Цена" - цена товара в USD. В случае, когда производиться пополнения счета - покупатель сам может ввести сумму пополнения, поле цена должно содержать -1. Поле "Группа" - группа, к которой относится данный товар. Группы связывают товары и пользователей. Принадлежность товара к группе определяет пользователей, которые могут купить этот товар. Если у товара не назначена группа, то все желающие могут приобрести данный товар. К одной группе может принадлежать несколько товаров. Пример 1: "Телевизор Sony" telsony 300 [любая] Пример 2: "Пополнение счета в casino.com" incacc_casino.com -1 Также группа влияет на отображение товаров при вызове mpay.cgi: При вызове mpay.cgi без указания группы показываются товары, которые не принадлежат конкретной группе. Купить их может каждый. При вызове mpay.cgi с указанием группы (GET/POST -> DFM_GROUPGOODS=[название группы]) показываются товары, которые принадлежат этой группе при условии, что группа не защищена паролем. Приобрести эти товары могут только пользователи, принадлежащие данной группе. Принадлежность пользователя к группе определяется по параметру DFM_USERID (GET/POST -> DFM_USERID=[имя]) содержащему имя (идентификатор) покупателя. Для показа товаров, которые принадлежат группе защищенной паролем, при вызове mpay.cgi в параметрах необходимо указывать группу (GET/POST -> DFM_GROUPGOODS=[название группы]) и пароль (GET/POST -> DFM_GROUPPWD=[пароль]). Приобрести эти товары могут только пользователи, принадлежащие данной группе. Группы и покупатели - настройка групп и покупателей. Группы позволяют назначать, разные цены на товары для разных покупателей, а также ограничить доступ покупателей к определенным товарам. Поле "Группа" - название группы. Должно содержать только латинские символы, может быть из нескольких слов. Пароль - пароль для показа и покупки товара из этой группы. Приобрести товар из группы, защищенной паролем, могут только пользователя, которые знающие название группы (DFM_GROUPGOODS), пароль к группе (DFM_GROUPPWD) и своё имя в группе (DFM_USERID). Покупатели группы - имена (идентификаторы) пользователей которые могут приобретать товары, принадлежащие данной группе. Назначать пользователей необходимо по одному имени в строке. Управления товарами может производиться из сторонних программ, для этого в системе имеются специальные интерфейсы. WebMoney - настройки касающиеся приема платежей из WebMoney.ru WebMoney.ru - самая распространенной платежной системы в русском интернете. Принимать к оплате WebMoney - разрешить принимать платежи через систему WebMoney. Выбор способа приема платежей. Прием платежей из системы WebMoney возможен двумя способами: с использованием Web Merchant Interface (WMI) и с использованием интерфейсов WebMoney Keeper Mini (WMM). Оба способа имеют свои достоинства и недостатки. Способ приема платежей на базе Web Merchant Interface - легален, использует специализированные интерфейсы WebMoney предназначенные для приема платежей обладающие высокой надежностью и защищенностью. Однако для использования данного способа приема платежей необходима аттестация вашего счета (аттестат продавца). Аттестация счета платная (5-15 WMZ), также она требует проверки вашего сайта и ваших персональных (паспортных) данных. Аттестация счета может быть достаточно непростым и длительным занятием, особенно если вы живете в небольшом городе. Способ приема платежей с использованием интерфейсов WebMoney Keeper Mini - нелегален, менее надежен по сравнению с предыдущим способом т.к. использует нестандартизированные интерфейсы WebMoney Keeper Mini подверженные изменению и требует от пользователя прохождения антибот-теста (ввод символов изображенных на картинке) при оплате заказа. Достоинством данного способа является нетребовательность к аттестации счета, а также хорошая защищенность от взлома при правильных настройках безопасности указанных в инструкции - взломав сервер с вашим сайтом нельзя получить доступ к средствам на кошельках (для работы не требуется хранение на сервере файлов с ключами и паролей к ним). При выборе способа приема платежей следует руководствоваться наличием у вас аттестованного счета. Настройка ряда параметров на сайте WebMoney. Для приема платежей с использованием Web Merchant Interface сначала необходимо авторизоваться в WebMoney Keeper и произвести ряд настроек на странице WebMoney Merchant, согласно инструкции. Для приема платежей с использованием интерфейсов WebMoney Keeper Mini необходимо произвести ряд действий описанных в данной инструкции инструкции. WMID - идентификатор пользователя системы WebMoney (691269123647). Кошелек WMZ - кошелек, на который будут поступать платежи (Z123456789101/R123456789101). Секретное слово / Пароль - в зависимости от используемого способа приема платежей здесь назначается секретный ключ (Secret Key) используемый для проверки платежа в Web Merchant Interface или пароль от WebMoney Keeper Mini. Дополнительные параметры, используемые при работе с WebMoney Keeper Mini: Проверять подлинность SSL-соединения? - производить ли проверку сертификата удаленного сервера (CURLOPT_SSL_VERIFYPEER). Включение этой опции требует наличие настоящего SSL-сертификата WebMoney, путь к которому указывается в следующей настройке. Отключение этой опции не рекомендуется т.к. это снижает безопасность. Отключать эту опцию следует только в том случае, если система выдает ошибку типа "Peer certificate cannot be authenticated with known CA certificates", а вы затрудняетесь с поиском подходящего SSL-сертификата WebMoney. Путь к SSL-сертификату WebMoney - путь на диске сервера к SSL-сертификату WebMoney. Сертификат имеет свойство устаревать, если это случится, то его необходимо обновить. Новый сертификат можно попытаться найти на сайтах: webmoney.ru, owebmoney.ru, http://dfservice.com/dfm/man/wmm.cer или экспортировать из веб-браузера. Назначение комиссионных (скидок) для системы WebMoney. Описание и примеры для чего может применяться комиссия, рассмотрены ниже. Примечание для покупателей Небольшой совет или примечание для покупателей со стороны администратора. Эту информацию покупатели видят при выборе платежной системы для оплаты заказа. Пример: Принимаются также: чеки Paymer.com, ВМ-карты, Telepat.ru, Enum.ru ROBOKASSA - настройки приема платежей через сервис ROBOKASSA.ru Сервис ROBOKASSA позволяет принимать платежи от клиентов в любой электронной валюте, с помощью sms-сообщений, через систему денежных переводов Contact, и через терминалы мгновенной оплаты. Принимать платежи через сервис ROBOKASSA.ru - включить прием платежей через сервис ROBOKASSA.ru. Для приема платежей через сервис ROBOKASSA.ru необходимо иметь активированный аккаунт в этом сервисе. Настройка параметров мерчанта на сайте сервиса ROBOKASSA. Для приема платежей с использованием сервиса ROBOKASSA сначала необходимо произвести ряд настроек в личном кабинете данного сервиса, согласно текущей инструкции. Логин - Ваш логин пользователя в сервисе ROBOKASSA (Ваш Логин: DFService). Пароль 1, Пароль 2: - пароли, используемые для проверки правильности передаваемой информации о платежах. Данные пароли назначаются в личном кабинете сервиса ROBOKASSA. Курс валюты системы к "Валюте Продавца" - отношение Валюты Продавца в сервисе ROBOKASSA (Валюта, которую будет получать Продавец) к валюте системы DF MultiMerchant. Например, в качестве Валюты Продавца в сервисе ROBOKASSA используются рубли, а в качестве валюты системы DF MultiMerchant используются доллары. Для того чтобы уравнять данные валюты и введен данный курс, в данном случае равный курсу доллара. Назначение комиссионных (скидок) для системы ROBOKASSA. Описание и примеры для чего может применяться комиссия, рассмотрены ниже. Примечание для покупателей Небольшой совет или примечание для покупателей со стороны администратора. Эту информация отображается при выборе платежной системы для оплаты заказа. Пример: Прием платежей в любой электронной валюте, с помощью sms-сообщений, систему Contact и терминалы мгновенной оплаты. Яндекс.Деньги - настройки приема платежей в валюте Яндекс.Деньги. Принимать к оплате Яндекс.Деньги? - включить прием платежей в валюте Яндекс.Деньги. Логин Для приема платежей в валюте Яндекс.Деньги сначала необходимо произвести ряд настроек в личном кабинете на сайте money.yandex.ru, согласно текущей инструкции. Логин - Ваш логин пользователя в системе Яндекс.Деньги. Пароль - Ваш пароль пользователя в системе Яндекс.Деньги. Логин и пароль требуются для чтения истории платежей, т.к. в настоящее время Яндекс API не позволяют полноценно это делать. Номер счета - номер вашего счета в системе Яндекс.Деньги. Идентификатор сервиса - выдается на сайте системы Яндекс.Деньги в разделе Регистрация сервиса. Redirect uri - требуется при регистрации сервиса на сайте Яндекс.Деньги. Токен доступа - ключ для доступа к кошельку (не включает вывод денег со счета). Вы можете получить или обновить его используя кнопку "Получить токен" рядом с этим полем. Курс RUR к USD - отношение валюты Яндекс.Деньги (RUR) к валюте системы DF MultiMerchant (USD). Используется для пересчета цены товаров в системе DF MultiMerchant в валюту Яндекс.Деньги. Назначение комиссионных (скидок) для системы Яндекс.Деньги - назначается в USD, а при оплате пересчитывается исходя из заданного курса. Описание и примеры для чего может применяться комиссия, рассмотрены ниже. Примечание для покупателей Небольшой совет или примечание для покупателей со стороны администратора. Эту информация отображается при выборе платежной системы для оплаты заказа. Пример: Прием валюты Яндекс.Деньги. Применение комиссионных (скидок). Диапазон - номер денежного диапазона. От - начальное значение диапазона. До - конечное значение диапазона. Комиссия ($/%) - комиссия для заданного денежного диапазона. Может выражаться в долларах или процентах, в зависимости от этого за значением комиссии ставиться знак "$" или "%". Если значение комиссии отрицательное, то комиссия будет не начисляться, а сниматься - соответственно это можно назвать скидкой. Назначение комиссионных приведет к тому, что сумма заказа и сумма платежа в платежной системе будут различаться. Это может использоваться для приведения денег в системе к одной базовой валюте или для начисления пользователям скидок в зависимости от размера платежа. Примеры применения: 1. Приведение денег находящихся на счетах нескольких платежных систем к одной валюте. Допустим, вы имеете свой бизнес и принимаете платежи из нескольких платежных систем (при оплате ваших товаров деньги пользователей переходят с их счетов в платежных системах на ваши счета в этих платежных системах). С определенной периодичностью вы обналичиваете деньги со своих счетов, уплачивая при этом комиссионные посредникам за обналичивание. Причем, обналичивание валют разных платежных систем имеет свой размер комиссионных (например: WMZ -> Наличные = 2%, RBK Money -> Наличные = 5%). Исходя из этого, вы хотите, чтобы ваш товар в разных валютах стоил одинаково по отношению к наличным деньгам (назовем их "базовой валютой"). Для этого с помощью назначения комиссии вы закладываете в цену товара в каждой платежной системе стоимость обналичивания данной валюты. В итоге ваш товар будет иметь одну цену в базовой валюте и различные цены в других валютах. В статистике без скобок будут отображаться деньги в базовой валюте (эквиваленте наличных денег), а в скобках деньги в валюте платежной системы. 2. Начисление бонусов в зависимости от размера платежа. Допустим, вы владелец интернет-казино, сайта знакомств или другого бизнеса, где система DF™ MultiMerchant используется для пополнения счета в вашей системе. При пополнении счета пользователь сам выбирает сумму пополнения. Вы хотите, чтоб сумма, на которую производится пополнение счета в вашей системе, зависела от размера платежа пользователя (например: при пополнении счета на сумму больше $20 чтоб давался бонус 5%, при сумме пополнения больше $50 бонус %10 и т.п.). Для этого вы также можете использовать настройки комиссии, но назначать комиссии следует с отрицательным знаком. В статистике без скобок будут отображаться деньги начисляемые пользователям в вашей системе, а без скобок деньги оплачиваемые в валюте платежной системы. На главную |