Passer du sandbox à la production
Procédure complète : KYC, validation, bascule des clés et tests de smoke.
Vue d'ensemble du process
FLUX┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ Tests │───▶│ Soumission│───▶│ Validation│───▶│ Émission │───▶│ Production│
│ sandbox │ │ KYC │ │ Neka Paie │ │ clés live│ │ live │
└──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘
~1 j ~10 min 24-48 h ~5 min Continu
1Valider votre intégration en sandbox
Avant tout, vérifiez que tous les scénarios passent en sandbox :
2Soumettre votre dossier KYC
Documents requis selon le type d'entreprise :
Société immatriculée (SARL, SA, SAS...)
- Registre du commerce (RCCM) à jour
- Statuts datés et signés
- Pièce d'identité du dirigeant (CNI ou passeport)
- Justificatif de domicile de l'entreprise (- 3 mois)
- RIB du compte bancaire de règlement
- Preuve d'activité (site web, app, contrat, facture)
Auto-entrepreneur / association
- Pièce d'identité du responsable
- Récépissé d'immatriculation ou statuts d'association
- Justificatif d'activité
- RIB
Soumettez les documents par :
- 📧 Email à
contact@nekapaie.com(sujet :KYC - {votre raison sociale}) - 📁 Upload depuis votre espace marchand (bientôt disponible)
3Validation par Neka Paie
Notre équipe procède à la vérification :
- Délai : 24 à 48 heures ouvrées
- Screening : sanctions OFAC / UE / UN automatique
- Conformité : respect des règles BCEAO/BEAC
- Vérification : activité réelle (call ou email)
Vous recevez un email de confirmation avec :
- Activation du statut
ACTIVE - Vos clés
nk_live_*(à configurer en variable d'environnement) - Vos limites (cap quotidien, seuil d'approbation Cash-Out)
- Le contrat tarifaire signé
4Bascule technique des clés
Une fois vos clés nk_live_* reçues :
BASH"># Stocker en coffre-fort (AWS Secrets Manager, Vault, GCP Secret Manager)
# JAMAIS dans Git ni dans le code
# Variables d'environnement à mettre à jour
export NEKAPAY_API_KEY="nk_live_xxxxxxxxxxxxxxxx..."
export NEKAPAY_API_SECRET="abcd1234..."
export NEKAPAY_BASE_URL="https://nekapaie.com/api/v1" # ← retirer "sandbox."
Checklist code
- URL de base mise à jour côté backend (sans
sandbox.) - URL webhook configurée en production (HTTPS valide)
- Logs sans MSISDN ni signatures complètes
- Monitoring en place (4xx, 5xx, latence p95)
- Alerting Slack/PagerDuty sur les échecs anormaux
5Smoke test en production
Avant d'ouvrir aux clients, faites un test réel à faible montant avec un MSISDN d'équipe :
JSON# Cash-In réel à 100 XOF (montant minimum) POST https://nekapaie.com/api/v1/payments/cashin { "merchant_order_id": "smoke_test_prod_001", "amount": 10000, "currency": "XOF", "customer_msisdn": "+22376", "country_code": "ML" }
- Vérifiez le PIN reçu sur votre wallet
- Validez le paiement
- Confirmez la réception du webhook côté votre serveur
- Constatez le crédit sur votre solde marchand (Soldes)
- Faites ensuite un Cash-Out pour récupérer vos fonds test
Bonnes pratiques production
- Rotation des clés tous les 90 jours (depuis votre espace marchand)
- Limite IP côté firewall : restreindre à vos serveurs backend uniquement
- Surveillance webhooks : alerter si > 1% de webhooks rejetés
- Idempotence stricte : ne traiter qu'une seule fois par
transaction_id - Réconciliation J+1 : croiser vos commandes avec l'export
/transactions/export - Plan de rollback : capacité à repasser en sandbox en cas d'incident majeur
Support production : en cas d'incident, contactez
contact@nekapaie.com avec votre merchant_id et le transaction_id concerné. Astreinte 24/7 pour les marchands en production.