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

# Get Checkout Status

> Get the status of a checkout session

# Get Checkout Session

This endpoint allows you to retrieve details of a checkout session by its ID.

**Endpoint:** `GET /v1/checkout/{checkoutId}/status`

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.kairosafrika.com/v1/checkout/{checkoutId}/status \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>

## Path Parameter

* **checkoutId** (string, required): The ID of the checkout session to retrieve.

## Responses

* **200 OK**: Returns checkout session details.
* **404 Not Found**: Session not found.


## OpenAPI

````yaml GET /v1/checkout/{checkoutId}/status
openapi: 3.0.3
info:
  title: Kairos Afrika Checkout API
  description: >-
    Create hosted checkout sessions for seamless payment collection. Switch
    between staging and production environments using the server dropdown.
  version: 1.0.0
  contact:
    name: Kairos Afrika Support
    email: support@kairosafrika.com
servers:
  - url: /
    description: API Base
security:
  - bearerAuth: []
paths:
  /v1/checkout/{checkoutId}/status:
    get:
      tags:
        - Checkout
      summary: Get Checkout Status
      description: Get the status of a checkout session
      operationId: getCheckoutStatus
      parameters:
        - name: checkoutId
          in: path
          required: true
          description: >-
            The unique identifier of the checkout session (e.g.,
            '040956bf1210aa19c948da8d5769cea01313dc23022025')
          schema:
            type: string
            example: 040956bf1210aa19c948da8d5769cea01313dc23022025
      responses:
        '200':
          description: Checkout status retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckoutStatusResponse'
        '404':
          description: Checkout session not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CheckoutStatusResponse:
      type: object
      properties:
        checkoutId:
          type: string
          description: Unique identifier for the checkout session
          example: 040956bf1210aa19c948da8d5769cea01313dc23022025
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
            - expired
            - cancelled
          description: Current status of the checkout session
          example: completed
        amount:
          type: number
          format: float
          description: Checkout amount
          example: 250
        currency:
          type: string
          description: Checkout currency
          example: USD
        paymentMethod:
          type: string
          description: Payment method used (if completed)
          example: mobile_money
        transactionId:
          type: string
          description: External transaction ID from payment provider (if completed)
          example: ext_txn_123
        createdAt:
          type: string
          format: date-time
          description: When the checkout session was created
          example: '2024-01-15T10:30:00Z'
        completedAt:
          type: string
          format: date-time
          description: When the checkout session was completed (if applicable)
          example: '2024-01-15T10:35:00Z'
        expiresAt:
          type: string
          format: date-time
          description: When the checkout session expires
          example: '2024-12-25T23:59:59Z'
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
          description: Error code
          example: INVALID_AMOUNT
        message:
          type: string
          description: Human-readable error message
          example: The amount must be greater than 0
        details:
          type: object
          description: Additional error details
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Enter your API key as a Bearer token

````