покриття в Україні
Поповнити рахунок
Онлайн Чат
Телефонуй
Покупка ваучерів PEOPLEnet
- prp_pnet - покупка ваучера PeopleNet
У тілі запиту передається xml наступної структури:
1. Запит списку реквізитів:
<?xml version="1.0" encoding="UTF-8"?>
<request version="1.0">
<merchant>
<id>XXXX</id>
<signature>YYYY</signature>
</merchant>
<data>
<oper>prp</oper>
</data>
</request>
де: XXXX - id партнера платежів, YYYY - сигнатура запиту
Сигнатура запиту розраховується таким чином (PHP):
$sign = md5(sha1($data.$password));
- де $data - вміст тега <data> даного запиту а $password - особистий пароль мерчанта, отриманий їм при реєстрації.
Відповідь:
<?xml version="1.0" encoding="UTF-8"?>
<response version="1.0">
<merchant>
<id>XXXX</id>
<signature>YYYY</signature>
</merchant>
<data>
<oper>prp</oper>
<props>
<prop name="aaa" type="bbb" size="ccc" value="ddd" />
<prop name="aaa" type="bbb" size="ccc" value="ddd" />
<prop name="aaa" type="list" size="ccc">
<value>sss</value>
<value>ddd</value>
</prop>
</props>
</data>
</response>
де: b - ім'я реквізиту платежу, bbb - тип реквізиту (текст - txt, багаторядковий текст - txtar, ціле число - int, список - list, сума - amt, дата/час - date), ccc - максимальна довжина значення реквізиту (у символах), ddd - значення реквізиту за умовчанням (для типу list задаються декілька значень у вкладених тегах). Число реквізитів може бути будь-яким.
2. Команда на виконання операції:
<?xml version="1.0" encoding="UTF-8"?>
<request version="1.0">
<merchant>
<id>XXXX</id>
<signature>YYYY</signature>
</merchant>
<data>
<oper>cmt</oper>
<wait>wwww</wait>
<test>ttt</test>
<payment id="qqqq">
<prop name="aaa1" value="ddd1" />
<prop name="aaa2" value="ddd2" />
</payment>
</data>
</request>
де qqqq - унікальний ідентифікатор платежу, привласнений партнером платежів. Повторюється відповідає на запит, зберігається у базі Приват24, служить для однозначного зіставлення операцій на стороні партнера платежів з операціями в приват24, aaa1, aaa2 - імена реквізитів (повинні співпадати з іменами, отриманими відповідає на запит 1.), ddd1, ddd2 - значення реквізитів, ttt - ознака тестового платежу (0 - ні: платіж буде проведений негайно, 1 - платіж буде перевірений на коректність, але не буде проведений), wwww - інтервал очікування перед відправкою платежу на проводку (у секундах).
Відповідь:
<?xml version="1.0" encoding="UTF-8"?>
<response version="1.0">
<merchant>
<id>XXXX</id>
<signature>YYYY</signature>
</merchant>
<data>
<oper>cmt</oper>
<payment id="qqqq" state="rrrr" message="mmmm" ref="ffff" amt="aaaa" ccy="ccccc" comis="sssss" code="dddd"/>
</data>
</response>
де: rrrr - стан платежу (1 - проведений, 0 - забракований), mmmm - розширене повідомлення про стан платежу, може містити опис причини, із-за якої платіж був забракований, ffff - внутрішній рефреренс платежу в приват24 (якщо платіж забракований - порожнє поле), aaaa - сума платежу (без комісії), ccccc - валюта операції, sssss - сума комісії банку за даним типом платежу, dddd - код ваучера (для prepaid-операцій).
Пакетний режим передачі платежів
API дозволяє передавати на проводку платежі в пакетному режимі. При цьому другий запит може включати будь-яке число тегов <payment> з різними id. Відповідь також міститиме відповідне число тегов з id рівними id платежів в запиті. id платежів повинні бути унікальними в межах запиту. У разі порушення цього правила другий платіж з цим же id буде забракований.
У пакетному режимі можуть передаватися платежі тільки одного типу з однаковим набором реквізитів.
