Configurez et gérez vos méthodes de paiement mobile money pour recevoir des fonds.

Méthodes de paiement

Configurez vos méthodes de paiement mobile money (Orange Money, MTN Mobile, etc.) pour encaisser des fonds sur vos différents comptes opérateurs.

Headers requis

X-Public-Key: YOUR_PUBLIC_KEY
X-Timestamp: UNIX_TIMESTAMP
X-Signature: HMAC_SHA256_SIGNATURE

Endpoints

GET /api/v1/payment-methods

POST /api/v1/payment-methods

PUT /api/v1/payment-methods/{id}

DELETE /api/v1/payment-methods/{id}

POST /api/v1/payment-methods/{id}/set-default

Où les gérer

Ouvrez la page Méthodes de paiement depuis le dashboard pour :

voir toutes vos méthodes configurées

ajouter un nouveau compte opérateur

modifier les informations d'une méthode

supprimer une méthode

définir la méthode par défaut

Cette page est le point d'entrée principal pour gérer vos comptes de réception.

Méthode par défaut

La méthode par défaut est utilisée automatiquement quand :

vous créez un payout sans spécifier payment_method_id

le système doit choisir le meilleur compte disponible

Configurez judicieusement votre méthode par défaut pour optimiser vos flux de trésorerie.

Workflow recommandé

Dashboard d'abord - Configurez vos méthodes depuis l'interface

API pour l'automatisation - Utilisez les endpoints uniquement pour l'intégration systématique

Champs typiques

Champ	Type	Description
`provider_name`	string	Code opérateur (ex: `MTN_MOMO`)
`identifier`	string	Numéro de compte ou téléphone
`metadata.bank_name`	string	Nom de la banque (pour virements)
`metadata.swift_code`	string	Code SWIFT (pour virements)
`is_active`	boolean	Statut actif/inactif de la méthode

Opérateurs supportés

Utilisez l'un des codes opérateur actuellement supportés par l'API :

Code	Opérateur
`MTN_MOMO`	MTN Momo
`ORANGE_MONEY`	Orange Money
`AIRTEL_GABON`	Airtel Gabon
`MOOV_GABON`	Moov Gabon
`AIRTEL_TCHAD`	Airtel Tchad
`MOOV_TCHAD`	Moov Tchad
`ORANGE_RCA`	Orange RCA
`AIRTEL_CONGO`	Airtel Congo
`MTN_CONGO`	MTN Congo
`MUNI_DINERO`	Muni Dinero
`MTN`	MTN
`MOOV`	Moov
`ORANGE`	Orange
`FREE`	Free
`TMONEY`	TMoney

Exemple de création

curl -X POST "{{BASE_URL}}/api/v1/payment-methods" \
  -H "X-Public-Key: YOUR_PUBLIC_KEY" \
  -H "X-Timestamp: UNIX_TIMESTAMP" \
  -H "X-Signature: HMAC_SHA256_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_name": "MTN_MOMO",
    "identifier": "+237677001122",
    "metadata": {
      "account_type": "mobile_money"
    }
  }'

Activer une méthode

Une méthode créée est active par défaut. Pour la désactiver temporairement :

curl -X PUT "{{BASE_URL}}/api/v1/payment-methods/{id}" \
  -H "X-Public-Key: YOUR_PUBLIC_KEY" \
  -H "X-Timestamp: UNIX_TIMESTAMP" \
  -H "X-Signature: HMAC_SHA256_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "is_active": false
  }'

Définir la méthode par défaut

curl -X POST "{{BASE_URL}}/api/v1/payment-methods/{id}/set-default" \
  -H "X-Public-Key: YOUR_PUBLIC_KEY" \
  -H "X-Timestamp: UNIX_TIMESTAMP" \
  -H "X-Signature: HMAC_SHA256_SIGNATURE"

Bonnes pratiques

Diversification - Configurez plusieurs opérateurs pour réduire les risques

Surveillance - Vérifiez régulièrement le statut de vos méthodes

Test - Testez chaque méthode avec de petits montants avant utilisation intensive

Sécurité - Ne partagez jamais vos identifiants de paiement

Limites et recommandations

1 méthode par opérateur par entreprise

Validation requise avant première utilisation

Frais appliqués selon les barèmes de chaque opérateur

Méthodes de paiement

On this page