KiviPAY API: ödeme altyapısını kendi ürününüze bağlayın

Sanal POS çekimi, ödeme linki, taksit ve komisyon sorgulama, işlem durumu ve iade uçlarını REST/JSON ile kullanın. Tahsilat Kivi tarafında cari ve muhasebe kaydına da otomatik işlenir.

• REST / JSONHTTPS üzerinden JSON istek-yanıt
• Anahtar tabanlı kimlikOrtam bazlı API anahtarı
• 3D SecureKart doğrulama akışı desteklenir
• SandboxTest ortamı ve test kartları
• WebhookOlay bazlı anlık bildirim
• Kivi entegrasyonuTahsilat, cari ve muhasebe kaydı otomatik

Hangi uçlar var?

Uç adresleri, istek ve yanıt alanları Swagger dokümantasyonunda örneklerle birlikte yer alır.

• Ödeme Kartla çekim Tek çekim ve taksitli işlem başlatma, 3D Secure akışı, işlem sonucu dönüşü.
• Ödeme linki Link oluşturma Tutar, açıklama ve son kullanma tarihiyle link üretme; SMS/WhatsApp ile paylaşım.
• Sorgulama Taksit ve komisyon Karta göre taksit seçenekleri ve komisyon oranlarını işlem öncesinde hesaplama.
• Durum İşlem sorgulama Referans numarasıyla işlem durumu, dekont ve mutabakat verisi.
• İade İade ve iptal Gün içi iptal ve kısmi/tam iade; sonucun cari ve muhasebe kaydına yansıması.
• Bildirim Webhook İşlem sonucu, iade ve hakediş olaylarını kendi sisteminize anlık bildirim.

Üç adımda entegrasyon

1. 1Anahtarınızı alınSözleşme sonrası test (sandbox) ve canlı ortam için ayrı API anahtarı tanımlanır.
2. 2Sandbox’ta deneyinTest kartlarıyla çekim, link ve iade akışlarını canlıya çıkmadan doğrulayın.
3. 3Canlıya alınWebhook adresinizi tanımlayın, üretim anahtarına geçin; tipik canlıya çıkış 1–2 hafta.