# Capusta.space {% hint style="info" %} Програма лояльності для промокоду **«Salebot»**: Тариф становить 5 відсотків, без обмеження строку та без потреби підтверджувати статус самозайнятості. Крім іншого, без додаткової оплати та без комісій ви можете одразу отримати доступ до всіх функцій сервісу: рахунків, інвойсів, підписки, доставки файлів після оплати, стрімінгових віджетів, партнерської програми. Партнерська програма дозволить залучати клієнтів і приносити додатковий дохід у розмірі 0,2% від їхніх транзакцій. {% endhint %} ## Зареєструватися Після реєстрації в сервісі у налаштуваннях вашого проєкту з’являться потрібні вам дані: **код проєкту(project\_code)** - у прикладі **це токен testsalebot для API** - 71b7d77f-7c77-77cb-7f7a-bbc7a17c1e77 **ваш Email (на який ви зареєстровані)** - Окрім цих даних, вам також потрібно буде заповнити форму в розділі "Повідомлення та перенаправлення" за посиланням ; Перейшовши за посиланням, трохи прокрутіть униз і знайдіть таке вікно: !!!!! Використайте кнопку "Вказати URL" і заповніть у формі такі дані: * Ваша пошта для входу в обліковий запис Capusta.space * останні 4 цифри прив’язаної картки * - callback url * - success url * - fail url !!!!!! ## Налаштування підключення Щоб підключити платіжну систему Capusta, вам потрібно буде ввести свій токен і код проєкту в налаштуваннях Salebot. У Salebot ми відкриваємо розділ платіжних систем, обираємо capusta і вводимо отримані дані. ![](/files/7b24780ec3757aa9a7af899d6c435a35a685add3) ## Генерація посилання для оплати Щоб згенерувати посилання для оплати, потрібно встановити значення змінної payment\_sum (наприклад, 1000), після чого з’являється змінна capusta\_pay\_url. Цю змінну можна вивести з посиланням або розмістити на кнопці з текстом "Оплатити". Посилання має вигляд: Також перед встановленням значення payment\_sum можна вказати такі необов’язкові змінні для налаштування платежу: payment\_description - опис платежу link\_expired - термін дії посилання. Ви можете ввести дату у форматі dd.mm.yyyyyyyyyyyyyyyyy hh:mm, наприклад: â 03.04.2022 19:34'. Увага! Час формується за часовим поясом проєкту. payment\_comment - ви можете дозволити користувачеві, який платить, залишити коментар до переказу. test\_payments - ви можете виконати тестовий платіж у Capusta, якщо вкажете для цієї змінної значення True. Детальніше про те, які картки можна вказувати для тестових транзакцій, ви можете дізнатися на сторінці https\:/dev.capusta.space/#rec240878484 !!!!!! ### Приклад посилання на оплату Створіть посилання на оплату 1 долара (зверніть увагу - суми менше 10 рублів не проходять до оплати!) !!!!! {% hint style="info" %} Примітка: спочатку для налаштувань вказуються додаткові змінні, потім payment\_sum. {% endhint %} Ви можете визначати змінні раніше в ланцюжку, а не в одному блоці — це приклад. Далі в потрібному місці виведіть змінну capusta\_pay\_url, яка містить посилання !!!!! ## Обробка результату платежу (callback про оплату) Після успішної оплати в бот надійде callback, за яким можна зрозуміти, що платіж було успішно здійснено. Ці callback у системі ви бачите як повідомлення від користувача, тож вони не можуть бути надіслані користувачем; вони складаються з перших 10 символів токена та слова success, наприклад: 71b7d77f-7\_success Ці callback НЕ ВИДНО користувачеві, вони відображаються лише оператору. Тип порівняння має бути "Повне співпадіння" Також після успішної оплати змінній capusta\_payment\_completed присвоюється значення true. Наприклад, ви можете зробити блок обробки успішної оплати з умовою та вивести користувачеві відповідне повідомлення: !!!!!! Після завершення оплати клієнту буде додано змінну capusta\_callback\_data, яка містить дані відповіді платіжної системи щодо завершеної транзакції. Необхідні дані можна отримати зі словника за допомогою методу get. ## Створення підписки Створення підписки доступне в capusta. Для цього потрібно присвоїти будь-яке значення змінній capusta\_subscription\_payment, і тоді буде створено щомісячну підписку. Якщо ви хочете вказати інший період, створіть змінну capusta\_subscription\_period і присвойте їй одне з таких значень: daily - "DAILY", weekly - "WEEKLY", monthly - "MONTHLY", "SELECTIVELY" - це вибір користувача (у цьому разі платник сам обирає частоту списання) Приклад (як виглядає платіж, коли використовується значення "SELECTIVELY") !!!!! Після успішного оформлення підписки в клієнта з’явиться змінна capusta\_subscriber\_id, що вказує номер підписника в системі Capusta. !!!!! ## Скасування підписки Щоб скасувати наявну підписку, потрібно використати функцію capusta\_remove\_subscription(capusta\_subscriber\_id), яка приймає на вхід той самий номер підписника Capusta. Після виклику функції змінна capusta\_subscriber\_id буде очищена, а підписку буде скасовано. !!!!! --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/uk/integrations/payment/capusta.space.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.