Эквайринг/приём платежей на сайте через Яндекс кассу

Ссылка на скачивание библиотеки для работы с Яндекс-касссой на PHP - https://github.com/yandex-money/yandex-checkout-sdk-php/archive/master.zip

Тестирование приёма платежей в Яндекс-кассе осуществляется на тестовом Интернет магазине shopid api_key которые доступны по ссылке - . Таким образом Вы можете интегрировать яндекс-кассу к своему проекту вовсе не имея аккаунта в яндекс, не говоря уже о аккаунте в яндекс кассе. Для запуска же реального проекта, вам потребуется зарегистрировать аккаунт в яндекс-кассе а далее заполнить анкету о Вашем интернет магазине. В личном кабинете яндекс-кассу указан бесплатный номер в коде 8 800, рекомендую позвонить по нему и уточнить детали по интеграции к Вашему магазину.

В яндекс-кассе предусмотрена возможность использования ОФД(онлайн кассы партнёров, благодаря которой информация о купленных у Вас товарах направляется в налоговую). Яндекс касса не обязует Вас использовать ОФД и не проверяет делаете Вы это или нет. В любом случаи для соблюдения законодательства если Вы будите использовать ОФД не партнёров яндекс кассы, Вам в случаях предусмотренных законом организовать отправку данных в налоговую инспекцию самостоятельно.

Информация по подключению библиотеки к существующему проекту и созданию экземпляра класса объекта - https://github.com/yandex-money/yandex-checkout-sdk-php

Описание работы с методами библиотеки яндекс-кассы для php - https://kassa.yandex.ru/docs/checkout-api/?php#platezhi

Номера банковских карт для тестирования работы приёма оплаты при установленном shopId тестового магазина - https://kassa.yandex.ru/developers/using-api/testing

Пример скрипта создающего платёж и получающего url для оплаты на стороне яндекс-кассы

<?php
require $_SERVER['DOCUMENT_ROOT'] . "/local/templates/main/phpscripts/yandex-kassa/lib/autoload.php";//подключаем класс для работы с яндекс-кассой

use YandexCheckout\Client;//Импортируем класс

$client = new Client();//Создаём экземпляр объекта
$client->setAuth('54401', 'test_Fh8hUAVVBGUGbjmlzba6TB0iyUbos_lueTHE-axOwM0');//Устанавливаем данные для тестового магазина(на рабочем проекте потребуется заменить на настоящие данные магазина, которые можно посмотреть в личном кабинете яндекс-кассы).

$idempotenceKey = uniqid('', true);//Создаём идентификатор платежа

$response = $client->createPayment(
  array(
    "capture"=>true,//после оплаты не требуется подтверждение от владельца интернет-магазина о том что оплата принята магазином. Если установлен в true после успешной оплаты статус будет succeeded, а если не устанавливать этот жлемент массива то waiting_for_capture(так же после успешной оплаты)
    "amount" => array(
    "value" => "1333.33",//Сумма платежа
    "currency" => "RUB",//Валюта
    ),
    "payment_method_data" => array(
    "type" => "bank_card",//Способ оплаты - банковская карта
    ),
    "confirmation" => array(
      "type" => "redirect",
      "return_url" => "https://domen.ru/local/templates/main/ajax/yapayment.php",//после оплаты клиент будет перенаправлен на этот url
    ),
    "description" => "Заказ №72",// Яндекс-касса не обязует Вас делать description уникальным для каждого заказа, тем не менее лучше это сделать
  ),
  $idempotenceKey//Уникальный ключ сгенерированный выше
);

// после выполнения запроса яндекс-касса не должна возвращать статус canceled. Отсутствие этого статуса означает что яндекс-касса вернула confirmation_url - то есть URL на который необходимо перенаправить клиента для оплаты, то есть ввода информации о банковской карте.
$confirmation_url = false;
if(isset($response->status) and ($response->status != "canceled") and isset($response->confirmation->confirmation_url) and $response->confirmation->confirmation_url) {
  $confirmation_url = $response->confirmation->confirmation_url;
}

// тут получаем переменную $confirmation_url которая или равна false или содержит URL для перенаправления для совершения оплаты клиентом

Скрипт проверки статуса платежа с фиксированием факта оплаты в bitrix

<?php
require $_SERVER['DOCUMENT_ROOT'] . "/local/templates/main/phpscripts/yandex-kassa/lib/autoload.php";
      
use YandexCheckout\Client;
      
$client = new Client();
$client->setAuth('54401', 'test_Fh8hUAVVBGUGbjmlzba6TB0iyUbos_lueTHE-axOwM0');
      
$status = false;//Статус успешной оплаты. Если true - заказ успешно оплачен, если false - заказ не оплачен
$paymentId = "";
$paymentId2 = "";
if (isset($_REQUEST["payid"]) and $_REQUEST["payid"]) {
  $paymentId2 = $_REQUEST["payid"];
  if (isset($_COOKIE["yaKa$paymentId2"]) and $_COOKIE["yaKa$paymentId2"]) {
    $paymentId = $_COOKIE["yaKa$paymentId2"];
  }
}
unset($paymentId2);
      
if ($paymentId) {
  try {
    $payment = $client->getPaymentInfo($paymentId);//$paymentId);//Если на метод передать некорректный Id платежа, то обработка скрипта остановится, чтобы этого не произошло обязательно обрабатываем ситуацию с исключением по try - catch
  } catch (Exception $e) {}
}
      
// Виды положительных статусов
//waiting_for_capture - ожидает подтверждения. Может быть обработан через API - метод - подтверждение платежа или ЛК Яндекс-кассы
//succeeded - если при запросе платежа capture=true после подтверждения оплаты ожидается этот статус
if (isset($payment->status) and (($payment->status == "succeeded") or ($payment->status == "waiting_for_capture"))) {
  $status = true;
  if (isset($payment->description) and $payment->description) {
    $description = $payment->description;
	$description = explode(" №",$description);
    if (count($description) == 2) {
      $description = trim($description[1]);
	  if ($description and ((($description * 1) . "") == ($description . ""))) {
        CSaleOrder::PayOrder($description, "Y");// Устанавливаем факт оплаты
        CSaleOrder::DeliverOrder($description,"Y");// Указываем что доставка разрешена
      }
    }
  }
}
//var_dump($payment->description);// Если что в этой переменной хранится description заказа тот который передавался при создании платежа
      
?>
Статус Вашего платежа: <?php if ($status) {echo "<span style=\"color: green;\">заказ успешно оплачен</span>";} else {echo "<span style=\"color: red;\">ошибка платежа</span>";} ?>.

Метод фиксации факта оплаты был найден по ссылке http://know-online.com/post/bitrix-status-zakaza

Пример скрипта создающего платёж и получающего url для оплаты на стороне яндекс-кассы

Скрипт проверки статуса платежа с фиксированием факта оплаты в bitrix

Комментарии