Logo GenukaGenuka Pay
Guides

Pays et opérateurs

Où vous pouvez encaisser, avec quels codes opérateur, et dans quelles limites de montant.

Pays et opérateurs

Vous choisissez un opérateur, pas un prestataire. L'acheminement technique derrière chaque opérateur est géré par Genuka Pay et peut changer sans impact sur votre intégration.

Couverture

Afrique centrale — XAF

PaysCodes opérateur
CamerounMTN_MOMO, ORANGE_MONEY, CARD
GabonAIRTEL_GABON, MOOV_GABON
TchadAIRTEL_TCHAD, MOOV_TCHAD
CongoMTN_CONGO, AIRTEL_CONGO
République centrafricaineORANGE_RCA
Guinée équatorialeMUNI_DINERO

Afrique de l'Ouest — XOF

PaysCodes opérateur
Côte d'IvoireORANGE, MTN, MOOV, WAVE, DJAMO
SénégalORANGE, FREE
Burkina FasoORANGE, MOOV
TogoTMONEY, MOOV
MaliMOOV
BéninMOOV

CARD n'est pas un opérateur mobile money : c'est le paiement par carte bancaire, disponible au Cameroun, en flux redirection et sur activation de votre compte.

Le même code ne vaut pas partout

ORANGE en Côte d'Ivoire et ORANGE_MONEY au Cameroun sont deux codes distincts. Envoyez toujours le country avec le code opérateur, ou laissez-le déduire du numéro du payeur.

Limites de montant

Par transactionPar mois
Minimum100—
KYC niveau 1 (e-mail vérifié)100 000300 000
KYC niveau 2 (identité validée)500 0001 500 000
KYC niveau 3 (entreprise validée)500 00010 000 000

Montants dans la devise du corridor (XAF ou XOF). Le plafond réellement appliqué est le plus bas entre le plafond de l'opérateur et votre plafond KYC — aujourd'hui c'est le plafond KYC qui est contraignant partout. Voir Activation du compte et KYC.

Interroger la couverture depuis votre code

Plutôt que de coder cette table en dur, lisez-la à l'exécution :

GET /api/v1/operator-providers
curl -X GET "{{BASE_URL}}/api/v1/operator-providers?filter[country]=CI" \
  -H "X-Public-Key: YOUR_PUBLIC_KEY" \
  -H "X-Timestamp: UNIX_TIMESTAMP" \
  -H "X-Signature: HMAC_SHA256_SIGNATURE"
Réponse
{
  "data": [
    {
      "id": "01HR...",
      "operator_code": "ORANGE",
      "country": "CI",
      "active": true,
      "min_payin_amount": 100,
      "max_payin_amount": 2000000,
      "min_payout_amount": 5,
      "max_payout_amount": 2000000
    }
  ]
}

L'endpoint renvoie une entrée par opérateur et par pays. Filtres disponibles : filter[country] (code ISO 2 lettres) et filter[operator_code].

Deux champs à ne pas utiliser

max_payin_amount est le plafond de l'opérateur, pas le vôtre : votre plafond KYC prime. Et le champ provider_code expose le prestataire retenu à un instant donné — il est informatif, peut changer d'un appel à l'autre, et ne doit rien piloter dans votre intégration.

À voir ensuite

How is this guide?

Last updated on