aid: tabby
url: https://raw.githubusercontent.com/api-evangelist/tabby/refs/heads/main/apis.yml
apis:
- aid: tabby:tabby-checkout-api
  name: Tabby Checkout API
  tags:
  - BNPL
  - Buy Now Pay Later
  - Checkout
  - Payments
  - Sessions
  humanURL: https://docs.tabby.ai/api-reference/checkout/create-a-session
  properties:
  - url: https://docs.tabby.ai/api-reference/checkout/create-a-session
    type: Documentation
  - url: https://docs.tabby.ai/api-reference/overview
    type: Documentation
  - url: openapi/tabby-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tabby-checkout-session-schema.json
    type: JSONSchema
  - url: json-schema/tabby-order-item-schema.json
    type: JSONSchema
  - url: json-ld/tabby-context.jsonld
    type: JSONLD
  - type: NaftikoCapability
    url: capabilities/checkout-sessions.yaml
  description: Create and retrieve Tabby Checkout sessions. Posting customer, order, and buyer-history data
    to /api/v2/checkout creates a Session plus Payment and returns a pre-scoring result with a hosted web_url
    (or QR code) that the buyer follows to complete Pay-in-4 or monthly-installment authorization. Supports
    AED, SAR, and KWD across two regional production hosts (api.tabby.ai for UAE/Kuwait, api.tabby.sa for KSA).
- aid: tabby:tabby-payments-api
  name: Tabby Payments API
  tags:
  - BNPL
  - Buy Now Pay Later
  - Captures
  - Payments
  - Refunds
  humanURL: https://docs.tabby.ai/api-reference/payments/retrieve-a-payment
  properties:
  - url: https://docs.tabby.ai/api-reference/payments/retrieve-a-payment
    type: Documentation
  - url: https://docs.tabby.ai/api-reference/payments/capture-a-payment
    type: Documentation
  - url: https://docs.tabby.ai/api-reference/payments/refund-a-payment
    type: Documentation
  - url: https://docs.tabby.ai/api-reference/payments/close-a-payment
    type: Documentation
  - url: openapi/tabby-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tabby-payment-schema.json
    type: JSONSchema
  - url: json-schema/tabby-capture-schema.json
    type: JSONSchema
  - url: json-schema/tabby-refund-schema.json
    type: JSONSchema
  - type: NaftikoCapability
    url: capabilities/payments-payments.yaml
  - type: NaftikoCapability
    url: capabilities/payments-captures.yaml
  - type: NaftikoCapability
    url: capabilities/payments-refunds.yaml
  description: Lifecycle management for an authorized Tabby BNPL payment. Retrieve a payment by id, list
    payments with pagination/status filters, update the merchant reference_id, capture authorized funds (full
    or partial), refund a closed payment (full or partial with line items), and close a payment when fulfilment
    is complete. All endpoints require a secret-key Bearer token.
- aid: tabby:tabby-webhooks-api
  name: Tabby Webhooks API
  tags:
  - BNPL
  - Buy Now Pay Later
  - Events
  - Webhooks
  humanURL: https://docs.tabby.ai/api-reference/webhooks/register-a-webhook
  properties:
  - url: https://docs.tabby.ai/api-reference/webhooks/register-a-webhook
    type: Documentation
  - url: openapi/tabby-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tabby-webhook-event-schema.json
    type: JSONSchema
  - type: NaftikoCapability
    url: capabilities/webhooks-webhooks.yaml
  description: Register, list, retrieve, update, and remove Tabby webhook endpoints scoped to a merchant_code.
    Tabby fires authorize, capture, close, reject, expire, refund, and update events as JSON POSTs to your
    HTTPS endpoint with optional arbitrary auth-header signing. Failed deliveries retry with exponential
    backoff (1m timeout, up to 4 retries at 1-4 minute intervals).
