jumas-cola/laravel-tinkoff

Simple Tinkoff bank acquiring library.

dev-master 2024-02-15 09:10 UTC

This package is auto-updated.

Last update: 2024-05-15 09:43:35 UTC


README

Простая библиотека для приема платежей через интернет для Тинькофф банк.

Возможности

  • Генерация URL для оплаты товаров
  • Подттверждение платежа
  • Просмотр статуса платжа
  • Отмена платежа

Установка

С помощью Composer:

composer require jumas-cola/laravel-tinkoff

Форк библиотеки kenvel/laravel-tinkoff

Подключение в контроллере:

use Kenvel\Tinkoff;

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

1. Настройка

Добавить в файл .env и опубликовать конфигурацию через php artisan vendor:publish:

#Tinkoff
TINKOFF_TERMINAL_ID=1111111111111DEMO
TINKOFF_SECRET_KEY=xxxxxxxxxxxxxxxx

2. Получить URL для оплаты

//Подготовка массива с данными об оплате
$payment = [
    'OrderId'       => '123456',        //Ваш идентификатор платежа
    'Amount'        => '100',           //сумма всего платежа в рублях
    'Language'      => 'ru',            //язык - используется для локализации страницы оплаты
    'Description'   => 'Some buying',   //описание платежа
    'Email'         => 'user@email.com',//email покупателя
    'Phone'         => '89099998877',   //телефон покупателя
    'Name'          => 'Customer name', //Имя покупателя
    'Taxation'      => 'usn_income'     //Налогооблажение
];

//подготовка массива с покупками
$items[] = [
    'Name'  => 'Название товара',
    'Price' => '100',    //цена товара в рублях
    'NDS'   => 'vat20',  //НДС
];

//Получение url для оплаты
$paymentURL = Tinkoff::paymentURL($payment, $items);

3. Получить статус платежа

//$payment_id Идентификатор платежа банка (полученый в пункте "2 Получить URL для оплаты")

$status = Tinkoff::getState($payment_id)

4. Отмена платежа

$status = Tinkoff::cancelPayment($payment_id)

5. Подтверждение платежа

$status = Tinkoff::confirmPayment($payment_id)

6. Проверка нотификации со стстусом платежа

$is_valid = Tinkoff::checkNotification($request->all())

Donate button

Если вы нашли этот проект полезным, пожалуйста сделайте небольшой донат - это поможет мне улучшить код