> ## Documentation Index
> Fetch the complete documentation index at: https://docs-api.dexchange.sn/llms.txt
> Use this file to discover all available pages before exploring further.

# Liste des Services

> Liste complète des services de paiement disponibles

# Services de Paiement

## Types d'Opérations

### CASHOUT (Encaissement)

* **Description**: Permet de recevoir des paiements de vos clients
* **Cas d'utilisation**:
  * Paiements sur votre site e-commerce
  * Règlement de factures
  * Collecte de paiements pour vos services
* **Fonctionnement**: Le client effectue le paiement depuis son wallet mobile vers votre compte DEXCHANGE

### CASHIN (Décaissement)

* **Description**: Permet d'envoyer de l'argent à vos clients
* **Cas d'utilisation**:
  * Remboursements
  * Paiement de salaires
  * Versement de commissions
* **Fonctionnement**: Vous transférez des fonds depuis votre compte DEXCHANGE vers le wallet mobile du client

### AIRTIME (Recharge Téléphonique)

* **Description**: Service de recharge de crédit téléphonique
* **Avantage**: Commission de 1% sur chaque recharge effectuée
* **Disponibilité**: Tous les opérateurs téléphoniques au Sénégal

## Services Disponibles par Pays

### Sénégal (SN)

#### Orange Money

* Cashin: `OM_SN_CASHIN` - Transfert vers Orange Money
* Cashout: `OM_SN_CASHOUT` - Réception depuis Orange Money

#### Wave

* Cashin: `WAVE_SN_CASHIN` - Transfert vers Wave
* Cashout: `WAVE_SN_CASHOUT` - Réception depuis Wave

#### Free Money

* Cashin: `FM_SN_CASHIN` - Transfert vers Free Money
* Cashout: `FM_SN_CASHOUT` - Réception depuis Free Money

#### Wizall Money

* Cashin: `WIZALL_SN_CASHIN` - Transfert vers Wizall
* Cashout: `WIZALL_SN_CASHOUT` - Réception depuis Wizall

#### Recharges (AIRTIME)

* Orange: `ORANGE_SN_AIRTIME` - Recharge Orange
* Free: `FREE_SN_AIRTIME` - Recharge Free
* Expresso: `EXPRESSO_SN_AIRTIME` - Recharge Expresso
* Promobile: `PROMOBILE_SN_AIRTIME` - Recharge Promobile

#### Factures & Recharges (BILL)

* SenEau: `SENEAU_SN_BILL` - Facture eau (montant imposé)
* Senelec: `SENELEC_SN_BILL` - Facture électricité postpayée (montant imposé)
* Woyofal: `WOYOFAL_SN_BILL` - Recharge électricité prépayée (montant libre, retourne un token)

> Les services BILL utilisent les endpoints dédiés [Consulter une facture](/api-reference/billing/inquiry) et [Payer une facture / Recharger](/api-reference/billing/pay).

### Mali (ML)

* Orange Money: `OM_ML_CASHOUT` - Réception depuis Orange Money
* Moov Money: `MOOV_ML_CASHOUT` - Réception depuis Moov Money
* Wave: `WAVE_ML_CASHOUT` - Réception depuis Wave

### Côte d'Ivoire (CI)

#### Orange Money

* Cashin: `OM_CI_CASHIN` - Transfert vers Orange Money
* Cashout: `OM_CI_CASHOUT` - Réception depuis Orange Money

#### Wave

* Cashin: `WAVE_CI_CASHIN` - Transfert vers Wave
* Cashout: `WAVE_CI_CASHOUT` - Réception depuis Wave

#### MTN Money

* Cashin: `MTN_CI_CASHIN` - Transfert vers MTN Money
* Cashout: `MTN_CI_CASHOUT` - Réception depuis MTN Money

#### Moov Money

* Cashin: `MOOV_CI_CASHIN` - Transfert vers Moov Money
* Cashout: `MOOV_CI_CASHOUT` - Réception depuis Moov Money

#### Autres Services

* Digi Cash: `DIGICASH_CI_CASHOUT` - Réception depuis Digi Cash

### Cameroun (CM)

* Orange Money: `OM_CM_CASHOUT` - Réception depuis Orange Money
* MTN Money: `MTN_CM_CASHOUT` - Réception depuis MTN Money

## Exemple de Requête

```bash theme={null}
curl -X GET https://api-m.dexchange.sn/api/v1/api-services/services \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Exemple de Réponse

```json theme={null}
{
  "services": [
    {
      "serviceName": "Orange Money Cashin SN",
      "serviceCode": "OM_SN_CASHIN",
      "serviceType": "MOBILEMONEY",
      "country": "SN"
    },
    {
      "serviceName": "Orange Money Cashout SN",
      "serviceCode": "OM_SN_CASHOUT",
      "serviceType": "MOBILEMONEY",
      "country": "SN"
    }
    // ... autres services
  ]
}
```

## Notes

1. **Disponibilité des Services**

   * Les services peuvent varier selon votre compte
   * Certains services nécessitent une activation spécifique
   * Contactez le support pour activer des services supplémentaires

2. **Commissions**

   * Les commissions varient selon le type de service
   * AIRTIME: Commission fixe de 1% sur chaque transaction
   * CASHOUT/CASHIN: Tarification selon votre contrat

3. **Limites de Transaction**
   * Minimum: 200 FCFA
   * Maximum: 1,000,000 FCFA
   * Limites personnalisées disponibles sur demande


## OpenAPI

````yaml GET /api/v1/api-services/services
openapi: 3.0.1
info:
  title: DEXCHANGE-API
  description: >-
    Unifiez tous vos paiements mobiles à travers une seule API puissante.
    DEXCHANGE-API est une passerelle de paiement qui regroupe plusieurs wallets
    (Orange Money, Wave, Free Money, Wizall) sur une seule API, simplifiant
    l'intégration des paiements mobiles en Afrique de l'Ouest.
  version: 1.0.0
  contact:
    name: DEXCHANGE Support
    email: team@dexchange.sn
    url: https://docs-api.dexchange.sn
  license:
    name: MIT
servers:
  - url: https://api-m.dexchange.sn
    description: Production Server
security:
  - bearerAuth: []
tags:
  - name: Transactions
    description: Operations for managing payment transactions
  - name: Merchant
    description: Merchant-specific payment operations
  - name: Services
    description: Service and balance information
  - name: Billing
    description: Bill payment and prepaid top-up operations
paths:
  /api/v1/api-services/services:
    get:
      tags:
        - Services
      summary: Liste des services disponibles
      description: Obtenir la liste des services de paiement disponibles
      operationId: getServices
      responses:
        '200':
          description: Liste des services récupérée avec succès
          content:
            application/json:
              schema:
                type: object
                properties:
                  services:
                    type: array
                    items:
                      type: object
                      properties:
                        serviceName:
                          type: string
                        serviceCode:
                          type: string
                        serviceType:
                          type: string
                          enum:
                            - MOBILEMONEY
                            - AIRTIME
                        country:
                          type: string
                          enum:
                            - SN
                            - CI
                            - ML
                            - CM
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Entrez votre clé API comme: Bearer <API_KEY>'

````