- aid: tabby:tabby-disputes-api
  name: Tabby Disputes API
  tags:
  - BNPL
  - Buy Now Pay Later
  - Disputes
  - Chargebacks
  humanURL: https://docs.tabby.ai/api-reference/disputes
  properties:
  - url: https://docs.tabby.ai/api-reference/disputes
    type: Documentation
  - url: openapi/tabby-api-openapi.yml
    type: OpenAPI
  - url: json-schema/tabby-dispute-schema.json
    type: JSONSchema
  - type: NaftikoCapability
    url: capabilities/disputes-disputes.yaml
  description: Programmatic dispute handling mirroring the Tabby Merchant Dashboard. List the 100 most recent
    disputes, retrieve a single dispute, provide evidence, and bulk-approve (up to 20 at a time, refunds the
    customer) or challenge new disputes for support review. Upload PNG/JPEG/PDF evidence attachments up to
    5MB. Live payments only with secret-key Bearer auth.
name: Tabby
tags:
- BNPL
- Buy Now Pay Later
- Consumer Finance
- E-commerce
- Fintech
- Installments
- MENA
- Payments
- Saudi Arabia
- UAE
kind: contract
image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
access: 3rd-Party
common:
- url: https://tabby.ai
  name: Tabby
  type: Website
- url: https://tabby.ai/en-AE/business
  name: Tabby for Business
  type: Website
- url: https://docs.tabby.ai
  name: Tabby Developer Docs
  type: Portal
- url: https://docs.tabby.ai/api-reference/overview
  name: API Reference
  type: Documentation
- url: https://docs.tabby.ai/introduction/quick-start
  name: Quick Start
  type: GettingStarted
- url: https://docs.tabby.ai/openapi.yaml
  name: Tabby OpenAPI Specification
  type: OpenAPI
- url: https://docs.tabby.ai/pay-in-4-custom-integration/testing-credentials
  name: Testing Credentials
  type: Documentation
- url: https://docs.tabby.ai/pay-in-4-custom-integration/full-testing-checklist
  name: Testing Checklist
  type: Documentation
- url: https://docs.tabby.ai/pay-in-4-custom-integration/webhooks
  name: Webhooks Integration Guide
  type: Documentation
- url: https://docs.tabby.ai/pay-in-4-custom-integration/payment-statuses
  name: Payment Statuses
  type: Documentation
- url: https://github.com/tabby-ai
  name: Tabby GitHub Organization
  type: Github
- url: https://github.com/tabby-ai/tabby-ios-sdk
  name: Tabby iOS SDK (Swift)
  type: SDK
- url: https://github.com/tabby-ai/tabby-android-sdk
  name: Tabby Android SDK (Kotlin)
  type: SDK
- url: https://github.com/tabby-ai/tabby_flutter_inapp_sdk
  name: Tabby Flutter In-App SDK (Dart, MIT)
  type: SDK
- url: https://github.com/tabby-ai/react-native-example
  name: Tabby React Native Example
  type: SDK
- url: https://github.com/tabby-ai/m2-checkout
  name: Tabby Magento 2 Checkout Plugin
  type: Plugin
- url: https://github.com/tabby-ai/m2-payments
  name: Tabby Magento 2 Payments Metamodule
  type: Plugin
- url: https://github.com/tabby-ai/m2-feed
  name: Tabby Magento 2 Marketplace Feed
  type: Plugin
- url: https://github.com/tabby-ai/m2-sub
  name: Tabby Magento 2 Additional Merchant ID
  type: Plugin
- url: https://github.com/tabby-ai/odoo
  name: Tabby Odoo Payment Provider
  type: Plugin
- url: https://github.com/tabby-ai/hijri-converter
  name: Tabby Hijri Converter (TypeScript, MIT)
  type: SDK
- url: https://docs.tabby.ai/e-commerce-platforms/shopify/shopify-plugin-installation
  name: Tabby Shopify Plugin
  type: Plugin
- url: https://docs.tabby.ai/e-commerce-platforms/woocommerce
  name: Tabby WooCommerce Plugin
  type: Plugin
- url: https://docs.tabby.ai/e-commerce-platforms/salla
  name: Tabby Salla Plugin
  type: Plugin
- url: https://docs.tabby.ai/e-commerce-platforms/zid
  name: Tabby Zid Plugin
  type: Plugin
