Skip to content

andrew-demb/monobank-api-community-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 

Repository files navigation

Monobank API community docs

logo

Більшість інформації у поточному репозиторії буде відноситись саме до Monobank open API.

Щодо інших API див. інформацію нижче.

Інформація структурована силами community користувачів Monobank API на основі практичного досвіду використання або зворотнього зв'язку представників Monobank у Telegram чаті community (посилання на чат доступне на сторінці документації до API)

API

Monobank Open API - API що доступне публічно (без аутентифікації), або клієнтам банку за токеном аутентифікації, або провайдерам послуг.

Link на документацію щодо Monobank Open API:

Розробкою цієї частини API займається лише один розробник Monobank за власною ініціативою та займається його розвитком у вільний час. З чого випливає, що можливості його розширення або підтримки щодо питань досить обмежені.

За багатьма причинами (в тому числі - безпековими) Open API надає можливість використання лише "Read-only" операції. Можливостей формування тих чи інших транзакцій або змінювання даних клієнту немає.

Тільки розробник може надати абсолютно точну та вичерпну інформацію по даному API.

Корпоративний API для провайдерів послуг

"Production" доступ до API надається ЛИШЕ після підтвердження заявки відправленої через API: https://api.monobank.ua/docs/corporate.html#tag/Avtorizaciya-ta-nalashtuvannya-kompaniyi/paths/~1personal~1auth~1registration/post

Алгоритм підпису запитів до API ("X-Sign" HTTP header): https://gist.github.com/Sominemo/64845669d6326f2f73d356f025656bdb#signing-the-request

Telegram API community

У Telegram створено чат для спільноти користувачів Monobank Open API для наступного:

  • надання зворотного зв'язку щодо користування API;
  • взаємодопомога користувачів щодо питань використання API;

Для збереження балансу корисної інформації у чаті та економії часу інших учасників чату, вважається хорошим тоном:

  • не використовувати чат як фріланс біржу;
  • не використовувати чат як "кружок програмістів";
  • обговорювати теми близькі саме до питань користування Monobank Open API;
  • поважати час інших та ознайомлюватись з інформацією наданою тут, у закріплених повідомленнях чату, документації.

Посилання на чат доступне на сторінці документації до API.

Незадокументовані особливості API

1. Обмеження максимальної кількості платежів повернутих на один запит до API

Endpoint виписки транзакцій (docs) за одне звернення повертає не більше 500 транзакцій відсортованих з кінця періоду (тобто від часу to до from).

Можлива причина введеного обмеження на кількість результатів та відсутність інструментів пагінації з offset - https://use-the-index-luke.com/sql/partial-results/fetch-next-page

Рекомендації:

  • Якщо кількість транзакцій = 500 - необхідно виконати додатковий запит змінивши (зменшивши) час to до часу останнього платежу, з відповіді.
  • Якщо знову кількість транзакцій = 500 - необхідно виконувати запити до того часу поки кількість транзакцій не буде < 500.
  • Відповідно якщо кількість транзакцій < 500 - всі платежі за вказаний період було отримано успішно.

Часті питання

1. Чи можна отримати теги створені користувачем до платежів з виписки?

Ні. Коли це буде доступно - невідомо.

Troubleshooting

1. Помилка при зверненні до API - 403 status code з HTML у тілі відповіді

Якщо при роботі з API Ви отримуєте помилку 403 - скоріше за все вас заблокував AWS (що "захищає" API від атак зловмисників).

Нажаль, ні розробники (представники банку), ні community не можуть допомогти з розблокуванням.

Тіло відповіді може виглядати наступним чином:

 <html>
    <head>
      <title>403 Forbidden</title>
    </head>
    
    <body>
      <center>
        <h1>403 Forbidden</h1>
      </center>
    </body>
</html>

Інші API створені командою mono

Monobank має не тільки open API, але й інші:

  1. Інтернет-еквайринг
  2. Покупка частинами
  3. Expirenza by mono (shaketopay)

Щодо даних сервісів Вам можуть надати консультацію співробітники Monobank, до яких Ви можете звернутись за каналами комунікації що надані на лендінг сторінках сервісів.

1. Інтернет-еквайринг (acquiring)

Посилання на лендінг сторінку сервісу: https://monobank.ua/e-comm

Посилання на документацію: https://api.monobank.ua/docs/acquiring.html

Wordpress plugin

Офіційний модуль WordPress від Monobank для підключення інтернет-еквайрингу: https://uk.wordpress.org/plugins/monopay/

Інструкція з підключення:

  1. Заповніть заявку за посиланням https://www.monobank.ua/e-comm
  2. Отримайте підтвердження про відкриття послуги (у застосунок)
  3. Завантажте модуль. Інструкція з інсталяції модуля доступна за посиланням https://doc.clickup.com/d/4e3cn-16048/monobank-woo-commercepaymentgateway

2. Покупка частинами

Посилання на лендінг сторінку сервісу: https://chast.monobank.ua/vendors

Посилання на документацію: https://u2-demo-ext.mono.st4g3.com/docs/index.html

3. Expirenza by mono (shaketopay)

Посилання на лендінг сторінку сервісу: https://shaketopay.com.ua/

Посилання на документацію: https://api.shaketopay.com.ua/

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published