> ## 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.

# Services List

> Complete list of available payment services

# Payment Services

## Operation Types

### CASHOUT (Collection)

* **Description**: Allows you to receive payments from your customers
* **Use cases**:
  * E-commerce website payments
  * Bill payments
  * Service payment collection
* **How it works**: The customer makes the payment from their mobile wallet to your DEXCHANGE account

### CASHIN (Disbursement)

* **Description**: Allows you to send money to your customers
* **Use cases**:
  * Refunds
  * Salary payments
  * Commission payouts
* **How it works**: You transfer funds from your DEXCHANGE account to the customer's mobile wallet

### AIRTIME (Phone Credit)

* **Description**: Mobile phone credit recharge service
* **Benefit**: 1% commission on each recharge
* **Availability**: All mobile operators in Senegal

## Available Services by Country

### Senegal (SN)

#### Orange Money

* Cashin: `OM_SN_CASHIN` - Transfer to Orange Money
* Cashout: `OM_SN_CASHOUT` - Receive from Orange Money

#### Wave

* Cashin: `WAVE_SN_CASHIN` - Transfer to Wave
* Cashout: `WAVE_SN_CASHOUT` - Receive from Wave

#### Free Money

* Cashin: `FM_SN_CASHIN` - Transfer to Free Money
* Cashout: `FM_SN_CASHOUT` - Receive from Free Money

#### Wizall Money

* Cashin: `WIZALL_SN_CASHIN` - Transfer to Wizall
* Cashout: `WIZALL_SN_CASHOUT` - Receive from Wizall

#### Airtime Recharge

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

#### Bills & Top-ups (BILL)

* SenEau: `SENEAU_SN_BILL` - Water bill (fixed amount)
* Senelec: `SENELEC_SN_BILL` - Postpaid electricity bill (fixed amount)
* Woyofal: `WOYOFAL_SN_BILL` - Prepaid electricity top-up (customer-chosen amount, returns a token)

> BILL services use the dedicated endpoints [Bill Inquiry](/en/api-reference/billing/inquiry) and [Pay a Bill / Top-up](/en/api-reference/billing/pay).

### Mali (ML)

* Orange Money: `OM_ML_CASHOUT` - Receive from Orange Money
* Moov Money: `MOOV_ML_CASHOUT` - Receive from Moov Money
* Wave: `WAVE_ML_CASHOUT` - Receive from Wave

### Ivory Coast (CI)

#### Orange Money

* Cashin: `OM_CI_CASHIN` - Transfer to Orange Money
* Cashout: `OM_CI_CASHOUT` - Receive from Orange Money

#### Wave

* Cashin: `WAVE_CI_CASHIN` - Transfer to Wave
* Cashout: `WAVE_CI_CASHOUT` - Receive from Wave

#### MTN Money

* Cashin: `MTN_CI_CASHIN` - Transfer to MTN Money
* Cashout: `MTN_CI_CASHOUT` - Receive from MTN Money

#### Moov Money

* Cashin: `MOOV_CI_CASHIN` - Transfer to Moov Money
* Cashout: `MOOV_CI_CASHOUT` - Receive from Moov Money

#### Other Services

* Digi Cash: `DIGICASH_CI_CASHOUT` - Receive from Digi Cash

### Cameroon (CM)

* Orange Money: `OM_CM_CASHOUT` - Receive from Orange Money
* MTN Money: `MTN_CM_CASHOUT` - Receive from MTN Money

## Request Example

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

## Response Example

```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"
    }
    // ... other services
  ]
}
```

## Notes

1. **Service Availability**

   * Services may vary depending on your account
   * Some services require specific activation
   * Contact support to activate additional services

2. **Commissions**

   * Commissions vary by service type
   * AIRTIME: Fixed 1% commission on each transaction
   * CASHOUT/CASHIN: Pricing according to your contract

3. **Transaction Limits**
   * Minimum: 200 FCFA
   * Maximum: 1,000,000 FCFA
   * Custom limits available upon request


## 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>'

````