README

Biblioteca PHP estável e compativel com erilshk\vinti4net para integração com o Vinti4Net (SISP – Cabo Verde), com suporte total a:

Compras (3D Secure)
Pagamentos de serviços
Recargas
Estornos (Refund)
DCC (Dynamic Currency Conversion)
Fingerprints SHA512

Apesar de ter sido projetada para funcionar em ambientes modernos, a biblioteca mantém compatibilidade com PHP 5.6+, tornando-a ideal para sistemas legados que precisam de uma solução atualizada, segura e bem estruturada.

⚠️ Considere usar erilshk\vinti4net para php +8.1

📚 Instalação

Via Composer:

composer require erilshk/vinti4net-legacy

Ou manualmente, incluindo a classe diretamente no seu projeto legado.

baixar aqui

🔧 Exemplo rápido de uso

Criar pagamento (3D Secure)

require 'Vinti4NetLegacy.php';

$vinti4 = new Vinti4NetLegacy('POS123', 'ABCDEF123456');

$html = $vinti4
    ->preparePurchasePayment(1500, [
        'user' => [
            'email'   => 'cliente@example.com',
            'country' => '132',
            'city'    => 'Praia',
            'address' => 'Safende',
            'postCode'=> '7600'
        ]
    ])
    ->createPaymentForm('https://seusite.cv/retorno');

echo $html;

Isso irá gerar um formulário HTML com auto-submit apontando para o Vinti4Net.

🔄 Processar retorno do pagamento

$response = $vinti4->processResponse($_POST);

if ($response['status'] === 'SUCCESS') {
    echo "Pagamento concluído!";
} elseif ($response['status'] === 'CANCELLED') {
    echo "O utilizador cancelou a operação.";
} else {
    echo "Falha: " . $response['message'];
}

A resposta já vem normalizada e inclui:

success
message
dcc (se aplicável)
debug (em caso de fingerprint inválido)

🧩 Métodos principais

🔹 preparePurchasePayment()

Prepara um pagamento de compra com 3D Secure.

🔹 prepareServicePayment()

Pagamentos de serviços com entidade + referência.

🔹 prepareRechargePayment()

Recargas de contas ou cartões.

🔹 prepareRefundPayment()

Reembolso de transações anteriores.

🔹 setRequestParams()

Define parâmetros adicionais opcionais.

🔹 createPaymentForm()

Gera o formulário HTML que inicia a transação.

🔹 processResponse()

Valida e interpreta as respostas do SISP.

🛠️ Requisitos

PHP 5.6+
Extensões:
- json
- bcmath

🔐 Segurança

Fingerprint SHA512 implementado conforme especificações do SISP no código MOP021
Sanitização e normalização de todos os campos enviados
Prevenção de valores inesperados durante preparação do pedi

📜 Licença

MIT — livre para uso pessoal e comercial.

👨‍💻 Autor

Eril TS Carvalho Criador e mantenedor do SDK Legado.

erilshk / vinti4net-legacy

Maintainers

Details