Cüzdanlı Kullanıcı Aktarımı (Tekil)

Kullanıcının zaten sahip olduğu bir adresi tutan bir cüzdanla birlikte bir kullanıcı oluşturur. Adres kırpılır, küçük harfe çevrilir ve chain_id ile belirtilen zincirde, kullanıcının e-postası (ya da external_id) ile adlandırılmış kendi saklamalı bir cüzdan (custody: false) olarak kaydedilir. kyc_sent true değilse platform, KYC token'ını/token'larını zincirin her ağında bu adrese asenkron olarak gönderir. Kimlik, KYC ve tekrar kuralları için genel bakışa bakın.

Gerekli izin: user:create

İstek

POST /v2/users/migrate/with-wallet

Başlıklar

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

Gövde

Alan	Tip	Zorunlu	Açıklama
wallet_address	string	Evet	Kullanıcının mevcut adresi. Küçük harfle saklanır
chain_id	string	Evet	Adresin bulunduğu zincir (chains ID'si)
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 cüzdan zincirin her ağında KYC doğrulanmış olarak kaydedilir

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/users/migrate/with-wallet' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "john@example.com",
    "name": "John",
    "surname": "Doe",
    "wallet_address": "0xAbCdEf0123456789ABCDEF0123456789ABCDEF01",
    "chain_id": "6740e0a10000000000000101",
    "kyc_sent": false
  }'

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

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

Yanıt

Durum Kodu: 201 Created

{
  "id": "6913872755654191dede37da",
  "external_id": "EXT-1042",
  "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. Adres taşımaz; aktarılan cüzdan Kullanıcı Cüzdanlarını Listele içindedir.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama hatası (wallet_address ya da 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, duplicate_external_id, duplicate_wallet ya da invalid_chain
400	10016	chain_id geçerli bir ID değil

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.