Загальні відомості: відмінності між версіями

← Попереднє редагування Наступне редагування →

Версія за 13:28, 12 серпня 2025

Вступ

Протокол призначено для торговців, які є одержувачами платежів. Продавець підписує договір про прийняття платежів або анкету-акцепт до публічної оферти.
Щоб отримати платежі, ви можете використовувати web, мобільні версії сайтів, а також мобільні програми. У разі використання цього протоколу не здійснюється перевірка даних для ідентифікації замовлення або облікового запису. EasyPay завжди приймає дані, надіслані та створені продавцем.

Заголовки запитів

Для надсилання запиту та отримання відповіді у форматі JSON, необхідно передати такі обов’язкові заголовки у запиті.

--header 'Content-Type: application/json'

--header 'AppId: cd7fde18-15db-4d94-a91b-7cf8edd81209'

--header 'PageId: 3e7bf353-417a-410c-a22e-df8bdcccb760'

--header 'PartnerKey: easypay-test'

--header 'locale: ua'

--header 'Sign: bS+vPOwu1Sif1Iz47Cdh+z1RAi0s6X21C3uU0YNBNWE='

URL

Посилання	Характеристика	Коментарій
`https://merchantapi.easypay.ua`	Production	в т.ч. для надсилання тестових запитів

Налаштування безпеки

Партнер надає IP, з яких будуть здійснюватися запити.

Реєстрація партнера в системі EasyPay

Реєстрація нового торговця передбачає отримання унікального ідентифікатора PartnerKey.

Характеристика параметрів реєстрації

Параметр	Характеристика	Коментарій
`PartnerKey`	унікальний ідентифікатор партнера (продавця) у системі EasyPay.	передається партнеру після реєстрації у системі EasyPay відповідальним менеджером.
`ServiceKey`	ідентифікатор сервісу торговця у системі EasyPay.	магазину чи послуги передається партнеру після реєстрації у системі EasyPay відповідальним менеджером.
`SecretKey`	секретний ключ для формування підпису	відомий лише торговцю та EasyPay передається партнеру після реєстрації у системі EasyPay відповідальним менеджером.
`AppId`	ідентифікатор торгової точки партнера	параметр валідний протягом 90 днів. Один і той же AppID може використовуватись для декількох платежів)
`PageId`	ідентифікатор сесії	параметр валідний протягом 20 хв. Для кожного запиту CreateOrder потрібно використовувати унікальний PageID

@@ Рядок 39: / Рядок 39: @@
 ----Партнер надає IP, з яких будуть здійснюватися запити.
 <br>
+<br>
+=== Реєстрація партнера в системі EasyPay ===
+----Реєстрація нового торговця передбачає отримання унікального ідентифікатора '''PartnerKey'''.
+===== Характеристика параметрів реєстрації =====
+<div style="overflow-x: auto; display: block; width: unset !important; height: auto !important; border: none;">
+  <table style="border-collapse: collapse; width: 100%; font-family: Roboto, sans-serif; font-weight: 100; font-size: 0.8em; color: #333;">
+    <!-- Перший рядок - заголовок -->
+    <tr>
+      <th style="border: none; border-bottom: 1px solid #d3d3d3; text-align: center; padding: 8px;">Параметр</th>
+      <th style="border: none; border-bottom: 1px solid #d3d3d3; text-align: center; padding: 8px;">Характеристика</th>
+      <th style="border: none; border-bottom: 1px solid #d3d3d3; text-align: center; padding: 8px;">Коментарій</th>
+    </tr>
+    <!-- Другий рядок -->
+    <tr>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;">'''<code>PartnerKey</code>'''</td>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;">унікальний ідентифікатор партнера (продавця) у системі EasyPay.</td>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; text-align: left;">передається партнеру після реєстрації у системі EasyPay відповідальним менеджером.</td>
+    </tr>
+    <!-- Третій рядок -->
+    <tr>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;">'''<code>ServiceKey</code>'''</td>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;">ідентифікатор сервісу торговця у системі EasyPay.</td>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; text-align: left;">магазину чи послуги
+передається партнеру після реєстрації у системі EasyPay відповідальним менеджером.
+</td>
+    </tr>
+    <!-- Четвертий рядок -->
+    <tr>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;">'''<code>SecretKey</code>'''</td>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;">секретний ключ для формування підпису</td>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; text-align: left;">відомий лише торговцю та EasyPay
+передається партнеру після реєстрації у системі EasyPay відповідальним менеджером.
+</td>
+    </tr>
+    <!-- П'ятий рядок -->
+    <tr>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;">'''<code>AppId</code>'''</td>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; padding-right: 10px; text-align: left;">ідентифікатор торгової точки партнера </td>
+      <td style="border: none; border-bottom: 1px solid #d3d3d3; text-align: left;">параметр валідний протягом 90 днів. Один і той же AppID може використовуватись для декількох платежів)</td>
+    </tr>
+    <!-- Шостий рядок -->
+    <tr>
+      <td style="border: none; padding-right: 10px; text-align: left;">'''<code>PageId</code>'''</td>
+      <td style="border: none; padding-right: 10px; text-align: left;">ідентифікатор сесії </td>
+      <td style="border: none; text-align: left;">параметр валідний протягом 20 хв. Для кожного запиту CreateOrder потрібно використовувати унікальний PageID</td>
+    </tr>
+  </table>
 <br>