API Referansı

Tüm Kvell API'leri için eksiksiz referans dokümantasyonu. Endpoint'leri, parametreleri, istek/yanıt örneklerini ve kimlik doğrulama desenlerini inceleyin.

ÇekirdekÖnerilenOpsiyonel

Çekirdek endpoint’ler çalışan bir entegrasyon için asgari settir. Önerilen endpoint’ler UX ve operasyonu iyileştirir. İşaretsiz endpoint’ler opsiyonel ürün eklentileridir.

Ödemeler8 endpoint

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.

POST/v1/payments/sessionsÇekirdekÖdeme Oturumu Oluştur POST/v1/payments/cardÇekirdekTokenize Karttan Çekim Yap POST/v1/payments/{id}/3ds-callback3DS Doğrulamasını Sonuçlandır POST/v1/payments/{id}/captureÖnerilenÖn Provizyonu Çek POST/v1/payments/{id}/voidÖnerilenProvizyonu İptal Et POST/v1/payments/{id}/refundÇekirdekÖdemeyi İade Et GET/v1/payments/{id}ÇekirdekÖdemeyi Getir GET/v1/payments/{id}/public-statusÖnerilenHerkese Açık Ödeme Durumu

Taksitler2 endpoint

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

GET/v1/installmentsÖnerilenBIN Taksit Sorgusu GET/v1/bins/{bin}ÖnerilenBIN Sorgusu

Müşteriler9 endpoint

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

POST/v1/customersÖnerilenMüşteri Oluştur GET/v1/customers/{id}ÖnerilenMüşteriyi Getir PUT/v1/customers/{id}Müşteriyi Güncelle GET/v1/customersÖnerilenMüşterileri Listele DELETE/v1/customers/{id}Müşteriyi Sil POST/v1/customers/{id}/cardsÖnerilenKayıtlı Kart Ekle GET/v1/customers/{id}/cardsÖnerilenKayıtlı Kartları Listele GET/v1/customers/{id}/cards/defaultVarsayılan Kartı Getir DELETE/v1/customers/{id}/cards/{cardId}ÖnerilenKayıtlı Kartı Kaldır

İşlemler7 endpoint

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

GET/v1/transactionsÖnerilenİşlemleri Listele GET/v1/transactions/{id}Önerilenİşlemi Getir GET/v1/transactions/{id}/ledgerİşlem Defteri POST/v1/transactions/exportsKayıt Dışa Aktarımı Kuyruğa Al GET/v1/transactions/exports/{exportId}Dışa Aktarım Durumu GET/v1/transactions/exports/{exportId}/downloadDışa Aktarımı İndir GET/v1/transactions/card-accessKart Erişim Denetimi

Faturalar10 endpoint

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.

POST/v1/invoicesFatura Oluştur GET/v1/invoicesFaturaları Listele GET/v1/invoices/{id}Faturayı Getir POST/v1/invoices/{id}/sendFaturayı Gönder POST/v1/invoices/{id}/activateFaturayı Etkinleştir (yalnızca bağlantı)POST/v1/invoices/{id}/cancelFaturayı İptal Et GET/v1/invoices/{id}/pdfFatura PDF'i GET/v1/public/invoices/{hash}Herkese Açık Fatura Görüntüleme POST/v1/public/invoices/{hash}/payFaturayı Öde GET/v1/public/invoices/{hash}/pdfHerkese Açık Fatura PDF'i

Abonelikler12 endpoint

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

POST/v1/subscriptionsAbonelik Oluştur GET/v1/subscriptionsAbonelikleri Listele GET/v1/subscriptions/{id}Aboneliği Getir GET/v1/subscriptions/{id}/chargesAbonelik Çekim Geçmişi POST/v1/subscriptions/{id}/cancelAboneliği İptal Et POST/v1/subscriptions/{id}/pauseAboneliği Duraklat POST/v1/subscriptions/{id}/resumeAboneliği Devam Ettir POST/v1/subscriptions/{id}/retryGecikmiş Çekimi Yeniden Dene POST/v1/subscriptions/{id}/charge-nowŞimdi Çek GET/v1/public/subscriptions/{hash}Herkese Açık Abonelik Görüntüleme POST/v1/public/subscriptions/{hash}/cancelHerkese Açık İptal POST/v1/public/subscriptions/{hash}/update-card-sessionKart Güncelleme Oturumu

Para Transferleri9 endpoint

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.

POST/v1/payoutsPara Transferi Oluştur GET/v1/payoutsPara Transferlerini Listele GET/v1/payouts/{id}Para Transferini Getir POST/v1/payouts/{id}/cancelPara Transferini İptal Et GET/v1/payouts/outstandingBekleyen Para Transferleri POST/v1/payout-draftsToplu Para Transferi Taslağı Oluştur GET/v1/payout-drafts/{id}Para Transferi Taslağını Getir POST/v1/payout-drafts/{id}/approvePara Transferi Taslağını Onayla POST/v1/payout-drafts/{id}/cancelPara Transferi Taslağını İptal Et

İtirazlar3 endpoint

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

GET/v1/payments/{id}/chargebacksTers İbrazları Listele POST/v1/payments/{id}/chargebacks/{cbid}/acceptTers İbrazı Kabul Et POST/v1/payments/{id}/chargebacks/{cbid}/reverseTers İbrazı Geri Çevir

Webhook'lar6 endpoint

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

GET/v1/stores/{storeId}/webhooksÇekirdekWebhook Uç Noktalarını Listele POST/v1/stores/{storeId}/webhooksÇekirdekWebhook Uç Noktası Oluştur PATCH/v1/stores/{storeId}/webhooks/{webhookId}ÇekirdekWebhook Uç Noktasını Güncelle DELETE/v1/stores/{storeId}/webhooks/{webhookId}ÇekirdekWebhook Uç Noktasını Sil GET/v1/merchants/{id}/webhook-deliveriesÖnerilenWebhook Teslimatlarını Listele POST/v1/deliveries/{id}/resendÖnerilenTeslimatı Yeniden Gönder

Pazaryeri2 endpoint

Ö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.

POST/v1/payments/sessionsBölüştürmeli Ödeme Oturumu POST/v1/payoutsAlt Üye İşyerine Ödeme

Kayıt ve KYC2 endpoint

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

GET/v1/kyc/statusKYC Durumu GET/v1/auth/whoamiBen Kimim

Kapsam İstatistikleri

Toplam Endpoint

Kategoriler

HMAC + RSA

Kimlik Doğrulama Yöntemi

1000/dk

İstek Limiti