vellTRDocs

Kvell API Dokümantasyonu

Ödeme, transfer ve finansal hizmetleri uygulamanıza entegre etmek için Kvell platformunda ihtiyaç duyduğunuz her şey.

Hızlı Başlangıç

İlk ödeme oturumunuzu saniyeler içinde oluşturun. Kimlik doğrulamak için API anahtarınızı ve gizli anahtarınızı kullanın, ardından oturum oluşturmak için bir POST isteği gönderin.

Temel URL'ler

Sandbox Ortamı

https://api.pay.sandbox.kvell.group

Canlı Ortam

https://api.pay.kvell.group

Kimlik Doğrulama

Tüm istekler üç başlık gerektirir:

  • X-Api-Key: Üye işyeri API anahtarınız
  • X-Signature: timestamp, metot, path ve gövde hash’i üzerinden hex HMAC-SHA256
  • X-Timestamp: ISO 8601 UTC istek zamanı (±5 dakika içinde doğrulanır)
TypeScriptÖdeme Oluştur
import { createHash, createHmac } from "node:crypto";

const body = JSON.stringify({
  transactionId: "ORDER-2026-001",
  amount: 15000,       // 150.00 TRY (integer kuruş)
  currency: "TRY",
  description: "Order #1234",
  returnUrl: "https://yoursite.com/return",
});

// Sign: "{timestamp}\nPOST\n/v1/payments/sessions\n{sha256(body)}"
const timestamp = new Date().toISOString();
const bodyHash = createHash("sha256").update(body).digest("hex");
const signature = createHmac("sha256", process.env.KVELL_SECRET_KEY)
  .update(timestamp + "\nPOST\n/v1/payments/sessions\n" + bodyHash)
  .digest("hex");

const response = await fetch(
  "https://api.pay.sandbox.kvell.group/v1/payments/sessions",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Api-Key": process.env.KVELL_API_KEY,
      "X-Signature": signature,
      "X-Timestamp": timestamp,
    },
    body,
  }
);

const session = await response.json();
// => { sessionId: "3f1c…", checkoutUrl: "https://pay.kvell.group/s/…" }

API Kategorileri

Kvell API'sini yedi ana alanda keşfedin.

8 endpoints

Ödemeler

Kart ödemeleri ve TR Karekod kabul edin. Ödeme oturumları oluşturun, tokenize kartlardan çekim yapın (3DS 2.0), ön provizyon/çekim/iptal ve iade işlemleri yürütün.

Endpoint'leri görüntüle
2 endpoints

Taksitler

Kart BIN'i ve tutara göre uygun taksit planlarını ve komisyon oranlarını sorgulayın, BIN bilgilerini çözümleyin.

Endpoint'leri görüntüle
9 endpoints

Müşteriler

Müşteri kayıtlarını ve kayıtlı kart tokenlarını yönetin; PAN'a dokunmadan kayıtlı kartlardan çekim yapın.

Endpoint'leri görüntüle
7 endpoints

İşlemler

İşlem durumunu sorgulayın, filtreleme ve keyset sayfalama ile listeleyin, defter kayıtlarını inceleyin ve kayıtları dışa aktarın.

Endpoint'leri görüntüle
10 endpoints

Faturalar

Barındırılan ödeme bağlantıları oluşturun. Oluşturun, gönderin veya etkinleştirin, iptal edin ve PDF üretin; alıcılar herkese açık bağlantıyla öder.

Endpoint'leri görüntüle
12 endpoints

Abonelikler

Kayıtlı kartlarla yinelenen tahsilat. Oluşturun, duraklatın, devam ettirin, yeniden deneyin, iptal edin ve anında tahsilat tetikleyin.

Endpoint'leri görüntüle
9 endpoints

Para Transferleri

FAST veya EFT ile TR IBAN'larına, OCT ile kartlara ödeme gönderin. Kullanılabilir bakiyeleri sorgulayın ve toplu ödeme taslakları çalıştırın.

Endpoint'leri görüntüle
3 endpoints

İtirazlar

Ters ibrazları (chargeback) yönetin. Bir ödemedeki ters ibrazları listeleyin, kabul edin veya kazanılan temsil sonrası geri çevirin.

Endpoint'leri görüntüle
6 endpoints

Webhook'lar

Uç noktalar kaydedin ve teslimatları inceleyin. Kvell, kademeli yeniden denemeler ve DLQ ile imzalı olay POST’ları gönderir.

Endpoint'leri görüntüle
2 endpoints

Pazaryeri

Ödemeleri alt üye işyerleri arasında bölüştürün ve alt üye işyerlerine ödeme yapın. Kayıt ve KYC panelde yürütülür.

Endpoint'leri görüntüle
2 endpoints

Kayıt ve KYC

Üye işyeri / alt üye işyeri KYC durumunu okuyun ve kimliği doğrulanmış özneyi inceleyin. Ödemeler onaylı durum gerektirir.

Endpoint'leri görüntüle

Yapay zekâ ile geliştirin

Bu dokümanlar makine tarafından okunabilir — copilot’unuzu getirin.

llms.txtHer sayfa markdown olarak, LLM ve ajanlar için dizinlenmiş.MCP sunucusuKvell dokümanlarını Claude Code, Cursor veya ChatGPT’ye bağlayın.
Bir asistana sorunDokümanları yapay zekâ sohbetinizde açın ve entegrasyon sorularınızı sorun.