Cüzdansız Kullanıcı Aktarımı (CSV)

CSV dosyası yükleyerek kullanıcıları sisteme aktarır; cüzdanlar her satır için asenkron olarak üretilir. Limitler ve yanıt yapısı Bulk JSON endpoint ile aynıdır: en fazla 500 satır, maksimum dosya boyutu 5 MB, satır bazlı sonuçlar.

İstek

POST /v2/users/users/migrate/without-wallet/csv

Başlıklar

Ad	Açıklama
Authorization	Gerekli. Kimlik doğrulama için Bearer token
Content-Type	Gerekli. multipart/form-data olmalı

Form Alanları

Ad	Açıklama
file	Gerekli. CSV dosyası. İlk satır başlık olarak yorumlanır.

CSV Formatı

İlk satır başlıktır. Başlık seviyesinde zorunlu sütun yoktur — satır bazında email veya external_id'den en az birinin gönderilmesi handler'da kontrol edilir.

Sütun	Tip	Zorunlu	Notlar
external_id	string	Hayır	email yoksa gereklidir. Boşluk karakterleri trim edilir.
email	string	Hayır	external_id yoksa gereklidir.
name	string	Hayır	Yoksa veya boşsa null saklanır.
surname	string	Hayır	Yoksa veya boşsa null saklanır.
kyc_sent	boolean	Hayır	Varsayılan false. Kabul edilen doğru değerler: true, 1, yes, y (büyük/küçük harf duyarsız).

Dosya başındaki UTF-8 BOM karakterine tolerans gösterilir. Sütun sırası önemli değildir.

Örnek — Klasik mod

email,name,surname,kyc_sent
auto@example.com,Auto,Wallet,false
classic@example.com,Classic,User,true

Örnek — KVKK modu

external_id,kyc_sent
EXT-9001,true
EXT-9002,false

Örnek — Karışık

external_id,email,name,surname,kyc_sent
EXT-9001,,,,true
,classic@example.com,Classic,User,false
EXT-9003,hybrid@example.com,,,true

cURL Örneği

curl --location '{{baseUrl}}/v2/users/users/migrate/without-wallet/csv' \
  --header 'Authorization: Bearer <token>' \
  --form 'file=@./users.csv'

Yanıt

Bulk JSON endpoint ile aynıdır: toplam sayaçlar ve satır bazlı results[] dizisi.

Durum Kodları

Durum Kodu	Açıklama
200	Başarılı — satır bazlı sonuçlar döner.
400	Hatalı İstek — dosya yok, dosya çok büyük, CSV satır limitini aşıyor veya boş dosya.
401	Yetkisiz — Geçersiz veya eksik kimlik doğrulama token'ı.
500	Sunucu hatası.

Sık Karşılaşılan 400 Hata Mesajları

Mesaj	Sebep
file is required	file form alanı eksik.
file too large	Dosya 5 MB sınırını aşıyor.
csv header is required	İlk satır parse edilemedi.
csv exceeds row limit	500'den fazla veri satırı.
csv has no rows	Başlık var ama veri satırı yok.