Tabby BNPL Integration

Tabby is the leading Buy Now, Pay Later (BNPL) platform in Saudi Arabia, UAE, and Kuwait. The Linkit Tabby integration provides 7 apps covering the full BNPL lifecycle — from checkout session creation to dispute management.

Prerequisites

• A Tabby merchant account (merchant.tabby.sa for KSA)
• merchant_code and secret_key from Tabby onboarding
• Linkit organization with at least one connected platform (Salla, Zid, HungerStation, etc.)

Available Apps

Installation

1. Navigate to App Store in the Linkit dashboard
2. Search for Tabby in the Payments or POS categories
3. Install the desired apps (all are independent — install only what you need)
4. Enter your Tabby credentials in the app configuration modal:
   • Merchant Code — from Tabby merchant portal
   • Secret Key — API secret key for authentication
   • Base URL — https://api.tabby.sa (KSA) or https://api.tabby.ai (UAE/Kuwait)

Configuration

Each installed Tabby app reads credentials from the organization app's custom params:

POS Integration

Tabby POS payment links are managed via the Unified Providers Paylinks API with "provider": "tabby":

POST   /api/v1/providers/paylinks              — Create payment link
GET    /api/v1/providers/paylinks              — List payment links
GET    /api/v1/providers/paylinks/{id}          — Check status
POST   /api/v1/providers/paylinks/{id}/capture  — Capture payment
POST   /api/v1/providers/paylinks/{id}/cancel   — Cancel link

Flow

1. Cashier creates an order → calls POST /api/v1/providers/paylinks with "provider": "tabby"
2. QR code URL is returned → display to customer
3. Customer scans QR → completes Tabby checkout on their phone
4. Tabby webhook confirms authorization → auto-capture if enabled
5. Cashier confirms → order marked as paid

See the Providers Paylinks API Reference for full endpoint documentation.

Webhooks

The Tabby Webhook Bridge app registers a webhook URL with Tabby and handles incoming events:

• authorized — Customer completed checkout, ready for capture
• closed — Payment fully captured and settled
• expired — Session timed out without completion
• rejected — Customer not eligible for BNPL

Data Collections

Regional Endpoints

Testing

Tabby provides testing credentials and a Postman collection:

• Testing Credentials
• Postman Collections

Set is_test: true in your webhook registration to receive test events only.

Related