> ## 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.
# Quick Start
## Integration Overview
Get started with Tabby's Buy Now, Pay Later solution. This guide walks you through integrating Tabby Payments into your website or mobile app, allowing your customers to split purchases into interest-free installments.
## See It In Action
## Integration Steps
### Setup
Register for a Tabby merchant account
(KSA: merchant.tabby.sa)
and complete your application to obtain access to Tabby Merchant Dashboard
)}
/>
Retrieve your test API keys and merchant codes from Tabby Merchant Dashboard or your Tabby account manager
)}
/>
### Development
Implement checkout integration for your platform:
Web
or
Mobile
)}
/>
Integrate
Payment Processing
to handle payment status updates and order fulfillment
)}
/>
Add
Tabby Promo snippets and widgets
to your site (required for optimal conversion)
)}
/>
Test basic scenarios
with test credentials, then complete the
full testing checklist
before submitting for Tabby QA review
)}
/>
### Going Live
Submit your integration for Tabby QA review after completing the full testing checklist
)}
/>
After successful QA approval, coordinate your go-live plan and marketing campaign with your Tabby account manager
)}
/>
Request live API keys and deploy to production
)}
/>
## How It Works
Here's what happens when a customer uses Tabby:
1. **Customer chooses Tabby at checkout**\
Your site checks if the customer is eligible using Tabby's API (background check based on purchase amount and customer details).
2. **Customer completes purchase**\
If eligible, customer selects Tabby, clicks "Place order", and is redirected to Tabby's secure payment page to complete verification.
3. **You get paid, customer pays in installments**\
Tabby authorizes the payment immediately. You capture the full amount and fulfill the order. The customer pays Tabby in interest-free installments.
For detailed technical implementation, see the Checkout Flow Guide.
## Complete Integration Flow
This diagram shows the complete end-to-end integration flow including eligibility checks, session creation, payment processing, and all possible outcomes:
```mermaid theme={"dark"}
sequenceDiagram
autonumber
participant Customer
participant Merchant Site
participant Merchant Backend
participant Tabby Checkout
participant Tabby API
Customer ->>+ Merchant Site: Opens Checkout page
Merchant Site ->>+ Merchant Backend: Check customer eligibility with Tabby
Merchant Backend ->>+ Tabby API: POST /api/v2/checkout
{ amount, currency, buyer.phone, buyer.email, merchant_code }
Tabby API -->>- Merchant Backend: Response
{"status" of session}
alt "status" of session == "created"
Merchant Backend -->> Merchant Site: Customer is eligible
Merchant Site -->> Customer: Show Tabby on Checkout
Note right of Customer: Customer can select Tabby payment
Customer ->>+ Merchant Site: Selects Tabby & clicks Place Order
Merchant Site ->>+ Merchant Backend: Create Tabby payment session
Note over Merchant Backend,Tabby API: New session is created (not eligibility check)
Merchant Backend ->>+ Tabby API: POST /api/v2/checkout
{ all required attributes }
Tabby API -->>- Merchant Backend: Response
{"payment.id", "web_url"}
else "status" of session == "rejected"
Merchant Backend -->> Merchant Site: Customer is not eligible
Merchant Site -->> Customer: Hide Tabby on Checkout
end
Merchant Backend ->>+ Tabby Checkout: Redirect to Tabby Checkout
loop Tabby Checkout steps
Tabby Checkout -->> Customer: Guide through payment steps
end
alt Customer is redirected back to Merchant Site
Tabby Checkout ->> Merchant Site: Redirect via success/cancel/failure url
Merchant Site ->> Customer: Show success/cancel/failure screen and message
Note right of Customer: If payment is unsuccessful, customer can retry
or select a different payment method
Merchant Backend ->>+ Tabby API: GET /api/v2/payments/{payment.id}
Tabby API -->>- Merchant Backend: { "status" of the payment }
else Customer is not redirected
Note over Tabby API,Merchant Backend: Tabby sends payment status
via webhook or merchant checks it via API
Tabby API -->>+ Merchant Backend: POST webhook
{ "id" of the payment, "status" of the payment }
Merchant Backend ->>+ Tabby API: GET /api/v2/payments/{payment.id}
Tabby API -->>- Merchant Backend: { "status" of the payment }
end
Note over Merchant Backend: Always verify payment status via Tabby API
Do not rely on redirect URL or query params alone
alt payment.status == "AUTHORIZED" or "CLOSED"
Merchant Backend ->>+ Merchant Site: Create order in backend
Merchant Backend -->> Tabby API: POST /api/v2/payments/{payment.id}/captures
{ amount, reference_id}
else payment.status == "REJECTED" or "EXPIRED"
Merchant Backend -->> Merchant Site: Payment failed/cancelled
end
```
## Next Steps
After completing this guide, you're ready to:
**📚 Explore Advanced Features**
* Webhooks configuration for real-time payment updates
* Refunds and cancellations
* Disputes handling and customer support
**🎯 Optimize Your Integration**
* FAQ for common implementation questions
* Website / app assets for better conversion
* Marketing toolkit with assets for every channel
**🚀 Additional Resources**
* Payment statuses reference
* Complete API Reference
## Need Help?
**Integration support:**\
Contact your assigned Business Manager or Integrations Team via your integration email thread.
**Technical or API questions:**\
Email `partner@tabby.ai` / `partner@tabby.sa` or use Partner Support in Tabby Business App.
**Direct your customers to:**\
Customer Support in Tabby App or `help@tabby.ai` / `help@tabby.sa`.