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

# Check Status

> Retrieves the current status of a payment. Rate limited to 18 requests per minute per IP address.



## OpenAPI

````yaml POST /payments/checkStatus
openapi: 3.0.0
info:
  title: MineStoreCMS REST API
  description: Documentation for MineStoreCMS Frontend REST API.
  version: 3.8.7
servers:
  - url: https://v3.minestorecms.com/api
    description: Example URL of Demo Server
security: []
tags: []
paths:
  /payments/checkStatus:
    post:
      tags:
        - payments
      summary: Check payment status
      description: >-
        Retrieves the current status of a payment. Rate limited to 18 requests
        per minute per IP address.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - order_id
              properties:
                order_id:
                  type: string
                  description: Internal ID of the payment to check
                  example: MS-123456
      responses:
        '200':
          description: Payment status retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - pending
                      - success
                      - failed
                      - not_found
                      - forbidden
                    description: Status code of the response
                  message:
                    type: string
                    description: Human-readable status message
                  order_data:
                    type: object
                    properties:
                      id:
                        type: integer
                        description: Payment ID
                      internal_id:
                        type: string
                        description: Internal payment reference
                      price:
                        type: number
                        format: float
                        description: Payment amount
                      currency:
                        type: string
                        description: Payment currency
                      status:
                        type: string
                        description: Current payment status
                      gateway:
                        type: string
                        description: Payment gateway used
                      created_at:
                        type: string
                        format: date-time
                        description: Payment creation timestamp
                example:
                  status: success
                  message: Payment is successful.
                  order_data:
                    id: 1
                    internal_id: MS-123456
                    price: 99.99
                    currency: USD
                    status: PAID
                    gateway: stripe
                    created_at: '2025-01-22 10:30:00'
        '401':
          description: Unauthorized - Missing or invalid Bearer token
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: error
                  message:
                    type: string
                    example: Unauthorized
        '403':
          description: Forbidden - User not authorized to check this payment
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: forbidden
                  message:
                    type: string
                    example: You are not allowed to check this payment.
        '404':
          description: Payment not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: not_found
                  message:
                    type: string
                    example: Payment not found.
        '429':
          description: Too many requests - Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: error
                  message:
                    type: string
                    example: Too many attempts.
      security:
        - BearerAuth: []
components: {}

````