Skip to content

api-evangelist/tamara

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tamara

Tamara is the Saudi Arabia–headquartered MENA shopping and Buy-Now-Pay-Later platform offering Shariah-compliant split-payment and Pay-Now solutions across Saudi Arabia, the United Arab Emirates, Kuwait, Bahrain, and Oman. Founded in 2020 and licensed by the Saudi Central Bank (SAMA, license No. 95/A Sh/202502), Tamara became the first homegrown Saudi fintech unicorn in December 2023 after raising a US$340M Series C co-led by SNB Capital and Sanabil Investments, and operates on a Shariah-compliant funding base anchored by Goldman Sachs, Citi, and Apollo debt facilities.

This repository profiles Tamara's developer surface — eight APIs (Checkout, Orders, Payments, In-Store Checkout, Webhooks, Disputes, Pre-Checkout Eligibility, and Channel Partners), six SDKs (PHP, .NET, iOS, Android, Flutter examples, React Native example), six e-commerce plugins (Magento, WooCommerce, OpenCart, PrestaShop, Salesforce Commerce Cloud, Shopify), and the ecosystem of regional integration partners (Salla, Amazon Payment Services, Checkout.com, PayTabs, CCAvenue, Qoyod, Osarah Pro, Shahbandr, Techrar).

APIs

API Description
Tamara Checkout API Create hosted checkout sessions; return a checkout_url for the consumer to complete BNPL or Pay-Now.
Tamara Orders API Authorise, retrieve, update, and cancel orders through Tamara's online lifecycle.
Tamara Payments API Capture funds and process simplified or legacy refunds.
Tamara In-Store Checkout API Generate SMS or QR-code payment links for brick-and-mortar BNPL.
Tamara Webhooks API Register and manage HTTPS webhooks for order and dispute events.
Tamara Disputes API List, filter, and update merchant disputes.
Tamara Pre-Checkout Eligibility API Decide whether to render Tamara as a payment option before checkout.
Tamara Channel Partners API PSP/platform surface to onboard merchants onto Tamara and listen for onboarding events.

Naftiko Capabilities

Per-API Naftiko capabilities are published in capabilities/ — each capability exposes REST and MCP adapters routed through a self-contained HTTP consumes block.

  • capabilities/checkout-sessions.yaml
  • capabilities/orders.yaml
  • capabilities/payments.yaml
  • capabilities/in-store-checkout.yaml
  • capabilities/webhooks.yaml
  • capabilities/disputes.yaml
  • capabilities/eligibility.yaml
  • capabilities/channel-partners.yaml

JSON Schemas

Examples

End-to-end request/response payloads for the core merchant lifecycle live in examples/:

  • Create Checkout Session
  • Authorise Order
  • Capture Order
  • Simplified Refund
  • Pre-Checkout Eligibility
  • Register Webhook

Spectral Rules

rules/tamara-rules.yml enforces Tamara's API conventions: bearer auth, Title Case summaries, camelCase operationIds, the https://api.tamara.co (and partner-api.tamara.co) server entry, and the supported GCC currency enum (SAR, AED, BHD, KWD, OMR).

Commercial Profile

Semantics

SDKs and Plugins

Official source on GitHub at Tamara-Technology:

Useful Links