API SOCCO PAY

📱

API Merchant ⭐ Premium

Disponible dans 8 pays

L'API Merchant permet aux commerçants de créer leur propre interface de paiement. Vous gérez vos clients, vos transactions et votre branding.

Disponible 🌍 8 pays

Orange MTN Moov Wave +

🌍

API Simple Standard

Disponible dans 11 pays

L'API Simple utilise l'interface de paiement SOCCO PAY. Idéal pour les commerçants qui veulent une solution clé en main sans développement front-end.

Disponible 🌍 11 pays

Orange MTN Moov Vodacom +

Pays et Opérateurs

Découvrez les pays supportés et les opérateurs Mobile Money disponibles. L'API Merchant est disponible dans 8 pays africains.

Pays	Indicatif	Devise	Opérateurs	API Merchant
🇨🇲 Cameroun ⭐	+237	XAF	Orange Mtn	✅ Oui
🇧🇯 Bénin ⭐	+229	XOF	Mtn Moov Celtiis	✅ Oui
🇧🇫 Burkina Faso ⭐	+226	XOF	Orange Moov Coris	✅ Oui
🇲🇱 Mali ⭐	+223	XOF	Orange Moov	✅ Oui
🇸🇳 Sénégal ⭐	+221	XOF	Orange Libre	✅ Oui
🇨🇮 Côte d'Ivoire ⭐	+225	XOF	Orange Mtn Wave Moov	✅ Oui
🇹🇬 Togo ⭐	+228	XOF	Moov Togocom	✅ Oui
🇨🇬 Congo Brazzaville ⭐	+242	XAF	Mtn	✅ Oui
🇨🇩 RD Congo	+243	CDF	Vodacom Airtel Orange Africell	❌ Non
🇬🇲 Gambie	+220	GMD	Afrimoney Qmoney Wave Aps	❌ Non
🇬🇳 Guinée	+224	GNF	Orange Mtn	❌ Non
🌍 Autres pays	—	USDT	Visa Mastercard Crypto	❌ Non

API Merchant - 8 pays 🇨🇲 🇧🇯 🇧🇫 🇲🇱 🇸🇳 🇨🇮 🇹🇬 🇨🇬

L'API Merchant permet aux commerçants de créer leur propre interface de paiement. Disponible dans 8 pays africains.

🔑 Authentification

L'authentification se fait via deux clés API fournies lors de l'inscription.

                        
                        X-PUBLIC-KEY: votre_public_key
                        X-PRIVATE-KEY: votre_private_key

💳 Initier un paiement

Envoyez une requête POST pour initier un paiement Mobile Money.

POST https://soccopay.com/api/v2/merchant.php

                        
                        {
                            "amount": 2500,
                            "phone": "677123456",
                            "country": "CM",
                            "method": "mtn"
                        }
                    

Le numéro de téléphone doit être au format national (sans indicatif). Le champ country est obligatoire pour les autres pays.

📊 Vérifier le statut d'une transaction

Vérifiez le statut d'une transaction via sa référence.

GET https://soccopay.com/api/v2/merchant.php?action=status&reference=SP202501011200001234

                        
                        {
                            "success": true,
                            "data": {
                                "reference": "SP202501011200001234",
                                "status": "Successful",
                                "amount": 2500,
                                "country": "CM"
                            }
                        }
                    

💰 Vérifier le solde du commerçant

GET https://soccopay.com/api/v2/merchant.php?action=balance

                        
                        {
                            "success": true,
                            "data": {
                                "balance": 150000,
                                "currency": "XAF"
                            }
                        }
                    

API Simple - Tous les pays

L'API Simple utilise l'interface de paiement SOCCO PAY. Disponible dans tous les pays supportés.

🔗 Créer un lien de paiement

Générez un lien de paiement partageable par email, SMS ou WhatsApp.

POST https://soccopay.com/api/v1/create_link.php

                            
                            {
                                "amount": 5000,
                                "title": "Achat de produit",
                                "country": "CM"
                            }
                        

📊 Vérifier une transaction

Vérifiez le statut d'une transaction via sa référence.

GET https://soccopay.com/api/v1/verify.php?reference=XXX

                            
                            {
                                "success": true,
                                "data": {
                                    "reference": "SP202501011200001234",
                                    "status": "Successful",
                                    "amount": 5000
                                }
                            }
                        

Webhook

SOCCO PAY envoie des notifications en temps réel sur l'état de vos transactions.

📤 Événements webhook

payment.pending

Transaction initiée, en attente

payment.success

✅ Paiement réussi

payment.failed

❌ Paiement échoué

                        
                        {
                            "event": "payment.success",
                            "reference": "SP202501011200001234",
                            "amount": 2500,
                            "currency": "XAF",
                            "customer_phone": "677123456",
                            "network": "mtn",
                            "country": "CM",
                            "timestamp": "2025-01-01 12:00:00"
                        }
                    

Codes d'erreur

Les erreurs courantes et leurs solutions.

Code HTTP	Message	Description
401	Clés API manquantes	Les headers X-PUBLIC-KEY et X-PRIVATE-KEY sont requis
401	Clés API invalides	Les clés fournies ne correspondent à aucun compte
403	KYC non vérifié	Le compte doit être vérifié avant d'utiliser l'API
400	Montant minimum 500 FCFA	Le montant doit être d'au moins 500 FCFA
400	Pays non supporté	Le code pays fourni n'est pas dans la liste supportée
404	Transaction introuvable	La référence fournie n'existe pas
500	Erreur système	Une erreur interne est survenue, veuillez réessayer

Support

Besoin d'aide ? Contactez notre équipe.

📧

Email

support@soccopay.com

💬

Telegram

@soccopay

📖

Documentation

Voir la doc complète

🔑

S'inscrire

Créer un compte