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

Bir kullanıcı oluşturur ve custody sağlayıcısından chain_id ile belirtilen zincirin varsayılan ağında bir cüzdan ister. Kullanıcı senkron olarak kaydedilir; cüzdan (custody: true) asenkron oluşturulur ve custody yanıt verdiğinde Kullanıcı Cüzdanlarını Listele içinde görünür. kyc_sent true değilse platform ardından KYC token'ını/token'larını zincirin her ağında yeni cüzdana gönderir. Kimlik, KYC ve tekrar kuralları için genel bakışa bakın.

Zincir, kullanıcı kaydedildikten sonra çözümlenir: chain_id çözümlenemezse istek 400 döner ama kullanıcı cüzdansız olarak zaten oluşmuştur. Aktarımı tekrarlamak yerine (artık tekrar olarak reddedilir) cüzdanı Kullanıcı Cüzdanı Oluştur ile ekleyin.

Gerekli izin: user:create

İstek

POST /v2/users/migrate/without-wallet

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
chain_id	string	Evet	Custody cüzdanının oluşturulacağı zincir (chains ID'si). Varsayılan ağı olmalı
email	string	Hayır	E-posta. external_id yoksa zorunlu; verildiyse geçerli bir e-posta olmalı
external_id	string	Hayır	KVKK uyumlu aktarım için opak tanımlayıcı. email yoksa zorunlu
name	string	Hayır	Ad; boşsa saklanmaz
surname	string	Hayır	Soyad; boşsa saklanmaz
kyc_sent	boolean	Hayır	Varsayılan false. true, KYC'nin zaten yapıldığı anlamına gelir: hiçbir şey gönderilmez ve yeni cüzdan zincirin varsayılan ağında KYC doğrulanmış olarak kaydedilir

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/users/migrate/without-wallet' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "auto@example.com",
    "name": "Auto",
    "surname": "Wallet",
    "chain_id": "6740e0a10000000000000101",
    "kyc_sent": false
  }'

KVKK modu (yalnızca tanımlayıcı):

curl --request POST \
  --url '{{baseUrl}}/v2/users/migrate/without-wallet' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "external_id": "EXT-9001",
    "chain_id": "6740e0a10000000000000101",
    "kyc_sent": true
  }'

Yanıt

Durum Kodu: 201 Created

{
  "id": "6913872755654191dede37da",
  "external_id": "EXT-9001",
  "name": "",
  "surname": "",
  "email": "",
  "identity_number": "",
  "status": 0,
  "created_at": "2026-08-21T09:14:02.511Z",
  "kyc": null
}

Oluşturulan kullanıcı, Kullanıcıyı ID ile Getir biçiminde. Bu anda cüzdan henüz yoktur; Kullanıcı Cüzdanlarını Listele ile sorgulayın.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama hatası (chain_id eksik, hatalı email) — details alanına bakın
400	10015	Satır atlandı; message sebebi verir: missing_email_and_external_id, duplicate_email ya da duplicate_external_id
400	10015	chain not found / chain has no default network configured. Kullanıcı zaten oluşturulmuştur
400	10016	chain_id geçerli bir ID değil. Kullanıcı zaten oluşturulmuştur

Tek bir hatalı satırın diğerlerini durdurmaması gereken aktarımlar için Toplu ya da CSV kullanın. Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.