- url: https://docs.tabby.ai/e-commerce-platforms/opencart/opencart-plugin-installation
  name: Tabby OpenCart Plugin
  type: Plugin
- url: https://docs.tabby.ai/e-commerce-platforms/expandcart
  name: Tabby ExpandCart Plugin
  type: Plugin
- url: https://docs.tabby.ai/e-commerce-platforms/matjrah
  name: Tabby Matjrah Plugin
  type: Plugin
- url: https://docs.tabby.ai/e-commerce-platforms/salesforce
  name: Tabby Salesforce Plugin
  type: Plugin
- url: https://docs.tabby.ai/offline-payment-methods/pos-integration
  name: Tabby POS Integration
  type: Documentation
- url: https://docs.tabby.ai/offline-payment-methods/custom-payment-links
  name: Tabby Custom Payment Links
  type: Documentation
- url: https://docs.tabby.ai/mobile-app-sdks/ios-sdk
  name: Tabby Mobile SDK Docs
  type: Documentation
- url: https://docs.tabby.ai/marketing-resources/brand-assets
  name: Brand Assets
  type: Logos
- url: https://www.linkedin.com/company/tabby/
  name: Tabby on LinkedIn
  type: LinkedIn
- url: https://twitter.com/tabby
  name: Tabby on X
  type: Twitter
- url: https://www.instagram.com/tabby/
  name: Tabby on Instagram
  type: Instagram
- url: https://tabby.ai/en-AE/newsroom
  name: Tabby Newsroom
  type: Blog
- url: https://tabby.ai/en-AE/help-business/about-tabby/pricing
  name: Merchant Pricing FAQ
  type: Pricing
- url: plans/tabby-plans-pricing.yml
  name: Tabby Plans (API Commons Plans 0.1)
  type: Plans
- url: rate-limits/tabby-rate-limits.yml
  name: Tabby Rate Limits (API Commons Rate Limits 0.1)
  type: RateLimits
- url: finops/tabby-finops.yml
  name: Tabby FinOps (FOCUS 1.3)
  type: FinOps
- url: rules/tabby-rules.yml
  name: Tabby Spectral Ruleset
  type: SpectralRules
- url: vocabulary/tabby-vocabulary.yml
  name: Tabby Vocabulary
  type: Vocabulary
properties:
- url: https://docs.tabby.ai/openapi.yaml
  type: OpenAPI
- url: openapi/tabby-api-openapi.yml
  type: OpenAPI
- url: json-ld/tabby-context.jsonld
  type: JSONLD
- url: vocabulary/tabby-vocabulary.yml
  type: Vocabulary
maintainers:
- FN: Tabby
  email: partners@tabby.ai
  url: https://docs.tabby.ai
overlays:
- type: APIs.io Search
  url: overlays/apis-io-search.yml
- type: APIs.json Search
  url: overlays/apis-json-search.yml
description: 'Tabby is the MENA region''s largest buy-now-pay-later (BNPL) provider, founded in 2019 by
  Hosam Arab (ex-Namshi) and Daniil Barkalov, originally in Dubai and now headquartered in Riyadh ahead of
  a planned IPO. Tabby reached a $3.3B valuation in a February 2025 Series E ($160M co-led by Blue Pool Capital
  and Hassana Investment Company), making it the most valuable fintech in the Middle East, and reports
  15M+ users, 40,000+ merchants, and $10B+ in annualized transaction volume across KSA, UAE, and Kuwait.
  The Tabby API powers split-purchase checkouts (Pay-in-4 interest-free, monthly plans up to 12 months),
  payment lifecycle management, webhooks, and dispute resolution, complemented by Tabby Card (Visa-enabled),
  Tabby Shop discovery, Tabby Care purchase protection, and the Tabby Plus loyalty programme. Public developer
  surface includes a versioned REST API across two regional hosts (api.tabby.ai for UAE/Kuwait, api.tabby.sa
  for KSA), an OpenAPI 3.1 specification, iOS / Android / Flutter / React Native SDKs, and certified Magento
  2, Shopify, WooCommerce, Salla, Zid, OpenCart, ExpandCart, Matjrah, Salesforce, and Odoo plugins.'