İ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.
Sandbox Ortamı
https://api.pay.sandbox.kvell.groupCanlı Ortam
https://api.pay.kvell.groupTüm istekler üç başlık gerektirir:
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/…" }Bu sırayı izleyin, aynı hafta canlı ödeme almaya başlayın.
Kvell API'sini yedi ana alanda keşfedin.
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üleKart 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üleMüş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İş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üleBarı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üleKayıtlı kartlarla yinelenen tahsilat. Oluşturun, duraklatın, devam ettirin, yeniden deneyin, iptal edin ve anında tahsilat tetikleyin.
Endpoint'leri görüntüleFAST 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üleTers ibrazları (chargeback) yönetin. Bir ödemedeki ters ibrazları listeleyin, kabul edin veya kazanılan temsil sonrası geri çevirin.
Endpoint'leri görüntüleUç noktalar kaydedin ve teslimatları inceleyin. Kvell, kademeli yeniden denemeler ve DLQ ile imzalı olay POST’ları gönderir.
Endpoint'leri görüntüleÖ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Ü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üleBu dokümanlar makine tarafından okunabilir — copilot’unuzu getirin.