Partner API Entegrasyonu

Partner firmalar bu API üzerinden QR kod doğrulama ve indirim uygulama işlemlerini yapar

1. QR Kod Doğrulama

POST/api/verify

Sürücü kasada QR kodunu gösterdiğinde, partner kasiyeri bu endpoint ile doğrulama yapar.

Request Body
{
  "qrData": "DCC:driver123:85:1718000000",
  "partnerId": "p_opet",
  "locationId": "loc_opet_1",
  "apiKey": "partner-api-key-buraya"
}
Yanıt (Başarılı)
{
  "valid": true,
  "driver": { "name": "Ahmet Yılmaz", "level": 5, "score": 85 },
  "discount": { "percent": 8, "tier": "gold" },
  "redemptionId": "red_abc123"
}
Yanıt (Geçersiz)
{
  "valid": false,
  "error": "QR_EXPIRED",
  "message": "QR kod süresi dolmuş."
}

2. Kullanım Onaylama

POST/api/verify/confirm

İndirim uygulandıktan sonra işlemi onaylamak için çağrılır.

Request Body
{
  "redemptionId": "red_abc123",
  "actualDiscount": 8,
  "transactionAmount": 500.00,
  "apiKey": "partner-api-key-buraya"
}

3. Hata Kodları

QR_EXPIRED — QR kod süresi dolmuş (24 saat)
QR_INVALID — QR kod formatı hatalı
DRIVER_NOT_FOUND — Sürücü bulunamadı
INVALID_API_KEY — Geçersiz API anahtarı
ALREADY_REDEEMED — Bu QR zaten kullanılmış
PARTNER_INACTIVE — Partner anlaşma süresi dolmuş

4. Entegrasyon Adımları

  1. Admin panelden partner kaydedilir ve API key oluşturulur
  2. Partner kasa yazılımına QR okuyucu + API çağrısını entegre eder
  3. Müşteriler QR kodunu gösterir, kasa POST /api/verify çağırır
  4. Doğrulama başarılı ise indirim uygulanır
  5. POST /api/verify/confirm ile onaylanır
  6. Tüm kullanım kayıtları admin panelde görülür