Quick Start

curl https://api.tabby.ai/api/v2/checkout \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "payment": {
      "amount": "340.00",
      "currency": "AED",
      "buyer": { "name": "John Doe", "email": "[email protected]", "phone": "+971500000001" },
      "shipping_address": { "city": "Dubai", "address": "Sheikh Zayed Rd", "zip": "00000" },
      "order": {
        "reference_id": "order-1001",
        "items": [{ "title": "Sneakers", "quantity": 1, "unit_price": "340.00", "category": "Shoes" }]
      },
      "buyer_history": { "registered_since": "2024-03-01T00:00:00Z", "loyalty_level": 0 },
      "order_history": []
    },
    "lang": "en",
    "merchant_code": "your_merchant_code",
    "merchant_urls": {
      "success": "https://your-store.com/tabby/success",
      "cancel": "https://your-store.com/tabby/cancel",
      "failure": "https://your-store.com/tabby/failure"
    }
  }'

const res = await fetch('https://api.tabby.ai/api/v2/checkout', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TABBY_SECRET_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload), // the JSON from the cURL tab
});
const session = await res.json();

if (session.status === 'created') {
  const webUrl = session.configuration.available_products.installments[0]?.web_url;
  if (webUrl) return redirect(webUrl); // save session.payment.id first
}
// status "rejected" (or missing web_url): show the rejection message, offer another method

import os, requests

res = requests.post(
    "https://api.tabby.ai/api/v2/checkout",
    headers={"Authorization": f"Bearer {os.environ['TABBY_SECRET_KEY']}"},
    json=payload,  # the JSON from the cURL tab
)
session = res.json()

if session["status"] == "created":
    installments = session["configuration"]["available_products"].get("installments") or []
    web_url = installments[0].get("web_url") if installments else None
    if web_url:
        return redirect(web_url)  # save session["payment"]["id"] first
# status "rejected" (or missing web_url): show the rejection message

$ch = curl_init('https://api.tabby.ai/api/v2/checkout');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('TABBY_SECRET_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload), // the JSON from the cURL tab
]);
$session = json_decode(curl_exec($ch), true);

$webUrl = $session['configuration']['available_products']['installments'][0]['web_url'] ?? null;
if ($session['status'] === 'created' && $webUrl) {
    header('Location: ' . $webUrl); // save $session['payment']['id'] first
    exit;
}
// status "rejected" (or missing web_url): show the rejection message

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("TABBY_SECRET_KEY"));

var res = await http.PostAsJsonAsync("https://api.tabby.ai/api/v2/checkout", payload); // the JSON from the cURL tab
var session = await res.Content.ReadFromJsonAsync<JsonElement>();

var status = session.GetProperty("status").GetString();
var installments = session.GetProperty("configuration")
    .GetProperty("available_products").TryGetProperty("installments", out var arr) ? arr : default;
if (status == "created" && installments.ValueKind == JsonValueKind.Array && installments.GetArrayLength() > 0)
{
    var webUrl = installments[0].GetProperty("web_url").GetString(); // save payment.id first
    return Redirect(webUrl);
}
// status "rejected" (or missing web_url): show the rejection message