Kart Yönetimi API Dokümantasyonu

Genel Bakış

OdemeNet Kart Yönetimi API, müşteri kartlarını güvenli şekilde saklamanızı ve yönetmenizi sağlar.

Önemli: Tüm API çağrıları JWT token ile yetkilendirilmelidir.

Güvenlik: Kart numaraları AES-256 şifreleme ile korunur.

Kart Kaydetme

Endpoint: `POST /api/Card`

`CardNo`	string (13-19)	Zorunlu
`ExpireMonth`	string (MM)	Zorunlu
`ExpireYear`	string (YYYY)	Zorunlu
`Cvv`	string (3-4)	Zorunlu
`CardAlias`	string	Opsiyonel

Request

{
  "CardNo": "4508034508034509",
  "ExpireMonth": "12",
  "ExpireYear": "2025",
  "Cvv": "123",
  "CardAlias": "İş Kartım"
}

Response

                                    {
  "Success": true,
  "Message": "Kart başarıyla kaydedildi",
  "Data": {
    "Id": "123e4567-e89b-12d3-a456-426614174000",
    "CardAlias": "İş Kartım",
    "CardType": "Credit",
    "ExpiryDate": "12/2025"
  }
}
                                

Kart Listeleme

Endpoint: `GET /api/Card/query`

`alias`	Kart takma adı
`bin`	BIN numarası
`page`	Sayfa numarası (varsayılan: 1)
`page_size`	Sayfa boyutu (varsayılan: 100)

Response

                                    {
  "status": true,
  "data": {
    "page": 1,
    "page_size": 100,
    "total_count": 5,
    "cards": [{
      "card_token": "123e4567...",
      "card_type": "CREDIT",
      "card_alias": "İş Kartım",
      "card_bin": "450803",
      "card_expire_date": "12/2025",
      "create_date": "2024-01-20T14:30:00"
    }]
  }
}
                                

Kart Güncelleme

Endpoint: `PUT /api/Card/{id}`

Parametreler kart kaydetme ile aynıdır.

Response

                                    {
  "Success": true,
  "Message": "Kart başarıyla güncellendi",
  "Data": {
    "Id": "123e4567...",
    "CardAlias": "Yeni İsim",
    "UpdatedDate": "2024-01-20T15:00:00"
  }
}
                                

Kart Silme

Endpoint: `DELETE /api/Card/{id}`

Uyarı: Ödeme işleminde kullanılmış kartlar silinemez.

Response

                                    {
  "Success": true,
  "Message": "Kart başarıyla silindi",
  "Data": {
    "Id": "123e4567...",
    "CardAlias": "İş Kartım",
    "DeletedDate": "2024-01-20T16:00:00"
  }
}
                                

Hata Kodları

Kod	Mesaj	Açıklama
`INVALID_CARD_NUMBER`	Geçersiz kart numarası	Kart numarası formatı hatalı veya geçersiz
`CARD_NOT_FOUND`	Kart bulunamadı	Belirtilen ID'ye sahip kart bulunamadı
`CARD_IN_USE`	Kart kullanımda	Kart ödeme işlemlerinde kullanılıyor, silinemez
`UNAUTHORIZED`	Yetkilendirme hatası	Geçersiz veya eksik JWT token

Kart Yönetimi API Dokümantasyonu

Kayıtlı kart saklama, listeleme ve yönetim işlemleri