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

# Lister les services



## OpenAPI

````yaml fr/openapi.yaml GET /mobile-money/services
openapi: 3.1.0
info:
  title: API KemyPay
  version: '1.0'
  description: >
    KemyPay vous permet d'encaisser des paiements mobile money dans 12 pays
    d'Afrique avec une seule API, avec un solde par

    service, par pays et par devise.


    Chaque requête est authentifiée par une clé API secrète (`sk_live_…` ou
    `sk_test_…`) et doit venir d'une de

    vos adresses IP autorisées. Les réponses utilisent la même enveloppe : `{
    "success": true, "data": …, "meta": … }`, ou

    `{ "success": false, "error": { "code", "message", "details" }, "meta": …
    }`.


    Les encaissements, le calcul de prix et la devinette de l'opérateur sont en
    **bêta** : ils sont en cours de déploiement en production.
  contact:
    name: KemyPay Support
    email: hi@kemypay.com
servers:
  - url: https://api.kemypay.com/v1
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Catalog
    description: Pays, opérateurs, prix et catégories de service
  - name: Services
    description: Vos services (un par application ou activité), validés par notre équipe
  - name: Collections
    description: Encaisser un paiement depuis le compte mobile money d'un client (bêta)
  - name: Balances
    description: Un solde par service, par pays et par devise
paths:
  /mobile-money/services:
    get:
      tags:
        - Services
      summary: Lister vos services
      operationId: listServices
      responses:
        '200':
          description: Vos services, du plus ancien au plus récent
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Service'
                  meta:
                    $ref: '#/components/schemas/Meta'
components:
  schemas:
    Service:
      type: object
      properties:
        code:
          type: string
          format: uuid
          example: 019a8f2e-4c1b-7d3a-9e55-2b6f0c1d8a47
        name:
          type: string
          example: Afroyamo
        category:
          type: object
          properties:
            code:
              type: string
              example: dating
            name:
              type: string
              example: Dating & social apps
        description:
          type: string
          example: >-
            Dating app for the African diaspora. Premium subscriptions paid by
            mobile money.
        url:
          type: string
          example: https://afroyamo.com
        support_email:
          type: string
          example: support@afroyamo.com
        support_phone:
          type: string
          example: '+237670000000'
        status:
          type: string
          enum:
            - pending_review
            - active
            - rejected
            - suspended
            - disabled
          example: pending_review
        fee_bearer:
          type: string
          enum:
            - merchant
            - customer
          example: merchant
        webhook_url:
          type: string
          example: https://api.afroyamo.com/kemypay/webhooks
        callback_url:
          type:
            - string
            - 'null'
          example: null
        review_reason:
          type:
            - string
            - 'null'
          description: Pourquoi le service a été refusé ou suspendu.
          example: null
        created_at:
          type: string
          format: date-time
          example: '2026-10-29T10:00:00+00:00'
        reviewed_at:
          type:
            - string
            - 'null'
          format: date-time
          example: null
    Meta:
      type: object
      properties:
        request_id:
          type: string
          example: a4f8e2c1b3d97056
        timestamp:
          type: string
          format: date-time
          example: '2026-10-29T10:00:00+00:00'
        mode:
          type: string
          enum:
            - test
            - live
          example: live
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Votre clé API secrète : `sk_live_…` (argent réel) ou `sk_test_…` (mode
        test).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.