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

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


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

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

<figure><img src="/files/dlqkVMbwzq5HrYw8IH4e" alt=""><figcaption><p>Инструкции заполнения данных магазина</p></figcaption></figure>

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

<figure><img src="/files/DGOgzfkoqBkoxMm67KjM" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/HfUKIWJc4G2UDyOY3tqR" 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="/files/20tfuweSB68NmhWl6Hbd" 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="/files/5aqVLctsXfVLNrlpXbl7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/OUJSf9mid92W8jwNV3WY" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/vxLucVGHewAEG3ItZwGi" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="/files/tPeeOtrvu8TXzRj4K0jQ" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="/files/X11L52uNlaKNZLsp9Bff" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="/files/kVMsr5LsqYh7t4aUZB63" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/uC5UxTE3VknDPMvlT14z" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OnoZHsTiMzD8x1NFl1jn" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/rMsSLLBTgw8nRoKariEq" alt=""><figcaption></figcaption></figure>

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

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