API SOCCO PAY

📱

API Merchant ⭐ Premium

Disponible uniquement au Cameroun 🇨🇲

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 🇨🇲 Cameroun uniquement

Orange MTN

🌍

API Simple Standard

Disponible dans 10 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 🌍 10 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 uniquement au Cameroun.

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

API Merchant - Cameroun 🇨🇲

L'API Merchant permet aux commerçants camerounais de créer leur propre interface de paiement. Disponible uniquement au Cameroun.

🔑 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://bosssocco.com/api/v2/merchant.php

                        
                        {
                            "amount": 2500,
                            "phone": "677123456"
                        }
                    

Le numéro de téléphone doit être au format 677123456 (9 chiffres, sans le +237).

📊 Vérifier le statut d'une transaction

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

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

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

💰 Vérifier le solde du commerçant

GET https://bosssocco.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://bosssocco.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://bosssocco.com/api/v1/verify.php?reference=XXX

                            
                            {
                                "success": true,
                                "data": {
                                    "reference": "SP202501011200001234",
                                    "status": "success",
                                    "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é

[data-theme="dark"] .api-section [style*="background:var(--gray-100)"] { background: var(--gray-800) !important; }

                        
                        {
                            "event": "payment.success",
                            "reference": "SP202501011200001234",
                            "amount": 2500,
                            "currency": "XAF",
                            "customer_phone": "677123456",
                            "network": "mtn",
                            "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
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

[email protected]

💬

Telegram

@soccopay

📖

Documentation

Voir la doc complète

🔑

S'inscrire

Créer un compte