kenvel/laravel-tinkoff

Simple Tinkoff bank acquiring library.

dev-master 2022-04-20 11:39 UTC

This package is auto-updated.

Last update: 2024-05-20 16:19:45 UTC


README

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

Возможности

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

Установка

С помощью Composer:

composer require kenvel/laravel-tinkoff

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

use Kenvel\Tinkoff;

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

1. Инициализация

$api_url    = 'https://securepay.tinkoff.ru/v2/';
$terminal   = '152619634343';
$secret_key = 'terminal_secret_password';

$tinkoff = new Tinkoff($api_url, $terminal, $secret_key);

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);

//Контроль ошибок
if(!$paymentURL){
  echo($tinkoff->error);
} else {
  $payment_id = $tinkoff->payment_id;
  return redirect($result['payment_url']);
}

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

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

$status = $tinkoff->getState($payment_id)

//Контроль ошибок
if(!$status){
  echo($tinkoff->error);
} else {
  echo($status);
}

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

$status = $tinkoff->cencelPayment($payment_id)

//Контроль ошибок
if(!$status){
  echo($tinkoff->error);
} else {
  echo($status);
}

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

$status = $tinkoff->confirmPayment($payment_id)

//Контроль ошибок
if(!$status){
  echo($tinkoff->error);
} else {
  echo($status);
}

Donate button

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