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

# API Reference Documentation

In this part of the documentation all the needed API calls for Tabby Integration can be found and tested:

* Checkout - it is a whole process of customer data collection and payment authorization.
* Payments - the core of Tabby is a payments flow enabling you to handle payments at your webstore.
* Webhooks - serve to ensure a seamless payment verification flow.
* Dispute webhooks - notify you when a dispute is opened on your payment or changes its status.
* Disputes - help merchants resolve issues with customers orders more efficiently.

## Base URLs

Tabby uses region-specific domains. Choose the base URL based on the merchant's operating country:

| Region | API Base URL | Checkout / Promo | Merchant Dashboard |
| - | - | - | - |
| **UAE** | `https://api.tabby.ai` | `checkout.tabby.ai` | `merchant.tabby.ai` |
| **KSA** | `https://api.tabby.sa` | `checkout.tabby.sa` | `merchant.tabby.sa` |

All API paths and payloads are identical across both domains. Tabby identifies the environment (test or live) based on the API keys used.

<Warning>
  **Use the base URL that matches the merchant's region for every call.** Many existing integrations call `api.tabby.ai` for all regions and rely on Tabby-side request routing — but not every endpoint is routed (e.g. payments retrieval and disputes), and cross-region calls can return `404`/`403`. New integrations must pin all calls — session creation, payment retrieval, captures, refunds, webhooks, dispute webhooks, disputes — to the regional base URL.
</Warning>

| Contact | UAE | KSA |
| - | - | - |
| **Partner Support** | `partner@tabby.ai` | `partner@tabby.sa` |
| **Customer Support** | `help@tabby.ai` | `help@tabby.sa` |

## OpenAPI Specification

To access and download the raw OpenAPI specification file kindly use this: [openapi.yaml](https://docs.tabby.ai/openapi.yaml).

You can also view this API specification using [ReDoc](https://redocly.github.io/redoc/?url=https://docs.tabby.ai/openapi.yaml), the same is present below:

<iframe frameBorder="0" height="800px" src="https://redocly.github.io/redoc/?url=https://docs.tabby.ai/openapi.yaml" style={{border: "1px solid #e1e5e9", borderRadius: "8px"}} title="Tabby API Swagger UI" width="100%" />

## Quick Links to Documentation

* [Direct API Integration Guide](/pay-in-4-custom-integration/quick-start)
* [Testing Credentials](/testing-guidelines/testing-credentials)
* [Postman API Collection](/testing-guidelines/postman-api-collections)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.