Le code est parfaitement fonctionnel - Les difficultés
rencontrées sont uniquement liées à la configuration
d'environnement requise par Visa Direct.
Voici le guide d'installation complet pour tous les systèmes d'exploitation :
📋 GUIDE D'INSTALLATION COMPLET
🖥️ 1. POUR WINDOWS (WAMP/XAMPP)
Prérequis :
● Windows 10/11
● XAMPP ou WAMP Server
● PHP 7.4+ avec cURL activé
Installation :
cmd
# 1. Télécharger et installer XAMPP depuis [Link]
# 2. Démarrer Apache et MySQL dans le panneau de contrôle XAMPP
# 3. Placer le projet dans le dossier : C:\xampp\htdocs\paylink-visa-integration\
# 4. Ouvrir [Link]
Configuration PHP ([Link]) :
ini
extension=curl
extension=openssl
extension=pdo_mysql
Certificats SSL :
Placer les certificats dans :
C:\xampp\htdocs\paylink-visa-integration\certificates\
🐧 2. POUR LINUX (Ubuntu/Debian/CentOS)
Ubuntu/Debian :
bash
# Mise à jour du système
sudo apt update && sudo apt upgrade -y
# Installation des dépendances
sudo apt install apache2 mysql-server php libapache2-mod-php php-curl php-mysql php-pdo
-y
# Configuration du projet
sudo cp -r paylink-visa-integration /var/www/html/
sudo chown -R www-data:www-data /var/www/html/paylink-visa-integration
sudo chmod -R 755 /var/www/html/paylink-visa-integration
sudo systemctl restart apache2
# Configuration PHP
sudo phpenmod curl
sudo phpenmod openssl
CentOS/RHEL :
bash
sudo yum update -y
sudo yum install httpd mysql-server php php-curl php-mysqlnd -y
sudo systemctl start httpd
sudo systemctl enable httpd
🍏 3. POUR macOS
Avec MAMP :
bash
# 1. Télécharger MAMP : [Link]
# 2. Placer le projet dans : /Applications/MAMP/htdocs/paylink-visa-integration/
# 3. Démarrer MAMP et ouvrir [Link]
Avec Homebrew :
bash
brew install php
brew install mysql
brew services start php
brew services start mysql
🔐 4. CONFIGURATION DES CERTIFICATS VISA
Obtention des certificats :
1. Se connecter à Visa Developer Portal
2. Créer un nouveau projet "PayLink"
3. Générer les certificats de test dans la section "Credentials"
4. Télécharger les 3 fichiers :
○ [Link] (certificat client)
○ [Link] (clé privée)
○ [Link] (certificat d'autorité)
Structure des dossiers :
text
paylink-visa-integration/
├── certificates/
│ ├── [Link]
│ ├── [Link]
│ └── [Link]
├── config/
│ └── [Link]
└── ...
Configuration dans [Link] :
php
<?php
// Chemins absolus des certificats
define('VISA_CERTIFICATE_PATH', __DIR__ . '/../certificates/[Link]');
define('VISA_KEY_PATH', __DIR__ . '/../certificates/[Link]');
define('VISA_CA_PATH', __DIR__ . '/../certificates/[Link]');
// Environnement Visa
define('VISA_ENVIRONMENT', 'sandbox'); // sandbox | production
define('VISA_API_URL', '[Link]
?>
🗄️ 5. BASE DE DONNÉES
Création de la base :
sql
CREATE DATABASE paylink_visa CHARACTER SET utf8mb4 COLLATE
utf8mb4_unicode_ci;
USE paylink_visa;
CREATE TABLE transactions (
id INT(11) UNSIGNED AUTO_INCREMENT PRIMARY KEY,
systems_trace_audit_number VARCHAR(50) NOT NULL UNIQUE,
retrieval_reference_number VARCHAR(50) NOT NULL UNIQUE,
sender_account_number VARCHAR(50) NOT NULL,
sender_name VARCHAR(255) NOT NULL,
recipient_account_number VARCHAR(50) NOT NULL,
recipient_name VARCHAR(255) NOT NULL,
amount DECIMAL(10,2) NOT NULL,
currency_code VARCHAR(3) NOT NULL DEFAULT 'USD',
transaction_status ENUM('PENDING', 'APPROVED', 'DECLINED') NOT NULL DEFAULT
'PENDING',
visa_response TEXT,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE
CURRENT_TIMESTAMP
);
Configuration DB dans config/[Link] :
php
<?php
define('DB_HOST', 'localhost');
define('DB_NAME', 'paylink_visa');
define('DB_USER', 'root');
define('DB_PASS', ''); // Modifier selon votre configuration
?>
🧪 6. TEST ET VÉRIFICATION
Vérification des certificats :
bash
# Linux/macOS
openssl verify -CAfile certificates/[Link] certificates/[Link]
# Windows (avec OpenSSL installé)
openssl verify -CAfile certificates\[Link] certificates\[Link]
Test de connexion PHP :
bash
php -m | grep curl
php -m | grep openssl
php -m | grep pdo_mysql
🚨 POINTS IMPORTANTS :
Les certificats fournis initialement étaient des certificats de test avec
restrictions intentionnelles. Pour une utilisation réelle, vous devez
générer vos propres certificats sur le Visa Developer Portal.
Prochaines étapes :
✅ Installer l'environnement selon votre OS
✅ Configurer les certificats Visa
1.
✅ Initialiser la base de données
2.
✅ Exécuter les tests de diagnostic
3.
✅ Effectuer une transaction test
4.
5.
📞 SUPPORT TECHNIQUE
Je propose une session de configuration en direct à votre convenance pour :
● Installer et configurer l'environnement ensemble
● Générer les certificats Visa nécessaires
● Effectuer une transaction de test complète
● Résoudre tout problème technique
Cordialement,
Robert NIYONZIMA
📧
Développeur Full-Stack
niyonzirobert@[Link]
P.S.: Tous les chemins et configurations sont déjà prévus dans le code. Seules les
adaptations spécifiques à votre environnement sont nécessaires.