PHPackages                             lava-payment/lava - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. lava-payment/lava

ActiveLibrary[Payment Processing](/categories/payments)

lava-payment/lava
=================

Lava Payment SDK

v2.0.1(2mo ago)964.7k↓67.2%1MITPHPPHP >= 7.4 || >=8.0CI passing

Since Nov 9Pushed 2mo agoCompare

[ Source](https://github.com/LavaDevelop/lava-sdk)[ Packagist](https://packagist.org/packages/lava-payment/lava)[ RSS](/packages/lava-payment-lava/feed)WikiDiscussions main Synced today

READMEChangelog (4)Dependencies (6)Versions (9)Used By (0)

Lava SDK
========

[](#lava-sdk)

[![compatible](https://camo.githubusercontent.com/00685b222e0f0c245540bf6a09a2ad54b3402f942f9cc8b33de0767169fa8aef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545372e342d677265656e3f7374796c653d706c6173746963)](https://camo.githubusercontent.com/00685b222e0f0c245540bf6a09a2ad54b3402f942f9cc8b33de0767169fa8aef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545372e342d677265656e3f7374796c653d706c6173746963)

SDK для работы с API Lava через фасад `Lava\Api\Http\LavaFacade`.

Установка
---------

[](#установка)

```
composer require lava-payment/lava
```

Быстрый старт
-------------

[](#быстрый-старт)

### Инициализация (только shop-методы)

[](#инициализация-только-shop-методы)

```
use Lava\Api\Http\LavaFacade;

$facade = new LavaFacade(
    'shop_secret_key',
    'shop_id',
    'shop_webhook_additional_key' // optional
);
```

### Инициализация для profile/payoff методов

[](#инициализация-для-profilepayoff-методов)

Для методов профиля и вывода (`createPayoff`, `getStatusPayoff`, `getPayoffTariffs`, `checkWallet`, `getProfileBalance`, `checkPayoffSignature`) нужно передать `ProfileSecretDto`.

```
use Lava\Api\Dto\Secret\ProfileSecretDto;
use Lava\Api\Http\LavaFacade;

$profileSecret = new ProfileSecretDto(
    'profile_id',
    'profile_secret_key',
    'profile_additional_key' // optional, нужен для checkPayoffSignature
);

$facade = new LavaFacade(
    'shop_secret_key',
    'shop_id',
    'shop_webhook_additional_key',
    null,
    null,
    null,
    $profileSecret
);
```

Методы фасада
-------------

[](#методы-фасада)

### Инвойсы

[](#инвойсы)

#### Создание платежа `createInvoice`

[](#создание-платежа-createinvoice)

```
use Lava\Api\Dto\Request\Invoice\CreateInvoiceDto;

$dto = new CreateInvoiceDto(
    '300.09',
    'order-1001',
    'https://example.com/hook',
    'https://example.com/success',
    'https://example.com/fail',
    300,
    '{"productId":39}',
    'Pay product'
);

$response = $facade->createInvoice($dto);
```

Возвращает `CreatedInvoiceDto`.

#### Статус платежа `checkStatusInvoice`

[](#статус-платежа-checkstatusinvoice)

```
use Lava\Api\Dto\Request\Invoice\GetStatusInvoiceDto;

$dto = new GetStatusInvoiceDto(null, $invoiceId); // по invoiceId
$response = $facade->checkStatusInvoice($dto);
```

Возвращает `StatusInvoiceDto`.

#### Доступные тарифы `getAvailibleTariffs`

[](#доступные-тарифы-getavailibletariffs)

```
$tariffs = $facade->getAvailibleTariffs();
```

Возвращает массив объектов `AvailibleTariffDto`.

### Возвраты

[](#возвраты)

#### Создание возврата `createRefund`

[](#создание-возврата-createrefund)

```
use Lava\Api\Dto\Request\Refund\CreateRefundDto;

$dto = new CreateRefundDto(
    'invoice-id',
    null,
    100.00
);

$response = $facade->createRefund($dto);
```

Возвращает `CreatedRefundDto`.

#### Статус возврата `checkStatusRefund`

[](#статус-возврата-checkstatusrefund)

```
use Lava\Api\Dto\Request\Refund\GetStatusRefundDto;

$dto = new GetStatusRefundDto($refundId);
$response = $facade->checkStatusRefund($dto);
```

Возвращает `StatusRefundDto`.

### Баланс

[](#баланс)

#### Баланс профиля `getProfileBalance`

[](#баланс-профиля-getprofilebalance)

```
$profileBalance = $facade->getProfileBalance();
```

Возвращает `ProfileBalanceDto`.

#### Баланс магазина `getShopBalance` (deprecated)

[](#баланс-магазина-getshopbalance-deprecated)

```
$shopBalance = $facade->getShopBalance();
```

Метод помечен как deprecated. Используйте `getProfileBalance()`.

### Выводы (Payoff)

[](#выводы-payoff)

#### Создание вывода `createPayoff`

[](#создание-вывода-createpayoff)

```
use Lava\Api\Dto\Request\Payoff\CreatePayoffDto;

$dto = new CreatePayoffDto(
    'withdraw-order-1',
    10.00,
    'lava_payoff'
);

$response = $facade->createPayoff($dto);
```

Возвращает `CreatedPayoffDto`.

#### Статус вывода `getStatusPayoff`

[](#статус-вывода-getstatuspayoff)

```
use Lava\Api\Dto\Request\Payoff\GetPayoffStatusDto;

$dto = new GetPayoffStatusDto(null, $payoffId);
$response = $facade->getStatusPayoff($dto);
```

Возвращает `StatusPayoffDto`.

#### Тарифы вывода `getPayoffTariffs`

[](#тарифы-вывода-getpayofftariffs)

```
$tariffs = $facade->getPayoffTariffs();
```

Возвращает массив DTO тарифов вывода.

#### Проверка кошелька `checkWallet`

[](#проверка-кошелька-checkwallet)

```
use Lava\Api\Dto\Request\Payoff\CheckWalletRequestDto;

$dto = new CheckWalletRequestDto('lava_payoff', 'wallet_value');
$response = $facade->checkWallet($dto);
```

Возвращает `CheckWalletResponseDto`.

### Вебхуки и подписи

[](#вебхуки-и-подписи)

#### Проверка подписи shop webhook `checkSignWebhook`

[](#проверка-подписи-shop-webhook-checksignwebhook)

```
$data = file_get_contents('php://input');
$headers = getallheaders();

if (!isset($headers['Authorization'])) {
    throw new Exception('Authorization header is required');
}

$isValid = $facade->checkSignWebhook($data, $headers['Authorization']);
```

#### Проверка подписи payoff webhook `checkPayoffSignature`

[](#проверка-подписи-payoff-webhook-checkpayoffsignature)

```
$data = file_get_contents('php://input');
$headers = getallheaders();

if (!isset($headers['Authorization'])) {
    throw new Exception('Authorization header is required');
}

$isValid = $facade->checkPayoffSignature($data, $headers['Authorization']);
```

Исключения
----------

[](#исключения)

При ошибках API методы выбрасывают исключения (например, `InvoiceException`, `PayoffException`, `RefundException`, `BaseException` и другие). Рекомендуется оборачивать вызовы фасада в `try/catch` и логировать сообщение и код ошибки.

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance83

Actively maintained with recent releases

Popularity37

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~396 days

Total

3

Last Release

87d ago

Major Versions

v1.0.2.x-dev → v2.0.02026-04-08

PHP version history (2 changes)v1.0.2.x-devPHP >= 7.4

v2.0.0PHP >= 7.4 || >=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/4ca86fa2049104a8f8f21417c0b086bc1794bbab8fcd8cea6d81100094dc4a81?d=identicon)[LavaDevelop](/maintainers/LavaDevelop)

---

Top Contributors

[![LavaDevelop](https://avatars.githubusercontent.com/u/117733336?v=4)](https://github.com/LavaDevelop "LavaDevelop (11 commits)")

---

Tags

lavalava-sdklava payment

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/lava-payment-lava/health.svg)

```
[![Health](https://phpackages.com/badges/lava-payment-lava/health.svg)](https://phpackages.com/packages/lava-payment-lava)
```

###  Alternatives

[omnipay/coinbase

Coinbase driver for the Omnipay payment processing library

18579.5k1](/packages/omnipay-coinbase)[msilabs/bkash

bKash Payment Gateway API for Laravel Framework.

181.2k](/packages/msilabs-bkash)[binkode/laravel-paystack

A description for laravel-paystack.

112.1k](/packages/binkode-laravel-paystack)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)