Contraste Pay — Encaissez vos paiements Wave & Orange Money

Ce que vous obtenez

Tout inclus, 100 % gratuit

Aucun frais d'utilisation, aucune commission sur vos transactions. Contraste Pay est libre d'utilisation à titre personnel ou pour votre entreprise.

🌊

Encaissement Wave Sénégal

Recevez des paiements Wave de vos clients. L'intégration API Wave est déjà faite — il vous suffit de renseigner vos propres accès Wave Business.

🟠

Encaissement Orange Money SN

Recevez des paiements Orange Money. L'intégration API est prête — renseignez vos identifiants Orange Money Marchands et c'est parti.

📊

Dashboard intuitif

Visualisez toutes vos transactions, suivez vos encaissements et gérez votre activité depuis une interface claire et moderne.

🔒

100 % Auto-hébergé

Vos données et transactions restent sur votre propre serveur. Personne d'autre n'y a accès — ni nous, ni aucun tiers.

⚡

API REST complète

Connectez n'importe quelle application à votre passerelle de paiement via une API sécurisée et documentée.

🚀

Déploiement en une commande

Une seule image Docker. Migrations et configuration automatiques au démarrage. Mises à jour sans perte de données.

Prochainement

Ce qui arrive bientôt

Contraste Pay évolue pour couvrir l'ensemble de l'écosystème financier en Afrique de l'Ouest.

BIENTÔT

🎵

Mixx By Yas

Intégration du service de paiement Mixx By Yas pour offrir encore plus de moyens de paiement à vos clients.

BIENTÔT

💸

Envoi d'argent (Send Money)

Effectuez des transferts et envois d'argent directement depuis Contraste Pay vers des comptes Wave ou Orange Money.

PRIORITÉ HAUTE

🏦

API PI-SPI — BCEAO

Intégration de l'API Business de la Banque Centrale des États de l'Afrique de l'Ouest. Paiements interbancaires et services financiers réglementés à l'échelle de l'UEMOA.

À VENIR

🔗

Agrégateurs de paiement

Connexion aux principaux agrégateurs locaux pour une couverture maximale.

PayDunya Intech PayTech + d'autres

Guide d'installation

Installation complète

Suivez ces étapes dans l'ordre. Prérequis : avoir Docker installé sur votre serveur.

⚠️

Avant de commencer — Obtenez vos accès Wave et Orange Money

Contraste Pay a déjà intégré les API Wave Sénégal et Orange Money Sénégal. Mais vous devez effectuer vos propres démarches auprès de chaque opérateur pour obtenir vos identifiants API (accès Marchand / Business) :

Se rendre sur Wave Business et créer un compte marchand pour obtenir votre clé API Wave
Contacter Orange Money Sénégal pour obtenir vos identifiants API Marchand

Une fois ces accès en main, renseignez-les dans votre fichier de configuration ci-dessous.

Créer le fichier de configuration

Copiez ce contenu dans un fichier nommé contraste-pay.env sur votre serveur et remplissez les valeurs marquées.

# --- Base de données -------------------------------------------------

DB_USER=postgres

DB_PASSWORD=CHANGER_CE_MOT_DE_PASSE

DB_NAME=contraste_pay

# --- Sécurité — générer avec : openssl rand -hex 64 ------------------

JWT_SECRET=CHANGER_CETTE_CLE_SECRETE

TOKEN_EXPIRE_TIME=7d

# --- générer avec : openssl rand -hex 32

FIELD_ENCRYPTION_KEY=CHANGER_CETTE_CLE_CHIFFREMENT

# --- API (ne pas modifier) -------------------------------------------

API_PORT=3000

API_PREFIX=/api

NODE_ENV=production

# --- Email SMTP ------------------------------------------------------

SMTP_HOST=smtp.example.com

SMTP_PORT=587

SMTP_USER=votre@email.com

SMTP_PASS=VOTRE_MOT_DE_PASSE_SMTP

EMAIL_FROM=noreply@votre-domaine.com

💡 Les valeurs en rouge sont obligatoires à modifier. Les autres peuvent rester telles quelles.

Générer les clés secrètes

Exécutez ces commandes sur votre serveur pour générer des clés sécurisées, puis copiez les valeurs dans votre contraste-pay.env.

# Générer JWT_SECRET

openssl rand -hex 64

# Générer FIELD_ENCRYPTION_KEY

openssl rand -hex 32

Lancer le conteneur

Une seule commande suffit. L'application démarre, les migrations s'appliquent et le seed s'exécute automatiquement.

docker run -d \

-p 80:3001 \

--restart unless-stopped \

--name contraste-pay \

--env-file contraste-pay.env \

-v contraste-pay-db:/var/lib/postgresql/data \

-v contraste-pay-redis:/var/lib/redis \

contrastesn/contraste-pay:latest

↑

Mise à jour vers une nouvelle version

Vos données sont préservées. Les nouvelles migrations s'appliquent automatiquement au redémarrage. Le docker pull est obligatoire — sans lui Docker réutilise l'ancienne image en cache et la mise à jour n'est pas appliquée.

# 1. Récupérer la nouvelle image depuis Docker Hub

docker pull contrastesn/contraste-pay:latest

# 2. Arrêter le conteneur (les volumes sont conservés)

docker stop contraste-pay && docker rm contraste-pay

# 3. Relancer — migrations et seed appliqués automatiquement

docker run -d \

-p 80:3001 \

--restart unless-stopped \

--name contraste-pay \

--env-file contraste-pay.env \

-v contraste-pay-db:/var/lib/postgresql/data \

-v contraste-pay-redis:/var/lib/redis \

contrastesn/contraste-pay:latest

⚙

Gestion du conteneur

# Arrêter (données conservées)

docker stop contraste-pay

# Redémarrer

docker start contraste-pay

# Voir les logs en direct

docker logs -f contraste-pay

# État des processus internes

docker exec contraste-pay supervisorctl status

# Accès base de données

docker exec -it contraste-pay su-exec postgres psql -U postgres -d contraste_pay

Encaissez vos paiements Wave & Orange Money sur votre serveur