Vinti4NetLegacy v3.0

Vinti4Net Legacy v3.0.0

Major update of Vinti4Net Legacy, modernizing the SDK while maintaining compatibility with PHP 5.6+.

Highlights

• Reworked transaction API for purchases, service payments, recharges and refunds.
• Improved request and response fingerprint validation.
• Added normalized response statuses and operation detection.
• Improved 3D Secure billing support and DCC handling.
• Added automatic merchant reference and session generation.
• Added PAN masking and stronger request validation.
• Removed the BCMath dependency.
• The SDK can now be reused for multiple transactions.
• Improved compatibility with the modern erilshk/vinti4net API.

Standalone

Vinti4NetLegacy.php can be used directly without Composer or external dependencies.

require_once 'path_to/Vinti4NetLegacy.php';

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

Requirements

• PHP 5.6+
• Composer is optional

Note: v3.0 contains breaking changes from the 2.x API.

Full Changelog: v2.0.0...v3.0.0

🚀 Vinti4Net Legacy SDK v2.0.0

O que mudou?

🔧 API Mais Simples

- $vinti4->preparePurchasePayment(1500, $billing, 'CVE');
+ $vinti4->preparePurchase(1500, $billing, 'CVE');

- $vinti4->prepareRefundPayment(1500, 'REF', 'SESS', 'TXN', 'CP');
+ $vinti4->prepareRefund(1500, 'TXN', 'CP');

🆕 Novos Métodos

// Define merchant reference e session
$vinti4->setMerchant('REF123', 'SESS456');

// Suporte a idiomas no formulário
$form = $vinti4->createPaymentForm($url, 'en'); // 'pt', 'en', 'fr'

🔄 Refund Simplificado

// Antes - exigia todos os parâmetros
- prepareRefundPayment($amount, $merchantRef, $merchantSession, $transactionID, $clearingPeriod)

// Agora - apenas essenciais  
+ prepareRefund($amount, $transactionID, $clearingPeriod)

🎯 O Que Mudou

Método	v1.x	v2.0
Compra	preparePurchasePayment()	preparePurchase()
Recarga	prepareRechargePayment()	prepareRecharge()
Reembolso	prepareRefundPayment()	prepareRefund()
Formulário	createPaymentForm($url, $ref)	createPaymentForm($url, $lang)

📋 Migração Rápida

1. Atualize nomes dos métodos - remova "Payment" dos finais
2. Use setMerchant() para referência e sessão
3. Ajuste refunds - remova merchantRef e merchantSession
4. Adicione idioma nos formulários

⚡ Benefícios

• ✅ Código mais limpo
• ✅ Menos parâmetros
• ✅ Melhor experiência developer
• ✅ Compatível com PHP 5.6+
• ✅ Backward compatible com gateway

Upgrade rápido e seguro! 🎉

Full Changelog: v1.0.0...v2.0.0

Release v1 — Initial Release

🎉 Release v1.0.0 — Initial Release

Este é o primeiro release oficial do Vinti4Net Legacy PHP SDK, uma biblioteca destinada a integrar aplicações PHP (incluindo versões antigas como PHP 5.6) com o gateway de pagamentos Vinti4Net / SISP Cabo Verde.

✅ Inclusões neste release inicial

• Implementação completa do SDK Legacy
• Suporte aos principais fluxos de pagamento do SISP
• Geração de formulário HTML auto-submit para redirecionamento
• Cálculo e validação de fingerprints
• Processamento da resposta do gateway
• Normalização de dados de pagamento e billing (Purchase Request)
• Estrutura mínima de testes

📦 Instalação (Packagist)

composer require erilshk/vinti4net-legacy

📝 Observação

Nos assets abaixo pode baixar a classe com documentação em Português.

Esta versão é destinada a manter compatibilidade com projetos legados.
Para novos desenvolvimentos, considere usar o SDK moderno como erilshk\vinti4net.