> For the complete documentation index, see [llms.txt](https://docs.maibmerchants.md/checkout/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maibmerchants.md/checkout/getting-started/endpoints-overview.md).

# Endpoints Overview

The **maib e-Commerce Checkout API** provides a set of endpoints that allow merchants to create and manage hosted checkout sessions for online payments.\
Each endpoint represents a specific step in the checkout lifecycle — from session creation to payment execution, status retrieval, and cancellation.\
Together, they ensure a complete and standardized flow for integrating maib’s checkout service into merchant platforms.

***

### Summary of Endpoints

| Endpoint                    | Method   | Description                                                                                                        |
| --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------ |
| `/v2/checkouts`             | **POST** | Registers a new hosted checkout session and returns its unique identifier.                                         |
| `/v2/checkouts/{id}`        | **GET**  | Returns aggregated details of a specific checkout session, including order, payer, and transaction information.    |
| `/v2/checkouts/{id}/cancel` | **POST** | Cancels a checkout session that has not yet been completed.                                                        |
| `/v2/checkouts`             | **GET**  | Returns a paginated list of checkout sessions created by the merchant, with filtering options for operational use. |
| `/v2/payments/refunds/{id}` | **GET**  | This endpoint is used to retrieve the details of a previously created refund by its `id`.                          |

***

> Find detailed documentation for each endpoint in the [**API Reference**](/checkout/api-reference/endpoints.md) section, including request/response structures, examples, and error handling guidelines.