Merchant Guide
  • Загальна інформація
    • 🌐Прозора Мережа
      • План інтеграції
      • Довідник
    • ✅Основний сценарій розрахунів (e-commerce)
    • 📶Варіанти інтеграції
    • 🎨Design guide
  • 🪜Етапи інтеграції
    • 1️⃣Підготовка до інтеграції
    • 2️⃣Налаштування доступів
    • 3️⃣Оновлення інтерфейсів
    • 4️⃣Функціональна інтеграція
    • 5️⃣Функціональне тестування
    • 6️⃣Конфігурація середовища
    • 7️⃣Операційна підтримка
  • ⚒️API методи
    • Особливості роботи з API
    • Замовлення та QR код
      • Create_order v.2.0
    • Callback про платіж
  • ℹ️Дані документа
    • Історія версій
    • Журнал змін API запитів
Powered by GitBook
On this page
  1. API методи

Замовлення та QR код

Дана сторінка описує метод генерації платіжної сторінки "Прозорої Мережі" на основі інформації про замовлення клієнта

Create merchant's order

За результатами замовлення товару/ послуги на сайті або в торговій точці, а також за умови обрання покупцем форми "оплати в Прозорій Мережі", Мерчанти звертаються до системи "Прозора Мережа" за методом POST/create_merchant's_order для формування "платіжної сторінки" з QR кодом та діплінками.

JWT:

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI2MjNlNDYwYi05ZmZkLTQxZGYtOWUzMS1mNThmNmJlMWFjMWIiLCJleHAiOjE3MTQxMjU5NzEsImlhdCI6MTcxMjEwNTk3MSwiYW10IjoxMDAwLCJjdXIiOiJVQUgiLCJyZWYiOiJkNGVlMDZmIiwicHJwIjoi0J7Qv9C70LDRgtCwINC30LAg0YfQtdGA0LLQtdC90YwgMjAyMyJ9.mNKlUM-B2Q_bTexvfKRk188gJhsiRdlFNLa61UCYkjqOL4vJJ4rq9awnM_dRbkNY43oKnOiS7WJr-od8r_snfDKQGLFu7GaWRkFdZMpsBxyI57aqg5MoZ_ZY2ouBSIUGWAPUAgsk2BZgyc8DQZFOG1Qq_SSLMW_xoLlJ18mvmSA56rgvYRxOzA5xLmbHPKXkC_MwfPYpm6DoKmfjHtlL4xgkuboW61CL7ex9rJGbf7JHal_RBRZhyMdFF82LeGE9PoJvGMSFjFaRqjWE_5shDaGww29id42GFTUxltwvI8d8-vlOgwT2EZb7SNBqtPkV0ZwS0wLGkOCWjfb-K6jWog

Payload запиту

{

"sub": "623e460b-9ffd-41df-9e31-f58f6be1ac1b", - uuid Мерчанта

"exp": 1714125971, - термін замовлення

"iat": 1712105971, - час створення замовлення

"amt": 1000, - сума замовлення

"cur": "UAH", - валюта замовлення

"ref": "d4ee06f", - номер замовлення

"prp": "text" - призначення платежу

}

Приклад відповіді (response)

{

}

Endpoints:

PreviousОсобливості роботи з APINextCreate_order v.2.0

Last updated 1 year ago

"id":"3aa202bc-6b20-445d-89698274b11c66d0", "link_deeplinks":"", "link_qr":""

⚒️
https://api.admin.smaug.armenotech.dev/api/v1/merchants/order?id=3aa202bc-6b20-445d-8969-8274b11c66d0&mobile=1
https://api.admin.smaug.armenotech.dev/api/v1/merchants/order?id=3aa202bc-6b20-445d-8969-8274b11c66d0&mobile=0

Creates an order for Merchant

post
Query parameters
jwtstringRequired

QR Order data

Responses
200
Returns guid of created order & links leading to QR
application/json
400
bad request
application/json
500
something went wrong
application/json
post
POST /api/v1/merchants/order?jwt=text HTTP/1.1
Host: 
Accept: */*

{
  "id": "453f2c43-7f99-483d-8644-e2512a6b63ab",
  "link_qr": "https://gollum-sep24.armenotech.dev/api/v1/merchants/order?id=e06bd48f-0ac3-4280-831a-49bc00dc4b98",
  "link_deeplinks": "https://gollum-sep24.armenotech.dev/api/v1/merchants/order?id=e06bd48f-0ac3-4280-831a-49bc00dc4b98&mobile=1"
}

Get HTML page containing QR code of the order or deeplinks for banks

get
Query parameters
idstringRequired

Order GUID

mobileintegerOptional

to show mobile version of page or not

Responses
200
Returns HTML with QR code image and bank links
303
Redirects to merchant's redirect_url in case of error
400
bad request
application/json
500
something went wrong
application/json
get
GET /api/v1/merchants/order?id=text HTTP/1.1
Host: 
Accept: */*

No content
  • Create merchant's order
  • POSTCreates an order for Merchant
  • GETGet HTML page containing QR code of the order or deeplinks for banks