Page tree
Skip to end of metadata
Go to start of metadata

Формування запиту


Для всіх видів запитів виділяються загальні обов'язкові дані, до яких відносяться:

  • ідентифікатори основного терміналу сервіс-провайдера, MerchantId і TerminalId. Поле TerminalId є опціональним, оскільки до одного ідентифікатора MerchantId прив'язується тільки один TerminalId.
  • ідентифікатор транзакції, який встановлюється сервіс-провайдером, TrackingId. Дані TrackingId повинні однозначно ідентифікувати транзакції переказу коштів. Той же TrackingId, що і в транзакції переказу коштів, може використовуватися в додаткові сервіси, наприклад, при визначенні типу перекладу з карти на карту. Так само, TrackingId використовується для отримання статусу завершеною транзакції.
  • Signature - криптографічний підпис запиту.


Загальні теги запиту:

Приклад запиту
<Request root tag>
  <MerchantId>9752130</MerchantId>
  <TerminalId>E9879930</TerminalId>
  <TrackingId>fd4e1c67a2d28fced849ee1bb76e7391b93eb12</TrackingId>
 
   ...
 
  <Signature></Signature>
</Request root tag>

Обробка відповіді

Незалежно від типу запиту, відповідь обов'язково буде містити Signature і Status.

  • Signature - криптографічний підпис відповіді.
  • Status - статус виконання запиту, який в свою чергу складається з:
  • Code - тризначний код, який визначає успішність виконання запиту або пояснює причину помилки або відмови.
  • Message - текстове повідомлення в довільній формі, яке деталізує причину отримання того, чи іншого коду відмови або помилки.


Загальні теги відповіді
<Response root tag>
    <Status>
        <Code>000</Code>
        <Message> status message...</Message>
    </Status>
    <Signature></Signature>
</Response root tag>

Взаємодія з протоколом здійснюється за допомогою HTTP POST запитів / відповідей. Дані запитів і відповідей передаються в форматі XML.

  • No labels