Наверх
К списку статей

Мой блог

Модуль uAPI на php для Точка банк

Простой и мощный модуль на PHP для интеграции с Tochka Bank uAPI. Позволяет работать с выписками, балансом, вебхуками и создавать ссылки на оплату (Эквайринг). 

Это первая версия модуля, в которой есть вопросы по безопасности и прочие моменты. Не нужно использовать его в своем проекте без некоторых доработок исходя из потребностей.

✨ Возможности

  • 📄 Выписки: Получение банковских выписок в синхронном режиме.
  • 💰 Баланс: Мгновенная проверка доступного остатка на счете.
  • 🔗 Эквайринг: Генерация платежных ссылок (СБП, карты, QR).
  • ⚓ Вебхуки: Готовый обработчик входящих платежей с уведомлениями в Telegram.
  • 📥 Импорт: Скрипт для удобного импорта транзакций в вашу БД.

🚀 Быстрый старт

1. Требования

  • PHP 7.4 или выше
  • Расширение curl и pdo_mysql
  • Аккаунт в Банке Точка с доступом к uAPI

2. Установка

Просто скопируйте папку bank_module в ваш проект.

3. Настройка БД

Выполните SQL-запрос для создания необходимых таблиц:

CREATE TABLE `incomes` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `amount` decimal(15,2) NOT NULL,
  `date` date NOT NULL,
  `description` text,
  `external_id` varchar(255) DEFAULT NULL,
  `is_verified` tinyint(1) DEFAULT 0,
  PRIMARY KEY (`id`),
  UNIQUE KEY `external_id` (`external_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `settings` (
  `setting_key` varchar(255) NOT NULL PRIMARY KEY,
  `setting_value` text
);

 

4. Конфигурация

Переименуйте db.php.example в db.php и введите данные вашей базы данных. Затем добавьте ключи API Точки в таблицу settings.

🛠 Примеры использования

Получение баланса

require_once 'api/tochka_service.php';
$tochka = new TochkaService($jwt, $client_id, $account, $bik);
echo "Баланс: " . $tochka->getBalance() . " руб.";

Создание ссылки на оплату

$link = $tochka->createPaymentLink(1000.50, "Оплата заказа #123", "https://your-site.com/success");
echo "Оплатите здесь: " . $link['data']['Data']['paymentLink'];

🔒 Безопасность

Файл db.php автоматически исключен из Git через .gitignore, чтобы ваши пароли не попали в публичный доступ. Для работы на сервере используйте переменные окружения или защищенные файлы конфигурации.

📄 Лицензия

Данный проект распространяется под лицензией MIT. Подробнее см. в файле LICENSE.


Сделано для упрощения работы с API Банка Точка.

Поделиться:
Как вам статья? Выберите реакцию, чтобы оценить материал


Комментарии

0

Оставить комментарий

Комментарий появится на странице после проверки модератором.

Пока нет комментариев. Будьте первым!

К списку статей