Vinti4Net PHPPagamentos Vinti4 na sua aplicação.

Uma API PHP para preparar pagamentos, validar respostas e emitir recibos. Integração com a Rede Vinti4/SISP em Cabo Verde.

Começar a integrar

Novidades da v2.5.0

Compras com 3D Secure

Prepare a compra e os dados de billing, e encaminhe o cliente para introduzir os dados do cartão na Vinti4.

Configurar billing

Serviços e recargas

Prepare pagamentos por entidade e referência, ou recargas por telefone ou conta, com constantes de entidade.

Explorar operações

Respostas verificadas

Valide fingerprints e distinga pagamentos aprovados, erros e cancelamentos no callback.

Processar o retorno

Reembolsos

Prepare o estorno integral usando os dados da transação original guardados pela sua aplicação.

Preparar um estorno

Tokenização (v2.5)

Prepare adesão, compras, serviços, recargas e cancelamentos com tokens na API Composer.

Explorar tokenização

Recibos e DCC

Apresente recibos padrão ou personalizados, recibos de estorno e os valores de conversão DCC devolvidos pela SISP.

Conhecer os recibos

API fluente em PHP

Construa billing e dados da conta com métodos explícitos. Use Currency e Entity para identificar moedas e entidades.

Consultar a API

Comece com Composer

PHP 8.1+ e credenciais POS fornecidas pela SISP.

bash

composer require erilshk/vinti4net:^2.4

Da sua aplicação à Vinti4

php

use Erilshk\Sisp\Billing;
use Erilshk\Sisp\Vinti4Net;

$vinti4 = new Vinti4Net($posID, $authCode);

$billing = Billing::make()
    ->email('cliente@example.cv')
    ->country('132')
    ->city('Praia')
    ->address('Avenida Cidade de Lisboa')
    ->postalCode('7600');

$vinti4->setMerchant(Vinti4Net::generateMerchantRef())
    ->preparePurchase('1500', $billing);

echo $vinti4->createPaymentForm(
    'https://loja.example.cv/pagamentos/callback',
    'pt',
);

Receba e valide o resultado

No seu endpoint de callback, use as mesmas credenciais para processar o POST:

php

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

if ($response->hasInvalidFingerprint()) {
    http_response_code(400);
    exit('Resposta inválida.');
}

if ($response->isSuccess()) {
    // Confira referência, sessão e valor antes de confirmar o pedido.
}

Ver o guia completo

Projeto comunitário e independente

Este SDK não é oficial da SISP. A integração segue a especificação técnica disponibilizada pela entidade; o contrato, as credenciais e as orientações da SISP são a referência para o seu estabelecimento. Conheça o projeto e a Rede Vinti4.