.UA ccTLD Domain Network Information Centre

BALANCE:INFO

Команда EPP <balance: info> призначена для отримання інформації про баланс реєстратора, а також про дату закінчення діючого договору з адміністратором публічного домена і статусу доступу до платних операцій. В даний момент можлива видача інформації за договорами з компанією "Хостмайстер".

Опис XML структури додаткового документу balance (формальний синтаксис): http://hostmaster.ua/epp/balance-1.0.

Команда містить обов'язковий елемент:

  • <balance:contract> - номер договору з адміністратором публічних доменів. Номер договору можна подивитись на порталі https://epp.hostmaster.ua в параметрах реєстратора.

Приклад запиту <balance:info>

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <command>
     <info>
      <balance:info xmlns:balance="http://hostmaster.ua/epp/balance-1.0">
         <balance:contract>R12/999</balance:contract>
       </balance:info>
     </info>
     <clTRID>USER-1276595352</clTRID>
   </command>
</epp>

Відповідь сервера містить секцію <resData> <balance:infData>, в яку входять наступні елементи:

  • <balance:contract> - номер діючого договору між реєстратором і адміністратором публічного домена (АПД).
  • <balance:contractUntil> - термін дії договору з АПД.
  • <balance:status> - статус доспупа до платних операцій. Значення атрибуту s="1" означає, що доступ відкритий. Значення атрибуту s="0" означає, що доступ закритий.
  • <balance:balance> - стан балансу реєстратора на час, що вказаний в атрибуті bdate.

Приклад відповіді сервера на команду <balance:info>

<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <response>
    <result code="1000">
      <msg lang="ua">Команду виконано успішно</msg>
    </result>
    <resData>
      <balance:infData xmlns:balance="http://hostmaster.ua/epp/balance-1.0">
        <balance:contract>R12/999</balance:contract>
        <balance:contractUntil>2015-09-01T00:00:00+03:00</balance:contractUntil>
        <balance:status s="1"/>
        <balance:balance bdate="2015-05-19T16:01:37+03:00">111.11</balance:balance>
      </balance:infData>
    </resData>
    <trID>
      <clTRID>USER-1276595352</clTRID>
      <svTRID>UA:0:C11DDC12:20150520142151:470567:0002</svTRID>
    </trID>
  </response>
</epp>

Коди відповідей сервера на команду <info>

1000    "Command completed successfully"
        "Команду виконано успішно"
        "Команда выполнена успешно"

2001    "Command syntax error"
        "Синтаксична помилка команди"
        "Синтаксическая ошибка команды"

2303    "Object does not exist"
        "Об'єкт не існує"
        "Объект не существует"
         Помилка видається при спробі отримати інформацію про
         неіснуючий (недійсний) у реєстратора договор.