PayKit REST API

PayKit API'si RESTful bir yapıya sahiptir. JSON ile istek ve yanıt alışverişi yapılır. Tüm istekler HTTPS üzerinden yapılmalıdır.

Base URL

https://www.paykit.com.tr/api

Kimlik Doğrulama

PayKit API'si Bearer Token kimlik doğrulama yöntemini kullanır. API anahtarınızı merchant portalından oluşturabilirsiniz.

HTTP Header

Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxx

Token Oluşturma — POST /api/auth/token

{
  "email": "[email protected]",
  "password": "your_password"
}

Kod	Açıklama
200	OK — İstek başarılı
201	Created — Kayıt oluşturuldu
400	Bad Request — Geçersiz istek parametresi
401	Unauthorized — Kimlik doğrulama hatası
403	Forbidden — Yetkisiz erişim
404	Not Found — Kayıt bulunamadı
409	Conflict — Çakışma (idempotency key)
422	Unprocessable Entity — Doğrulama hatası
429	Too Many Requests — Rate limit aşıldı
500	Internal Server Error — Sunucu hatası

POST /api/payments Yeni ödeme oluştur

GET /api/payments/{id} Ödeme detayı

POST /api/payments/{id}/capture Ödemeyi yakala (capture)

POST /api/payments/{id}/refund Ödeme iade

GET /api/payments/{id}/timeline Ödeme zaman çizelgesi

POST /api/payouts Yeni çekim talebi oluştur

GET /api/payouts/{id} Çekim detayı

POST /api/payouts/{id}/approve Çekimi onayla

POST /api/payouts/{id}/cancel Çekimi iptal et

GET /api/portal/balance Merchant bakiyesi

GET /api/reports/balance Bakiye raporu

GET /api/portal/statements Ekstre listesi

Webhook abonelikleri oluşturarak ödeme, çekim ve diğer olayları gerçek zamanlı olarak alabilirsiniz.

GET /api/webhook-subscriptions Abonelikleri listele

POST /api/webhook-subscriptions Yeni abonelik oluştur

DELETE /api/webhook-subscriptions/{id} Abonelik sil

GET /api/webhook-subscriptions/events Webhook olayları

GET /api/kyc/merchants KYC başvurularını listele

POST /api/kyc/merchants/{id}/approve Başvuruyu onayla

POST /api/kyc/merchants/{id}/reject Başvuruyu reddet