cashier-provider/sber-qr

Driver for payment with QR codes via Sber (see cashier-provider/core)

v3.0.0 2022-02-15 15:02 UTC

Requires

• php: ^7.3|^8.0
• cashier-provider/core: ^3.0
• cashier-provider/sber-auth: ^3.0
• psr/http-message: ^1.0

Requires (Dev)

• ext-json: *
• dragon-code/support: ^5.0
• illuminate/database: ^6.0|^7.0|^8.0
• orchestra/testbench: ^4.0|^5.0|^6.0
• phpunit/phpunit: ^9.0
• symfony/var-dumper: ^4.0|^5.0

MIT

• Andrey Helldar

• Bank
• qr
• billing
• cashier
• helldar
• sber
• andrey-helldar

README

Installation

To get the latest version of Sber QR Cashier Driver, simply require the project using Composer:

$ composer require cashier-provider/sber-qr

Or manually update require block of composer.json and run composer update.

{
    "require": {
        "cashier-provider/sber-qr": "^2.0"
    }
}

Using

Note:

This project is the driver for Cashier Provider.

Member ID and Terminal ID must be provided by the bank manager in response to the agreement concluded with the bank.

You can get the values of the client_id, client_secret, certificate file and certificate password yourself through the developer's personal account.

Configuration

Add your driver information to the config/cashier.php file:

use App\Models\Payment;
use App\Payments\Sber as SberQrDetails;
use CashierProvider\Core\Constants\Driver;
use CashierProvider\Sber\QrCode\Driver as SberQrDriver;

return [
    'payment' => [
        'map' => [
            Payment::TYPE_SBER => 'sber_qr'
        ]
    ],

    'drivers' => [
        'sber_qr' => [
            Driver::DRIVER  => SberQrDriver::class,
            Driver::DETAILS => SberQrDetails::class,

            Driver::CLIENT_ID       => env('CASHIER_SBER_QR_CLIENT_ID'),
            Driver::CLIENT_SECRET   => env('CASHIER_SBER_QR_CLIENT_SECRET'),

            'member_id'   => env('CASHIER_SBER_QR_MEMBER_ID'),
            'terminal_id' => env('CASHIER_SBER_QR_TERMINAL_ID'),

            'certificate_path' => storage_path(env('CASHIER_SBER_QR_CERTIFICATE_PATH')),

            'certificate_password' => env('CASHIER_SBER_QR_CERTIFICATE_PASSWORD'),
        ]
    ]
];

Resource

Create a model resource class inheriting from CashierProvider\Sber\QrCode\Resources\Model in your application.

Use the $this->model link to refer to the payment model. When executed, the $model parameter will contain the payment instance.

namespace App\Payments;

use CashierProvider\Sber\QrCode\Resources\Model;

class Sber extends Model
{
    protected function paymentId(): string
    {
        return (string) $this->model->id;
    }

    protected function sum(): float
    {
        return (float) $this->model->sum;
    }

    protected function currency(): int
    {
        return $this->model->currency;
    }

    protected function createdAt(): Carbon
    {
        return $this->model->created_at;
    }

    public function getMemberId(): string
    {
        return config('cashier.drivers.sber_qr.member_id');
    }

    public function getTerminalId(): string
    {
        return config('cashier.drivers.sber_qr.terminal_id');
    }

    public function getCertificatePath(): ?string
    {
        return config('cashier.drivers.sber_qr.certificate_path');
    }

    public function getCertificatePassword(): ?string
    {
        return config('cashier.drivers.sber_qr.certificate_password');
    }
}

Custom Authentication

In some cases, the application can send requests to the bank from different terminals. For example, when one application serves payments of several companies.

In order for the payment to be authorized with the required authorization data, you can override the clientId and clientSecret methods:

namespace App\Payments;

use CashierProvider\Sber\QrCode\Resources\Model;
use Illuminate\Support\Facades\Storage;

class Sber extends Model
{
    protected $bank;

    protected function paymentId(): string
    {
        return (string) $this->model->id;
    }

    protected function sum(): float
    {
        return (float) $this->model->sum;
    }

    protected function currency(): int
    {
        return $this->model->currency;
    }

    protected function createdAt(): Carbon
    {
        return $this->model->created_at;
    }

    protected function clientId(): string
    {
        return $this->bank()->client_id;
    }

    protected function clientSecret(): string
    {
        return $this->bank()->client_secret;
    }

    public function getMemberId(): string
    {
        return $this->bank()->member_id;
    }

    public function getTerminalId(): string
    {
        return $this->bank()->terminal_id;
    }

    public function getCertificatePath(): ?string
    {
        return Storage::disk('cashier')->path(
            $this->bank()->certificate_path
        );
    }

    public function getCertificatePassword(): ?string
    {
        return $this->bank()->certificate_password;
    }

    protected function bank()
    {
        if (! empty($this->bank)) {
            return $this->bank;
        }

        return $this->bank = $this->model->types()
            ->where('type', Payment::TYPE_SBER)
            ->firstOrFail()
            ->bank;
    }
}

Response

All requests to the bank and processing of responses are carried out by the Cashier Provider project.

To get a link, contact him through the cast:

use App\Models\Payment;

public function getQrCode(Payment $payment): string
{
    return $payment->cashier->details->getUrl();
}

Available Methods And Details Data

$payment->cashier->external_id
// Returns the bank's transaction ID for this operation

$payment->cashier->details->getStatus(): ?string
// Returns the text status from the bank
// For example, `CREATED`.

$payment->cashier->details->getUrl(): ?string
// If the request to get the link was successful, it will return the URL
// For example, `https://sberbank.ru/qr/?dynamicQr=<hash>`

$payment->cashier->details->toArray(): array
// Returns an array of status and URL.
// For example,
//
// [
//     'url' => 'https://sberbank.ru/qr/?dynamicQr=<hash>',
//     'status' => 'CREATED'
// ]