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

# Lister vos marchands

> 0 ou 1 résultat pour une clé API — vous-même

<Note>
  Une clé API ne voit jamais qu'elle-même dans cette liste — c'est normal, pas un bug.
</Note>


## OpenAPI

````yaml api-reference/openapi.json GET /merchants/
openapi: 3.1.0
info:
  title: SasPay API
  description: >-
    API d'encaissement et de paiement mobile money/carte pour l'Afrique de
    l'Ouest et du Centre. Toutes les routes marchand nécessitent une clé API
    secrète (header Authorization: Bearer sk_...).
  version: 1.0.0
servers:
  - url: https://api.saspay.me/api/v1
security:
  - bearerAuth: []
paths:
  /merchants/:
    get:
      tags:
        - Marchand
      summary: Lister vos marchands
      description: >-
        Toujours 0 ou 1 résultat pour une clé API : vous-même. Un compte
        dashboard possédant plusieurs marchands en verra plusieurs.
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
          description: Taille de page, 100 maximum
      responses:
        '200':
          description: Liste paginée de vos marchands
          content:
            application/json:
              example:
                count: 1
                next: null
                previous: null
                results:
                  - id: 8a2f3c10-9b4e-4a1d-8c3f-1e2d3c4b5a6f
                    owner_user: 9d1e2f3a-4b5c-4d6e-8f7a-0b1c2d3e4f5a
                    name: Kolofa Boutique
                    support_email: support@kolofa.shop
                    support_phone: '+22997000000'
                    website_url: https://kolofa.shop
                    category: E-commerce
                    is_active: true
                    kyc_status: VERIFIED
                    configs:
                      - id: c1d2e3f4-5a6b-4c7d-8e9f-0a1b2c3d4e5f
                        merchant: 8a2f3c10-9b4e-4a1d-8c3f-1e2d3c4b5a6f
                        key: ALLOW_CLIENT_OVERRIDE
                        value: 'true'
                        type: boolean
                        description: Autoriser le client à choisir qui paie les frais
                        created_at: '2026-07-01T09:00:00Z'
                        updated_at: '2026-07-01T09:00:00Z'
                    created_at: '2026-05-10T08:30:00Z'
                    updated_at: '2026-08-01T14:12:00Z'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: sk_live_... / sk_test_...
      description: >-
        Clé API secrète du marchand — header Authorization: Bearer sk_live_xxx
        (ou sk_test_xxx en environnement de test).

````