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

# Statut d'une session de checkout

> Raccourci léger pour connaître l'état d'un paiement sans relire le détail complet de la session

<Tip>
  Si vous avez déjà un [webhook](/api-reference/webhooks) configuré, vous n'avez normalement pas besoin d'interroger cet endpoint en boucle — mais gardez-le en filet de sécurité pour les cas où un webhook n'arrive jamais (panne réseau, endpoint temporairement indisponible chez vous).
</Tip>


## OpenAPI

````yaml api-reference/openapi.json GET /checkout-sessions/{id}/status/
openapi: 3.1.0
info:
  title: AlphaPay 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.alphapay.me/api/v1
security:
  - bearerAuth: []
paths:
  /checkout-sessions/{id}/status/:
    get:
      tags:
        - Paiements
      summary: Statut d'une session de checkout
      description: >-
        Raccourci à côté du détail complet (GET /checkout-sessions/{id}/) : ne
        renvoie que l'essentiel pour savoir où en est le paiement, et revérifie
        toujours l'état réel côté gateway avant de répondre (jamais confiance
        dans un statut mémorisé) — même principe que GET
        /payments/{payment_id}/verify/. À utiliser en polling si vous n'avez pas
        encore de webhook configuré.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Statut actuel de la session et de la transaction associée
          content:
            application/json:
              example:
                id: c9a17e2c-4b1a-4f0e-9c3d-2a1b3c4d5e6f
                slug: kZ2v9rT4bQxL8mNpYw==
                status: PAID
                transaction_id: 9c3f2a10-4b7e-4f1a-9d2e-9b6a7c1e4a02
                transaction_status: SUCCESS
                transaction_reference: b1f2c3d4-5678-4e9a-9c1d-2e3f4a5b6c7d
        '404':
          description: Session introuvable
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).

````