TG Crypto Pay
Мерчант API (Розробникам)
API для мерчантів: застосунки, рахунки, перекази та вебхуки.
Що таке Мерчант API
Мерчант API — це платіжний API застосунку для бізнесу та ботів. Ви створюєте застосунок, отримуєте API-токен і з його допомогою виставляєте рахунки користувачам Telegram, надсилаєте їм виплати та перевіряєте баланс — усе з власного коду.
Як почати роботу з API
Створіть застосунок у Mini App, один раз скопіюйте його API-токен і починайте викликати API. Усі налаштування — у розділі Ще → Мерчант API.
Як підключити ШІ-агента
Дайте своєму ШІ-агенту одну адресу — https://crypto.tgpaybot.com/mcp — і він зробить інтеграцію платежів за вас: прочитає довідник API, створить мерчант-застосунок, налаштує вебхуки й напише код. Від вас потрібне одне підтвердження новому застосунку — однією кнопкою в боті. Термінал не потрібен, API-токен копіювати руками теж не доведеться.
Приймання платежів через рахунки
Рахунок — це спосіб виставити оплату користувачу Telegram. Ви створюєте його через API, надсилаєте платнику посилання, і сума зараховується на баланс вашого застосунку в момент підтвердження оплати.
Комісії та ліміти Мерчант API
Рахунки обкладаються комісією платформи, яка береться з того, що отримуєте ви; перекази та чеки обмежені лімітами за сумою. Цифри нижче — поточні налаштування, а не умови договору: якщо вони розходяться з тим, що ви бачите, має рацію застосунок, а надійне джерело — завжди ваші власні оплачені рахунки.
Довідник Мерчант API
Загальні правила, спільні для всіх методів, плюс методи читання каталогу. Посторінкові довідники методів: рахунки та повернення, перекази та чеки, підписки, вебхуки.
Довідник API: рахунки та повернення
Методи рахунків: createInvoice, getInvoices, deleteInvoice, refundInvoice. Загальні правила (автентифікація, конверт, суми, spend_id) — на сторінці Довідник Мерчант API; покроковий вступ — Приймання платежів через рахунки.
Довідник API: перекази та чеки
Методи виплат. Переказ надсилає кошти з балансу застосунку прямо в гаманець користувача Telegram; чек — це посилання на активацію, яке ви оплачуєте заздалегідь. Загальні правила (автентифікація, конверт, суми, spend_id) — на сторінці Довідник Мерчант API.
Довідник API: підписки
Регулярні платежі — розширення над Crypto Bot. Ви створюєте план (сума + період), надсилаєте користувачам посилання на підтвердження, і платформа списує оплату з балансу їхнього гаманця кожного періоду, зараховуючи її на баланс застосунку за вирахуванням комісії. Загальні правила — на сторінці Довідник Мерчант API.
Довідник API: вебхуки
Вебхуки доставляють події на ваш сервер у момент, коли вони стаються. Задайте застосунку Webhook URL у розділі Ще → Мерчант API — і платформа надсилатиме POST із підписаним JSON-тілом на кожну подію, на яку ви підписані.
Не знайшли відповідь? Напишіть людям.
Підтримка відповідає в Telegram цілодобово. Ніхто з підтримки ніколи не попросить ваш PIN або код з листа.