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

Cüzdanı platform tarafından üretilecek olan tek bir kullanıcıyı sisteme aktarır. Kullanıcı kaydı senkron oluşturulur; cüzdan, standart Kullanıcı Oluştur akışındaki gibi asenkron olarak üretilir.

İstek

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

Başlıklar

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

İstek Gövdesi

Alan	Tip	Açıklama
email	string	Opsiyonel. Standart tanımlayıcı. external_id yoksa zorunludur.
external_id	string	Opsiyonel. KVKK kapsamında kişisel veri saklanmayan modlar için opak tanımlayıcı. email yoksa zorunludur.
name	string	Opsiyonel. Yoksa kayıt edilmez.
surname	string	Opsiyonel. Yoksa kayıt edilmez.
kyc_sent	boolean	Opsiyonel, varsayılan false. true olduğunda downstream cüzdan üretim consumer'ı skip_kyc=true alır ve KYC token event'i yayınlamaz.

email veya external_id alanlarından en az biri gönderilmelidir.

Örnek — Klasik mod

curl --location '{{baseUrl}}/v2/users/users/migrate/without-wallet' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data-raw '{
    "email": "auto@example.com",
    "name": "Auto",
    "surname": "Wallet",
    "kyc_sent": false
  }'

Örnek — KVKK modu

curl --location '{{baseUrl}}/v2/users/users/migrate/without-wallet' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data-raw '{
    "external_id": "EXT-9001",
    "kyc_sent": true
  }'

Yanıt

Durum Kodu: 201 Created

{
  "id": "6913872755654191dede37da",
  "external_id": "EXT-9001",
  "name": "",
  "surname": "",
  "email": "",
  "address": null,
  "identity_number": "",
  "kyc": {
    "is_verified": true,
    "token_sent": true,
    "token_sent_at": "2026-06-01T12:34:56Z",
    "token_tx_hash": null
  }
}

Oluşturma anında address null'dır — cüzdan asenkron olarak üretilir. Cüzdan oluşturulduktan sonra address alanının dolduğunu görmek için Kullanıcıyı ID ile Getir endpoint'ini polling ile kullanın.

Hata Durumları

HTTP	Reason	Anlam
400	missing_email_and_external_id	Tanımlayıcılardan hiçbiri gönderilmedi.
400	duplicate_email	Aynı email'e sahip kullanıcı zaten var.
400	duplicate_external_id	Aynı external_id değerine sahip kullanıcı zaten var.
401	—	Geçersiz veya eksik kimlik doğrulama token'ı.
500	—	Sunucu hatası.

Toplu işlemler için Bulk endpoint veya CSV yükleme endpoint'ini kullanın.