hubmais / h-smart-tef

1.0.2 2026-10-09 12:51 UTC

Requires

• php: ^7.2 || ^8.0
• hubmais/h-http-client: ^2.0

Requires (Dev)

• pestphp/pest: ^4.7

MIT

Published on Packagist.org on 2026-10-09 12:53 UTC

README

Esse plugin foi construído em PHP para a realização de ações na SmartPOS como um TEF via API Hubmais. Aqui vamos mostrar como é facil a instalação e utilização.

Requisitos

• php (versão 7.2 ou >=8.1)
• composer (mais recente)

Instalação

O plugin pode ser adicionado a seu projeto com o comando abaixo:

composer require hubmais/h-smart-tef

Laravel

Esse plugin pode ser usado em Laravel, a partir da versão 10. Após a instalação é necessário executar o comando abaixo:

php artisan vendor:publish --provider="Hubmais\HSmartTef\Providers\HSmartTefServiceProvider"

Depois é necessário configurar o arquivo de configuração, presente em config/h-client.php com as credenciais fornecidas.

Inicializando sem Facade

<?php

use Hubmais\HClient\Client;
use Hubmais\HSmartTef\Services\Manager as HSmartTefManager;

$client = new Client('<endpoint>');
$client->setMarketplaceId('');
$client->setSellerId('');
$client->setToken('');

$HSmartTef = new HSmartTefManager($client);

Listando terminais

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

$response = HSmartTef::terminals()->list();

foreach($reponse['data'] as $terminal)
{
    ...
}

Vendas

Criando venda PIX

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

$transaction = HSmartTef::transactions()->charge(
    $terminal['id'],
    amount: '100.00',
    paymentType: 'pix'
);

Criando venda no Cartão

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

$transaction = HSmartTef::transactions()->charge(
    $terminal['id'],
    amount: '100.00',
    paymentType: 'card', 
    paymentTax: 'buyer', # buyer ou seller
    intallments: 2,
    brand: 'Visa',
    requestId: '123'
);

Opções de gerenciamento

Desligar terminal

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::system()->shutdown();

Reiniciar terminal

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::system()->reboot();

Resetar senha administrativa

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::system()->adminPassordReset();

Atualizar tabelas

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::system()->syncTable();

Enviar notificação

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::notifications()->send($terminal['id'], 'Atenção', 'Atualizaremos seu terminal em alguns instantes.');

Requisitando dados

Requisitar CPF/CNPJ

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::requests()->doc($terminal['id']);

Requisitar Celular

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::requests()->phone($terminal['id']);

Requisitar IP

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::requests()->ip($terminal['id']);

Requisitar Serial

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::requests()->serial($terminal['id']);

Requisitar Versão do App

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::requests()->appVersion($terminal['id']);

Requisitar com Opções

<?php

use Hubmais\HSmartTef\Facades\HSmartTef;

HSmartTef::requests()->options(
    $terminal['id'],
    'Deseja CPF na nota?',
    [
        '1:Sim',
        '0:Não',
    ]
);