# Добро пожаловать!

в документацию платежной системы CactusPay. Тут мы поможем Вам интегрировать наш сервис в Ваш сайт либо бота и поможем в работе с API.


# Начало работы

Чтобы начать пользоваться кассой, вам требуется оставить заявку на подключение и получить личный TOKEN магазина.\
Заполните нужные данные на [странице](https://lk.cactuspay.pro/shop) и нажмите кнопку "Отправить".<br>

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2FSVLA1xtTYDLDb7TmVVfv%2Fimage.png?alt=media&amp;token=31e44e5b-be9e-4f1b-973a-15878d277cc9" alt=""><figcaption><p>Инструкции заполнения данных магазина</p></figcaption></figure>

После одобрения заявки на подключение, Вам будет доступна страница с настройками вашего магазина.<br>

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2FtnAMIPWHi1CgO2kSMY0C%2Fimage.png?alt=media&amp;token=dae91f7b-2a9d-4cc3-a776-7ae8b2c5654f" alt=""><figcaption></figcaption></figure>

Вы можете создать платеж на странице настроек или через API сайта.\
Для этого вам потребуется ключ магазина, который вы можете взять нажав кнопку "Управление".

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2FYioBoQBo6Uq9BiElyccX%2Fimage.png?alt=media&amp;token=55ad89c9-118e-45ba-a624-8e31686235b6" alt=""><figcaption></figcaption></figure>


# API


# Создание платежа

<mark style="color:green;">`POST`</mark> <https://lk.cactuspay.pro/api/?method=create>

#### Параметры body `application/json`

<table><thead><tr><th width="169">Имя</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>token <mark style="color:red;"><code>*</code></mark></td><td>STRING</td><td>Ключ вашего магазина, держите его в секрете</td></tr><tr><td>order_id</td><td>STRING</td><td>Уникальный номер платежа в вашей системе</td></tr><tr><td>amount <mark style="color:red;"><code>*</code></mark></td><td>FLOAT</td><td>Сумма платежа</td></tr><tr><td>description</td><td>STRING</td><td>Описание платежа</td></tr><tr><td>h2h</td><td>BOOL</td><td>Включение h2h метода</td></tr><tr><td>user_ip</td><td>STRING</td><td>IP пользователя для h2h метода (Обязательно при h2h)</td></tr><tr><td>method</td><td>STRING</td><td>card, sbp, yoomoney, crypto, nspk</td></tr></tbody></table>

\ <mark style="color:purple;">**yandex-tips**</mark>

Ответ вы получите:

```json
{
    "status": "success",
    "response": {
        "url": "https://pay.cactuspay.pro/2117529",
        "requisite": {
            "status": "success",
            "response": {
                "until": "Wed, 12 Feb 2025 22:50:52 +0300",
                "until_timestamp": 1739389852,
                "amount": 1625,
                "receiverQR": "https://qr.nspk.ru/AD20006HE9CEMV769MF8RA2HI4K9QD5B?type=02&bank=100000000123&sum=175500&cur=RUB&crc=ADE2",
                "order_id": "5b9a6715fe93a8a1cff1f64de4f5da"
            }
        }
    }
}
```


# Отправка чека по уже созданному платежу

Если при создания платежа мы получаем  request\_check: true

<mark style="color:green;">`POST`</mark> <https://lk.cactuspay.pro/api/receipt>

#### Параметры body `multipart/form-data`

<table><thead><tr><th width="169">Имя</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>token <mark style="color:red;"><code>*</code></mark></td><td>STRING</td><td>Ключ вашего магазина, держите его в секрете</td></tr><tr><td>order_id <mark style="color:red;"><code>*</code></mark></td><td>STRING</td><td>Уникальный номер платежа выданный в h2h или на странице оплаты</td></tr><tr><td>receipt <mark style="color:red;"><code>*</code></mark></td><td>FILE</td><td>Чек</td></tr></tbody></table>


# Создание спора по платежу

<mark style="color:green;">`POST`</mark> <https://lk.cactuspay.pro/client/payment/dispute/create>

#### Параметры body `form-data`

<table><thead><tr><th width="169">Имя</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>order_id<mark style="color:red;"><code>*</code></mark></td><td>STRING</td><td>Уникальный номер реквизитов</td></tr><tr><td>file<mark style="color:red;"><code>*</code></mark></td><td>FILE</td><td>Чек</td></tr></tbody></table>

Ответ вы получите:

```json
{
    "status": "success"
}
```


# Информация по платежу

Запрос:

<mark style="color:green;">`POST`</mark> <https://lk.cactuspay.pro/api/?method=get>

`application/json`

<table><thead><tr><th width="169">Имя</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>token <mark style="color:red;"><code>*</code></mark></td><td>STRING</td><td>Ключ вашего магазина, держите его в секрете</td></tr><tr><td>order_id <mark style="color:red;"><code>*</code></mark></td><td>STRING</td><td>Уникальный номер платежа в вашей системе</td></tr></tbody></table>

Ответ вы получите:\
\*Данные находятся в response\*

`application/json`

<table><thead><tr><th width="169">Имя</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>id</td><td>NUMBER</td><td>Уникальный номер платежа в нашей системе</td></tr><tr><td>order_id</td><td>STRING</td><td>Уникальный номер платежа в вашей системе</td></tr><tr><td>amount</td><td>STRING</td><td>Сумма платежа</td></tr><tr><td>status</td><td>STRING</td><td>Статус платежа: ACCEPT, WAIT</td></tr></tbody></table>


# Webhook

На странице настроек магазина, вы можете добавить ссылку для оповещения состояния платежей<br>

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2FeHvqvbVK4c0l03Wuy7tz%2Fimage.png?alt=media&amp;token=255f7e8e-d810-40b3-be2b-e09e517a3877" alt=""><figcaption><p>"Оповещение о платеже"</p></figcaption></figure>

Вы начнете получать уведомления в случае успешной оплаты платежа:

<mark style="color:green;">`POST`</mark>

`application/x-www-form-urlencoded`

<table><thead><tr><th width="177">Имя</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>id</td><td>STRING</td><td>Уникальный номер платежа в нашей системе</td></tr><tr><td>order_id</td><td>STRING</td><td>Уникальный номер платежа в вашей системе</td></tr><tr><td>amount</td><td>FLOAT</td><td>Сумма платежа</td></tr></tbody></table>

\
**После получения Webhook вам требуется&#x20;**<mark style="color:red;">**проверить статус платежа**</mark>**, отправив запрос:**\
Информация по платежу - <mark style="color:green;"><https://lk.cactuspay.pro/api/?method=get></mark>\
ACCEPT / WAIT


# Отмена реквизитов транзакции h2h

Если вы хотите отменить транзакции запрошенные через h2h до истечения срока, вам потребуется:

Запрос:

<mark style="color:green;">`POST`</mark> <https://lk.cactuspay.pro/api/?method=CANCEL\\_DETAILS>

`application/json`

<table><thead><tr><th width="169">Имя</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>token <mark style="color:red;"><code>*</code></mark></td><td>STRING</td><td>Ключ вашего магазина</td></tr><tr><td>order_id <mark style="color:red;"><code>*</code></mark></td><td>STRING</td><td>Уникальный номер платежа в вашей системе</td></tr></tbody></table>

При успешном запросе вы получите ответ:

```json
{
    "status": "success"
}
```


# Экспорт платежей

<mark style="color:green;">`POST`</mark> <https://lk.cactuspay.pro/client/shop/export>

#### Параметры body `application/json`

<table><thead><tr><th width="169">Имя</th><th width="121">Тип</th><th>Описание</th></tr></thead><tbody><tr><td>token <mark style="color:red;"><code>*</code></mark></td><td>STRING</td><td>Ключ вашего магазина, держите его в секрете</td></tr><tr><td>dateFrom <mark style="color:red;"><code>*</code></mark></td><td>NUMBER / STRING</td><td>Дата начала в UNIX или ISO 8601</td></tr><tr><td>dateTo <mark style="color:red;"><code>*</code></mark></td><td>NUMBER / STRING</td><td>Дата начала в UNIX или ISO 8601</td></tr></tbody></table>

Ответ вы получите:

```json
{
    "status": "success",
    "response": {
        "payments": [],
        "statistics": {
            "totalAmount": 0,
            "totalProfit": 0,
            "totalCount": 0
        }
    }
}
```

payments  &#x20;

```json
"id": 0,
"type": "ONE-TIME", // ONE-TIME / MULTIPLY
"orderId": "***",
"amount": 0,
"profit": 0,
"formattedDate": "15.05.2025 15:57:34",
"timestampDate": 1747313854,
"requisites": "***",
"rate": 94.304,
"status": "WAIT" // WAIT / ACCEPT
```


# Как сделать интернет-магазин в Telegram на Python и CactusPay

В этой статье мы поможем вам развернуть свой Магазин на Python и

Telegram продолжает завоёвывать аудиторию. Для многих пользователей это главный мессенджер, площадка для общения, развлечений, обмена новостями, полезной информацией. Каналы, ленты, чаты собирают тысячи реакций и комментариев.

В поисках клиентов платформу для рекламы активно использует бизнес, размещает тематический контент, делает рассылки, продвигает бренды, продаёт через специальные интернет-магазины.

## Получите Ключ бота от BotFather

Вам нужно перейти в телеграмм по ссылке: <https://t.me/BotFather> и нажать кнопку Start

Нажмите на кнопку <mark style="color:blue;">/newbot</mark> из меню<br>

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2Fg9T0wYkPh8KJe9M9HMPV%2Fimage.png?alt=media&amp;token=b28f95e2-a8f8-4e39-805b-b21243578c81" alt=""><figcaption></figcaption></figure>

Вам предложат выбрать имя для Бота, введите его<br>

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2Fcat3e7OcU5k7bl0vYhHV%2Fimage.png?alt=media&amp;token=c3afcfd6-6709-44b9-b645-b45fb2d76538" alt=""><figcaption></figcaption></figure>

После, вас просят ввести Идентификатор бота, он должен оканчиваться на bot или \_bot

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2FlCvlY4ZZt3n6nz2ujwxN%2Fimage.png?alt=media&amp;token=89fc34cb-eda7-4099-a9c8-298ac9b6e721" alt=""><figcaption></figcaption></figure>

Если вы ввели все верно, вы увидите, что вам предоставили ключ от бота, он вам потребуется при подключении.\
Пример: 7260116160:AAGvWsSaLG8mB0uvuSqTBPYHP8omefy04F0

## Получите номер вашего чата

Чтобы получить номер вашего чата, который будет использован как Админ панель, перейдите по ссылке в телеграмм: <https://t.me/getmyid_bot>\
\
Нажмите кнопку Start и вам напишут ваш номер<br>

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2FMSUZ0GuCw5quFGuOIdKR%2Fimage.png?alt=media&amp;token=735d2388-4b72-4952-b8b6-3e9c73ff29cb" alt=""><figcaption></figcaption></figure>

Пример: 7481917786\ <br>

## Начало развертывания

Скачайте и распакуйте файл. Вам потребуется открыть папку в любом текстовом редакторе.\
Замените данные в файле settings.ini, на те, что мы получили ранее

{% file src="/files/WgTyMnY8dwBWmqAOgwhD" %}

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2FMxffzXbgpvqsbz0V8uDU%2Fimage.png?alt=media&amp;token=038bfe59-01b9-40f8-a591-3587516057db" alt=""><figcaption></figcaption></figure>

## Бот готов к запуску

Вам потребуется запустить main.py Файл и предварительно установив его зависимости

## Добавить CactusPay к боту

Вам потребуется добавить ключ магазина, нажмите в боте на кнопку /start, затем на 🔑 Платежные системы, 🌵 CactusPay

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2FpZAFuE0gwt40zAMQICuf%2Fimage.png?alt=media&amp;token=4f0d6cd0-24b6-4382-9275-f3ebb80cdc64" alt=""><figcaption></figcaption></figure>

Нажмите кнопку Изменить\
И вставьте ваш TOKEN из личного кабинета и нажмите кнопку закрыть\
Пример: L8Px6eepZqQmQrt49ju8

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2F94Mz9v0gFR7NBAr4aZJG%2Fimage.png?alt=media&amp;token=5860b0ab-61ea-4e20-aa81-41775c8c8d28" alt=""><figcaption></figcaption></figure>

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2FOZuSnGq7ecLQVLC7yL5w%2Fimage.png?alt=media&amp;token=a0c5fa43-df32-47a8-bb16-e43532a6f870" alt=""><figcaption></figcaption></figure>

В вкладке Способы пополнения, вам потребуется включить оплату от CactusPay<br>

<figure><img src="https://861868634-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz1wYHo8soPIg0mRkWv0g%2Fuploads%2Fpchmh3B7YUsJtLflm44S%2Fimage.png?alt=media&amp;token=4d1beed5-92db-417a-ac67-eba7c16292e2" alt=""><figcaption></figcaption></figure>

## Завершение

Вы настроили оплату и бота от CactusPay. Теперь вы можете добавить товары и запустить бота для общего пользования