/p24api

Privat24 merchant API

Primary LanguagePHPGNU General Public License v3.0GPL-3.0

Privat24

Это PHP API для мерчанта Privat24.

Инструкция по установке находится здесь.

Использование

Данная библиотека работает только совместно с Composer'ом

<?php
  require (vendor/autoload.php);

  use halt\P24\Merchant

  $id = <Merchant Id>;
  $password = "<Merchant Password>";

  $merchant = new Merchant(['id'=>$id, 'password'=>$password]);

  // Баланс и информация о карте мерчанта по-умолчанию
  // которая привязана к мерчанту
  $balance = $merchant->balance();
  $info    = $merchant->info();

  // Кроме карты по-умолчанию можно получить информацию и баланс
  // о других картах мерчанта
  $card = "<Any merchant card or account>";
  $balance = $merchant->account($card)->balance();
  $info    = $merchant->account($card)->info();
?>

Возвращаемые значения - это массив значений, которые описаны на сайте API Приват24

Баланс

$balance = [
  'av_balance'   // Доступные средства. Это средства, которыми можно оперировать
  'bal_date'     // Дата баланса
  'bal_dyn'      // ?? - описание на сайте отсутсвует
  'balance'      // Полный баланс. Сюда входят, в т.ч. средства, заблокированные на карте (HOLD)
  'fin_limit'    // Кредитный лимит. Например на кредитной карте
  'trade_limit'  // ?? - описание на сайте отсутсвует
];

Информация о карте/счёте

$info = [
  'account'          // Счет карты
  'acc_name'         // Название счёта ("Виртуальный счет Приват24")
  'acc_type'         // Тип счёта  (CM, CC, ??)
  'card_number'      // Номер карты
  'main_card_number' // Номер основной карты
  'card_type'        // Тип карты ("Карта для выплат")
  'currency'         // Валюта (UAH, USD, EUR, ...)
  'card_stat'        // Статус карты (NORM - всё ОК, RSTR - заблокирована, ??)
  'src'              // ?? - описание на сайте отсутсвует (M)
];

Ошибки

Если во время запроса произошла ошибка, то в ответе вернётся не массив значений, а сообщение от банка с описанием ошибки:

invalid signature

или такое

Сервис балансов временно недоступен

Если в ответ сервера будет подписан не верной сигнатурой (проверяется библиотекой), то в ответе будет содержаться

Wrong response signature!