# Tabby

## Docs

- [Create a session](https://docs.tabby.sa/api-reference/checkout/create-a-session.md): Creates a Checkout session. Creates Session and Payment, returns Pre-Scoring result (status), ids of Payment and Session.
- [Session creation payload model](https://docs.tabby.sa/api-reference/checkout/session-payload-model.md)
- [Approve disputes](https://docs.tabby.sa/api-reference/disputes/approve-disputes.md): Approve disputes (refund money to the customer). Only 20 disputes can be approved within a single request.
- [Challenge disputes](https://docs.tabby.sa/api-reference/disputes/challenge-disputes.md): Challenge disputes (request Tabby support to take a look at the case). Only 20 disputes can be challenged within a single request. Only disputes with status 'new' might be challenged.
- [Get dispute by id](https://docs.tabby.sa/api-reference/disputes/get-dispute-by-id.md): Returns detailed information about dispute.
- [Get disputes list](https://docs.tabby.sa/api-reference/disputes/get-disputes-list.md): Returns list of 100 recently created disputes.
- [Provide evidence for a dispute](https://docs.tabby.sa/api-reference/disputes/provide-evidence.md): Provide evidence (text and/or attachments) for a dispute. Used by the merchant to submit proof in response to an evidence request.
- [Upload attachment](https://docs.tabby.sa/api-reference/disputes/upload-attachment.md): Upload an attachment. Attachment must be in PNG, JPEG or PDF format and can be up to 5 megabytes in size. Files larger than 5 MB are rejected.
- [API Reference Documentation](https://docs.tabby.sa/api-reference/overview.md)
- [Capture a payment](https://docs.tabby.sa/api-reference/payments/capture-a-payment.md): Send a Capture requests for Authorized payments only. If you capture the full payment amount, the payment will be automatically closed with full capture. If you capture partial amount, the payment will remain Authorized until the rest of the amount is captured or Close request sent.
- [Close a payment](https://docs.tabby.sa/api-reference/payments/close-a-payment.md): Closed is the final status of the payment. Your payment is going to be closed automatically if you capture the full amount of the payment. If an order is fully cancelled, please close the payment without capturing it - the customer will be refunded for all paid amount. If only a part of the order is…
- [List of all payments](https://docs.tabby.sa/api-reference/payments/list-of-all-payments.md): Returns a list of success payments (`AUTHORIZED` or `CLOSED`) you’ve previously created. The payments are returned in sorted order, with the most recent payments appearing first. Each entry in the array is a separate payments object, including the status, any captures and any refunds. If no more pay…
- [Refund a payment](https://docs.tabby.sa/api-reference/payments/refund-a-payment.md): Send a full or partial refund amount request. You can only refund the payment that has Closed status. By default refunds reflect instantly, which means Tabby initiates a refund through payment gateway.
- [Retrieve a payment](https://docs.tabby.sa/api-reference/payments/retrieve-a-payment.md): Retrieves the specified payment. Returns the entire payment object, including the payment Status, Captures and Refunds objects.
- [Update a payment](https://docs.tabby.sa/api-reference/payments/update-a-payment.md): Updates the reference_id. You can only use this endpoint to update this 1 field. If you send other fields in the request, they will simply be ignored by tabby. The payment to be updated can have a status of AUTHORIZED or CLOSED.
- [Register a webhook](https://docs.tabby.sa/api-reference/webhooks/register-a-webhook.md): Creates a new webhook. Webhooks are registered per `merchant_code` and per environment: the environment is determined by the secret key you authorize the request with — a production key (`sk_...`) registers webhooks for production payments, a test key (`sk_test_...`) registers webhooks for test paym…
- [Remove a webhook](https://docs.tabby.sa/api-reference/webhooks/remove-a-webhook.md): Removes the specified webhook.
- [Retrieve a webhook](https://docs.tabby.sa/api-reference/webhooks/retrieve-a-webhook.md): Retrieves the specified webhook.
- [Retrieve all webhooks](https://docs.tabby.sa/api-reference/webhooks/retrieve-all-webhooks.md): Retrieves all registred webhooks.
- [Update a webhook](https://docs.tabby.sa/api-reference/webhooks/update-a-webhook.md): Updates the specified webhook.
- [ExpandCart](https://docs.tabby.sa/e-commerce-platforms/expandcart.md)
- [Magento 2 Plugin Installation](https://docs.tabby.sa/e-commerce-platforms/magento-2/magento-2-plugin-installation.md)
- [Magento 2 Product Catalogue](https://docs.tabby.sa/e-commerce-platforms/magento-2/magento-2-product-catalogue.md)
- [Matjrah](https://docs.tabby.sa/e-commerce-platforms/matjrah.md)
- [Odoo Plugin Installation](https://docs.tabby.sa/e-commerce-platforms/odoo/odoo-plugin-installation.md)
- [OpenCart Plugin Installation](https://docs.tabby.sa/e-commerce-platforms/opencart/opencart-plugin-installation.md)
- [OpenCart Product Catalogue](https://docs.tabby.sa/e-commerce-platforms/opencart/opencart-product-catalogue.md)
- [Salesforce](https://docs.tabby.sa/e-commerce-platforms/salesforce.md)
- [Salla](https://docs.tabby.sa/e-commerce-platforms/salla.md)
- [ Shopify Plugin Installation](https://docs.tabby.sa/e-commerce-platforms/shopify/shopify-plugin-installation.md)
- [Shopify Snippets](https://docs.tabby.sa/e-commerce-platforms/shopify/shopify-snippets.md)
- [WooCommerce Plugin Installation](https://docs.tabby.sa/e-commerce-platforms/woocommerce/woocommerce-plugin-installation.md)
- [WooCommerce Product Catalogue](https://docs.tabby.sa/e-commerce-platforms/woocommerce/woocommerce-product-catalogue.md)
- [Zid](https://docs.tabby.sa/e-commerce-platforms/zid.md)
- [Tabby docs for AI & LLMs](https://docs.tabby.sa/introduction/ai-tools.md): Use the Tabby documentation with ChatGPT, Claude, Cursor and other AI tools — via llms.txt, per-page Markdown, and the hosted MCP server.
- [F.A.Q.](https://docs.tabby.sa/introduction/faq.md)
- [Quick Start](https://docs.tabby.sa/introduction/quick-start.md)
- [Technical Requirements](https://docs.tabby.sa/introduction/technical-requirements.md)
- [What is Tabby?](https://docs.tabby.sa/introduction/what-is-tabby.md)
- [Marketing Guidelines](https://docs.tabby.sa/marketing/approved-messaging.md)
- [Logos](https://docs.tabby.sa/marketing/brand-assets.md)
- [Email Assets](https://docs.tabby.sa/marketing/email-assets.md)
- [In-store Assets](https://docs.tabby.sa/marketing/in-store-assets.md)
- [Social Media Assets](https://docs.tabby.sa/marketing/social-media-assets.md)
- [Marketing Toolkit](https://docs.tabby.sa/marketing/toolkit.md)
- [Website / App Assets](https://docs.tabby.sa/marketing/website-app-assets.md)
- [Custom Payment Links Integration](https://docs.tabby.sa/offline-payment-methods/custom-payment-links.md)
- [POS Integration](https://docs.tabby.sa/offline-payment-methods/pos-integration.md)
- [Checkout Flow](https://docs.tabby.sa/pay-in-4-custom-integration/checkout-flow.md)
- [Disputes](https://docs.tabby.sa/pay-in-4-custom-integration/disputes.md): Handle customer disputes programmatically with the Disputes API.
- [Full Testing Checklist](https://docs.tabby.sa/pay-in-4-custom-integration/full-testing-checklist.md)
- [App Promo Messaging](https://docs.tabby.sa/pay-in-4-custom-integration/mobile-apps/app-promo-messaging.md): Promo messaging in mobile apps: SDK snippet components, or custom snippets with the standard copy and Tabby pop-up URLs.
- [Integration without SDK (WebView)](https://docs.tabby.sa/pay-in-4-custom-integration/mobile-apps/integration-without-sdk.md): Open the Tabby checkout in your own WebView: required permissions, checkout flow, and payment processing.
- [Mobile App SDKs](https://docs.tabby.sa/pay-in-4-custom-integration/mobile-apps/sdk-all.md): Native SDKs for iOS, Android, Flutter, and React Native: checkout initialisation and promo snippets.
- [On‑Site Messaging](https://docs.tabby.sa/pay-in-4-custom-integration/on-site-messaging.md)
- [Payment Processing](https://docs.tabby.sa/pay-in-4-custom-integration/payment-processing.md): What to do after the customer completes the Tabby checkout: verify the payment, capture it, and process refunds when needed.
- [Payment Statuses](https://docs.tabby.sa/pay-in-4-custom-integration/payment-statuses.md): How a Tabby payment moves through its lifecycle, and how API statuses map to what you see on Merchant Dashboard.
- [Quick Start](https://docs.tabby.sa/pay-in-4-custom-integration/quick-start.md)
- [Webhooks](https://docs.tabby.sa/pay-in-4-custom-integration/webhooks.md): Get notified about payment status changes: registration, payload, supported events, delivery order, and retries.
- [Shopify Product Catalogue](https://docs.tabby.sa/product-catalogue/shopify-product-catalogue.md)
- [Zid Product Catalogue](https://docs.tabby.sa/product-catalogue/zid-product-catalogue.md)
- [Postman API Collection](https://docs.tabby.sa/testing-guidelines/postman-api-collections.md)
- [Testing Credentials](https://docs.tabby.sa/testing-guidelines/testing-credentials.md)

## OpenAPI Specs

- [openapi](https://docs.tabby.sa/openapi.yaml)