Contraste Pay

Encaissez vos paiements Wave, Orange Money & PI-SPI BCEAO sur votre serveur

Contraste Pay est 100 % gratuit et auto-hébergé. Zéro commission, zéro frais. Vos données restent sur votre propre serveur. Vous apportez vos accès API — nous avons déjà fait l'intégration.

Démarrer en 3 étapes Nous contacter
Intégrations disponibles Wave Sénégal Orange Money Sénégal PI-SPI BCEAO
$ docker run -d \
  -p 80:3001 \
  --restart unless-stopped \
  --env-file contraste-pay.env \
  contrastesn/contraste-pay:latest

Pulling from contrastesn/contraste-pay
✓ Status: Downloaded newer image
✓ PostgreSQL initialisé
✓ Migrations appliquées
✓ API démarrée sur le port 3000
✓ Frontend prêt sur le port 3001
API en ligne
Base de données
Redis
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.

🏦

PI-SPI BCEAO — QR Code interopérable

Acceptez les paiements QR Code de n'importe quelle banque UEMOA. L'intégration PI-SPI est disponible — configurez vos accès BCEAO et générez vos QR EMV en quelques secondes.

📊

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.

À 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 API

Contraste Pay a déjà intégré les API Wave Sénégal, Orange Money Sénégal et PI-SPI BCEAO. Mais vous devez effectuer vos propres démarches auprès de chaque opérateur pour obtenir vos accès API Marchand :

  • Wave Sénégal — Prendre contact directement avec l'équipe Wave Business, soumettre votre dossier marchand et attendre validation pour recevoir votre clé API.
  • Orange Money Sénégal — Contacter le service commercial d'Orange Money, fournir les documents requis (statut juridique, activité, etc.) et suivre le processus d'intégration Marchand.
  • PI-SPI BCEAO — Deux étapes sont nécessaires : (1) Effectuer une démarche auprès d'un participant PI-SPI (banque ou émetteur de mobile money agréé BCEAO) pour obtenir vos identifiants API. (2) Créer un compte sur le portail développeur BCEAO : developer.pispi.bceao.int.

Une fois vos accès obtenus, vous les renseignerez directement lors de la configuration de votre application dans Contraste Pay.

1

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

# --- Base de données (interface web /dbadmin) — changer au besoin ----
PGWEB_USER=admin
PGWEB_PASS=contraste_pay
💡 Les valeurs en rouge sont obligatoires à modifier. Les autres peuvent rester telles quelles.
2

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
3

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
Contact

Parlons de votre projet

Vous avez une question ou souhaitez déployer Contraste Pay ? Contactez-nous directement.

Nos coordonnées

✉️
💬
📍

Localisation

Dakar, Sénégal

Prêt à démarrer ?

Obtenez votre fichier de configuration et déployez Contraste Pay sur votre serveur aujourd'hui.

💬  Contacter sur WhatsApp