ДеньгиOnline

2017-01-16 19:48:07

Действие commissions

Получение списка доступных систем: их параметров, получателей платежа, значений комиссии

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

Параметры запроса

Запрос содержит только общие обязательные параметры.

Параметры ответа

Ответ Системы в формате xml содержит, помимо общих, следующие теги:

Параметр Описание Тип данных
Тег services группирует описание одной платежной системы:
id Идентификатор услуги integer
tag Мнемонический идентификатор услуги - alias string (255)
title Наименование услуги string (255)
min_amount Сумма минимальной единичной выплаты

decimal (11.2)
разделитель – точка

max_amount Сумма максимальной единичной выплаты decimal (11.2)
разделитель – точка
account_name Подсказка, какой идентификатор получателя (аккаунт) нужно указать string
account_regexp Регулярное выражение для проверки аккаунта. Например, выражение /^\d{10}$/ проверяет номер телефона string
currency_id Валюта услуги

string / integer
ISO 4217 number-3

Тег extra передает дополнительные параметры (вспомогательные, информационные):
 game_rate  Курс игровой валюты к валюте провайдера decimal (11.7)
Тег params передает параметры, отражающие специфические для получателя валидаторы:
name

Имя параметра, при запросе на выплату – имя тега в теге params

Например, для выплат на банковские карты – ФИО получателя платежа

string
descr

Описание параметра

Например, для выплат на банковские карты – Дата истечения срока действия карты (в формате ММГГ)

string
regexp

Регулярное выражение для проверки параметра

Например, для выплат на банковские карты: /^[\d]+$/ ( выражение проверяет телефон получателя платежа в международном формате)

string
mandatory

Обязательность параметра для передачи:

  • y – обязателен,
  • n – не обязателен

string

Тег protection передает информацию о порядке проведения платежа с протекцией (нода присутствует, только если платеж проводится с протекцией):
type

Тип запроса протекции:

  • optional – код протекции можно запросить, можно не запрашивать;
  • mandatory – необходимо обязательно передавать информацию для кода протекции

string

field Поля, используемые для работы с кодом протекции  
name Имя поля, в котором передается информация для работы с кодом протекции  
descr Описание поля для работы с кодом протекции  
Тег commissions передает значения комиссий:
percent Процент вознаграждения

decimal (11.4)
разделитель – точка

fix Фиксированная часть комиссии decimal (11.4)
разделитель – точка
fix_currency Валюту, в которой заданы фиксированая часть, минимальная и максимальная сумма комиссии

string / integer
ISO 4217 number-3

min_commission Минимальный размер вознаграждения decimal (11.4)
разделитель – точка
max_commission Максимальный размер вознаграждения decimal (11.4)
разделитель – точка
payer

Плательщика комиссии:

  • "физлицо-получатель" – client,
  • "партнер-отправитель" – partner

string

Пример запроса

<?xml version="1.0" encoding="UTF-8"?>
<request>
    <action>commissions</action>
    <project>1234</project>
    <timestamp>1358429485</timestamp>
    <sign>d5fc59667fdae3f97e7527beed553d80</sign>
</request>

Пример ответа (успех)

<response>
    <status>1</status>
    <reference>243</reference>
    <timestamp>1441951927</timestamp>
    <services>
        <service>
            <id>2</id>
            <tag>qiwi</tag>
            <title>QIWI-кошелек</title>
            <min_amount>10.0000</min_amount>
            <currency_id>643</currency_id>
            <max_amount>15000.0000</max_amount>
            <account_name>Номер QIWI-кошелька (телефона, на который он зарегистрирован)</account_name>
            <account_regexp>/^\d+$/</account_regexp>
            <commission>
                <percent>-2.0000</percent>
                <fix>0.0000</fix>
                <fix_currency>643</fix_currency>
                <min_commission />
                <max_commission />
                <payer>partner</payer>
            </commission>
        </service>
        <service>
            <id>9</id>
            <tag>mcms</tag>
            <title>Пополнение карт VISA/MasterCard</title>
            <min_amount>10.0000</min_amount>
            <currency_id>643</currency_id>
            <max_amount>14831.0000</max_amount>
            <account_name>Номер карты</account_name>
            <account_regexp>/^\d{12,18}$/</account_regexp>
            <params>
                <name>
                    <name>name</name>
                    <descr>Фамилия и имя владельца карты</descr>
                    <regexp>/^.{0,255}$/</regexp>
                </name>
                <expiry>
                    <name>expiry</name>
                    <descr>Дата истечения срока валидности карты (ММГГ)</descr>
                    <regexp>/^[01][\d][12][\d]$/</regexp>
                </expiry>
                <phone>
                    <name>phone</name>
                    <descr>Телефон владельца карты</descr>
                    <regexp>/^[\d]+$/</regexp>
                </phone>
                <comment>
                    <name>comment</name>
                    <descr>Комментарий к выплате</descr>
                    <regexp>/^.{0,23}$/</regexp>
                </comment>
            </params>
            <commission>
                <percent>2.0000</percent>
                <fix>25.00</fix>
                <fix_currency>643</fix_currency>
                <min_commission />
                <max_commission />
                <payer>client</payer>
            </commission>
        </service>
        <service>
            <id>19</id>
            <tag>webmoneywmr</tag>
            <title>WebMoney WMR</title>
            <min_amount>1.0000</min_amount>
            <currency_id>643</currency_id>
            <max_amount>0.0000</max_amount>
            <account_name>Номер кошелька</account_name>
            <account_regexp>/^[rR][\d]{12}$/</account_regexp>
            <params>
                <comment>
                    <name>comment</name>
                    <descr>Комментарий к выплате</descr>
                    <regexp>/^.{0,255}$/</regexp>
                </comment>
            </params>
            <protection>
                <type>optional</type>
                <field>
                    <name>protection_period</name>
                    <descr>Период протекции в днях</descr>
                </field>
            </protection>
            <commission>
                <percent>2.0000</percent>
                <fix>0.0000</fix>
                <fix_currency>643</fix_currency>
                <min_commission />
                <max_commission>1500.0000</max_commission>
                <payer>client</payer>
            </commission>
        </service>
        <service>
            <id>20006</id>
            <tag />
            <title>Властелин Колец Онлайн</title>
            <min_amount>0.0100</min_amount>
            <currency_id>643</currency_id>
            <max_amount>15000.0000</max_amount>
            <account_name>Введите Ваш E-mail</account_name>
            <account_regexp>/^.+$/</account_regexp>
            <extra>
                <game_rate>0.3000000</game_rate>
            </extra>
            <commission>
                <id>54866</id>
                <percent>-5.0000</percent>
                <fix>0.0000</fix>
                <fix_currency>643</fix_currency>
                <min_commission></min_commission>
                <max_commission></max_commission>
                <payer>partner</payer>
            </commission>
        </service>
    </services>
</response>
 

Пример ответа (ошибка)

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <status>14</status>
    <reference>25237</reference>
    <timestamp>1358430240</timestamp>
</response>